Options Contract Symbols

Retrieve all option contract symbols (OCC symbols) for a specific underlying ticker and expiration date. Returns the complete list of available call and put contracts with their strike prices.

Use Case: Fetch all AAPL option contracts expiring on 2025-01-17 to display in an options chain with strike prices and contract types.

GET /v1/options/{symbol}/contracts/{expiryDate}

Get Options Contract Symbols

cURL

curl --request GET \
  --url https://api.aries.com/v1/options/{symbol}/contracts/{expiryDate} \
  --header 'Authorization: Bearer <token>'

200

{
  "symbol": "AAPL",
  "expiryDate": "2025-01-17",
  "calls": [
    {
      "symbol": "O:AAPL250117C00150000",
      "strikePrice": 150
    }
  ],
  "puts": [
    {
      "symbol": "O:AAPL250117P00150000",
      "strikePrice": 150
    }
  ]
}

Authorizations

Authorization · string · header · required

OAuth2 Bearer token: obtain an access token from the token endpoint and send it in the Authorization header.

Path Parameters

symbol · string · required

The underlying stock symbol (e.g., AAPL, TSLA, SPY)

expiryDate · string<date> · required

The expiration date in YYYY-MM-DD format

Response

200

application/json

Successful response. Returns symbol, expiryDate, and separate calls and puts arrays; each item has symbol (OCC ticker) and strikePrice.

symbol · string

Underlying symbol

expiryDate · string<date>

Expiration date YYYY-MM-DD

calls · object[]

Show child attributes

puts · object[]

Show child attributes