Skip to main content
GET
/
v1
/
options
/
snapshot
/
chain
/
{underlyingAsset}
Get option chain snapshot
curl --request GET \
  --url https://api.aries.com/v1/options/snapshot/chain/{underlyingAsset} \
  --header 'Authorization: Bearer <token>'
{
  "nextUrl": "https://api.aries.com/v1/options/snapshot/chain/AAPL?limit=1&next=YXA9TyUzQUFBUEwyNjA0MTBDMDAxMTAwMDAlM0ExMTAuMDAmYXM9JmV4cGlyYXRpb25fZGF0ZS5ndGU9MjAyNi0wNC0xMCZsaW1pdD0xJm9yZGVyPWFzYyZzb3J0PXRpY2tlcg&order=asc&sort=ticker",
  "requestId": "cef93e70deeab28211f93cf18894ea94",
  "results": [
    {
      "breakEvenPrice": 260.625,
      "day": {
        "change": 0,
        "changePercent": 0,
        "close": 147.62,
        "high": 148.41,
        "lastUpdated": 1775678400000000000,
        "low": 147.62,
        "open": 148.41,
        "previousClose": 147.62,
        "volume": 4,
        "vwap": 147.9625
      },
      "details": {
        "contractType": "call",
        "exerciseStyle": "american",
        "expirationDate": "2026-04-10",
        "sharesPerContract": 100,
        "strikePrice": 110,
        "ticker": "O:AAPL260410C00110000"
      },
      "fmv": 150.626,
      "fmvLastUpdated": 1775764519938981000,
      "greeks": {
        "delta": 0.9866009460931855,
        "gamma": 0.0003035183978405151,
        "theta": -2.5694750192894538,
        "vega": 0.0038452348585003293
      },
      "impliedVolatility": 9.52609127380109,
      "lastQuote": {
        "ask": 152.4,
        "askExchange": 300,
        "askSize": 135,
        "bid": 148.85,
        "bidExchange": 300,
        "bidSize": 136,
        "lastUpdated": 1775764799797068500,
        "midpoint": 150.625,
        "timeframe": "REAL-TIME"
      },
      "lastTrade": {
        "conditions": [
          240
        ],
        "exchange": 308,
        "price": 147.62,
        "sipTimestamp": 1775665726017723100,
        "size": 1,
        "timeframe": "REAL-TIME"
      },
      "openInterest": 1,
      "underlyingAsset": {
        "changeToBreakEven": 0.639,
        "lastUpdated": 1775779195495831800,
        "price": 259.986,
        "ticker": "AAPL",
        "timeframe": "DELAYED"
      }
    }
  ],
  "status": "OK"
}

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

underlyingAsset
string
required

Underlying equity symbol (for example AAPL).

Example:

"AAPL"

Query Parameters

strikePrice
string

Filter by exact strike price (numeric string).

Example:

"190"

expirationDate
string

Filter by expiration date (provider format, typically YYYY-MM-DD).

Example:

"2024-01-19"

contractType
string

Filter by contract type (for example call or put).

Example:

"call"

strikePriceGte
string

Strike price greater than or equal to this value.

strikePriceGt
string

Strike price strictly greater than this value.

strikePriceLte
string

Strike price less than or equal to this value.

strikePriceLt
string

Strike price strictly less than this value.

expirationDateGte
string

Expiration date greater than or equal to this value.

expirationDateGt
string

Expiration date strictly greater than this value.

expirationDateLte
string

Expiration date less than or equal to this value.

expirationDateLt
string

Expiration date strictly less than this value.

order
enum<string>

Sort order for results.

Available options:
asc,
desc
limit
integer

Maximum number of contracts per page (1–250).

Required range: 1 <= x <= 250
Example:

50

sort
string

Sort field or key accepted by the provider.

next
string

Pagination cursor for the next page. Prefer following the absolute nextUrl from a previous response; you may also pass the next query parameter when continuing the same request pattern.

Response

Option chain snapshot returned successfully.

Paginated option chain snapshot for an underlying (OptionChainSnapshotResponse).

requestId
string

Request identifier from the data provider.

status
string

Provider status (for example OK).

results
object[]

Option contract rows for the underlying, subject to filters and pagination.

nextUrl
string

URL for the next page of results (masked to this API); omitted when there is no next page.