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"
}

Documentation Index

Fetch the complete documentation index at: https://finance.dev/llms.txt

Use this file to discover all available pages before exploring further.

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 (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>
default:asc

Sort order for returned records. Use asc for oldest first or desc for newest first when supported. for results.

Available options:
asc,
desc
​
limit
integer

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

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

50

​
sort
enum<string>
default:asc

Sort direction for the contract list:

  • asc — ascending (lowest strike / nearest expiry first).
  • desc — descending (highest strike / furthest expiry first). Pair with the field you sort by (default is strike price).
Available options:
asc,
desc
​
next
string

Pagination cursor from the previous response. Omit it on the first request, then send the returned cursor to fetch the next page. 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 upstream data.

​
status
string

Status string from the upstream data provider — typically OK for a successful response. Treat any other value as an error indicator alongside the HTTP status code.

​
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.