API Reference

Limited beta — the Skylit API is in limited beta. Create and manage keys in the Developer tab of the Skylit app.

The Skylit Public API exposes the same real-time options-Greeks (gamma / vanna) heatmaps that power Heatseeker — per strike, with the live velocity metric and Skylit’s node classification (King, Gatekeeper, Pika, Barney, and more).

Live heatmap

Current per-strike heatmap for one or more symbols, including live velocityPct.

Historical replay

The snapshot nearest any past instant — up to 365 days back.

Live stream (SSE)

A Server-Sent Events feed of live heatmap updates, one symbol per connection.

Authentication

Bearer API keys, credit metering, and rate limits.

Use it over MCP

Every endpoint here is also an MCP tool (heat_*) — query it from Claude or Cursor in natural language, same key and credits.

Base URL

https://api.skylit.ai

Quickstart

Get an API key

Generate a key from your account console. New accounts are seeded with 5,000 credits.

Fetch a live heatmap

Pull the current per-strike gamma heatmap for SPY:

curl "https://api.skylit.ai/v1/heatmap?symbols=SPY&metric=gamma" \
  -H "Authorization: Bearer sk_live_your_key"

import requests

r = requests.get(
    "https://api.skylit.ai/v1/heatmap",
    params={"symbols": "SPY", "metric": "gamma"},
    headers={"Authorization": "Bearer sk_live_your_key"},
)
print(r.json()["data"]["symbols"][0]["strikes"][:3])

const res = await fetch(
  "https://api.skylit.ai/v1/heatmap?symbols=SPY&metric=gamma",
  { headers: { Authorization: "Bearer sk_live_your_key" } },
);
const { data } = await res.json();
console.log(data.symbols[0].strikes.slice(0, 3));

Go cross-asset

Comma-separate symbols for a single Trinity call — symbols=SPY,SPX,QQQ — and each comes back as an element of data.symbols.

How responses look

Every success returns a data / meta envelope; errors return an error object. Fields are camelCase.

{
  "data": {
    "symbols": [
      {
        "symbol": "SPY",
        "asOf": "2026-05-22T14:31:00Z",
        "spot": 591.23,
        "strikes": [
          { "strike": 590, "value": 1894300.4, "nodeType": "king", "velocityPct": 12.4 },
          { "strike": 595, "value": 642100.2, "nodeType": "gatekeeper", "velocityPct": -3.1 }
        ]
      }
    ]
  },
  "meta": { "metric": "gamma", "resolution": "1m", "mode": "live", "cached": false }
}

king · gatekeeper · pika · barney · significant · normal

Each strike carries Skylit’s node classification — the same vocabulary used throughout Patternpedia.

live only

Present on /v1/heatmap; omitted on /v1/historical (velocity is a live metric).

metered per request

/v1/heatmap costs 1, /v1/historical costs 5, /v1/stream 1 per minute open. Every response carries X-Credits-Remaining. See Authentication.

Get Started

Heatmap

Live heatmap

Historical replay

Live stream (SSE)

Authentication

Use it over MCP

Base URL

Quickstart

How responses look

Live heatmap

Historical replay

Live stream (SSE)

Authentication

Use it over MCP

​Base URL

​Quickstart

​How responses look

Base URL

Quickstart

How responses look