Skip to main content
GET
/
v1
/
underlying
/
{ticker}
/
expirations
List traded expirations for a ticker
curl --request GET \
  --url https://flow-api.skylit.ai/v1/underlying/{ticker}/expirations \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "expiration": "2023-12-25",
      "dte": 123,
      "callVolume": 1,
      "putVolume": 1,
      "callPremium": 123,
      "putPremium": 123,
      "contractCount": 1
    }
  ],
  "meta": {
    "timestamp": "2023-11-07T05:31:56Z",
    "requestId": "d7574836"
  }
}

Authorizations

​
Authorization
string
header
required

Skylit API key in the Authorization header (Authorization: Bearer fs_live_<key>). X-API-Key is also accepted.

Path Parameters

​
ticker
string
required

Underlying ticker symbol (uppercase, e.g. SPY, AAPL).

Example:

"SPY"

Query Parameters

​
date
string<date>

Trading date the request targets, in YYYY-MM-DD. Defaults to the current trading date (the most recent session that has settled enough data to be queryable). Past dates fall through to the daily rollup tables.

Example:

"2026-05-27"

Response

Expirations with per-expiry totals.

​
data
object[]
required
​
meta
object
required