Skip to main content
GET
/
v1
/
historical
Replay per-strike heatmap at a past instant (one or more symbols)
curl --request GET \
  --url https://api.skylit.ai/v1/historical \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "symbols": [
      {
        "symbol": "SPY",
        "asOf": "2026-03-05T10:01:00Z",
        "spot": 512.4,
        "previousClose": 510.02,
        "priceChange": 2.38,
        "priceChangePercent": 0.47,
        "expirations": [
          "2026-03-05",
          "2026-03-06"
        ],
        "strikes": [
          {
            "strike": 512,
            "value": 1500200,
            "nodeType": "king"
          },
          {
            "strike": 515,
            "value": 410000,
            "nodeType": "gatekeeper"
          }
        ]
      }
    ]
  },
  "meta": {
    "metric": "gamma",
    "resolution": "1m",
    "mode": "historical",
    "cached": false
  }
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
symbols
string
required

One ticker, or a comma-separated list for a single cross-asset call (e.g. SPY or SPY,SPX,QQQ). Each is returned as an element of data.symbols.

Example:

"SPY,SPX,QQQ"

​
at
string<date-time>
required

RFC3339 instant to replay (e.g. 2026-03-05T10:01:00Z). Up to 365 days back.

​
metric
enum<string>
default:gamma

Which Greek exposure to return per strike.

Available options:
gamma,
vanna
​
maxStrikes
integer
default:92

Maximum number of strikes around spot to return.

Required range: 1 <= x <= 400

Response

Historical heatmap snapshot(s).

​
data
object
required
​
meta
object
required