API Reference

The Skylit Public API gives you the data behind four Skylit modules. One API key and one credit balance work across all of them.

Heatseeker

Flowseeker

Atlas

Tempest

For every API

Base URLs

https://api.skylit.ai        # Heatseeker, Flowseeker and Tempest
https://atlas-api.skylit.ai  # Atlas

One base URL, https://api.skylit.ai, serves both Heatseeker and Flowseeker, so an agent needs one host and one key for both. https://flow-api.skylit.ai is a permanent alias for Flowseeker: same API, keys, limits and credits. Existing integrations can keep using it.

The OpenAPI specs are served live by each API. Send your key with the request (the Heatseeker spec needs none). Copies that need no key are at https://www.skylit.ai/docs/openapi.yaml, https://www.skylit.ai/docs/flowseeker-openapi.yaml and https://www.skylit.ai/docs/atlas-openapi.yaml.

Building an agent? Read Rate limits and retries and Errors before your first run.

Quickstart

1. Get an API key

   Generate a key on the Developer page. New accounts start with the credits their plan includes (Plans and credits). New here? Follow Getting started for agentic traders.

2. Fetch a live heatmap

   Pull the current per-strike gamma heatmap for SPY:

   cURLPythonNode

   Copy

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

3. Go cross-asset

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

4. Try Flowseeker and Atlas

   The same key works on the other APIs:

   TerminalCopy

   # Latest scored options flow for SPY (1 credit)
   curl "https://api.skylit.ai/v1/flow/SPY" \
     -H "Authorization: Bearer YOUR_API_KEY"
   
   # SPY 1-minute price bars from Atlas (1 credit); from/to are Unix seconds
   curl "https://atlas-api.skylit.ai/v1/history?symbol=SPY&resolution=1&from=1790602200&to=1790625600" \
     -H "Authorization: Bearer YOUR_API_KEY"

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