Getting Started3 min read

Quick Start Guide

Get up and running with SupaGamma in under 5 minutes. Create an account, get an API key, and start pulling our flagship raw, event-granular L2 order-book delta tape — every book change as it happened, point-in-time only — plus trades, reconstructed snapshots, and OHLCV.

Step 01

Create an Account

Step 02

Generate API Key

Go to the API Keys section in your dashboard and create a new key.

Step 03

Make Your First Request

Use curl, Python requests, or any HTTP client to query the REST API.

Step 04

Download Data

Query markets, trades, and orderbook data — everything your subscription covers, as often as you need. For large historical pulls, use the async exports flow.

Step 1: Create an Account

Visit supagamma.com/signup and enter your email address. We'll email you a 6-digit code — type it in to log in. No password required.

Subscribe for $399/mo — or $3,990/year, two months free — for unlimited in-plan access, or start on the free tier. See the pricing page for what each plan covers.

Step 2: Generate an API Key

Once logged in, navigate to the API Keys section in your dashboard:

Click "Create API Key"
Give your key a descriptive name (e.g., "Research Notebook" or "Backtest Script")
Copy and store your API key securely — you won't see it again

Security Note

Never commit your API key to version control or expose it in client-side code. Use environment variables to store it securely.

Step 3: Make Your First Request

All API requests require your API key in the X-API-Key header:

# Set your API key
$ export API_KEY="sg_your_key_here"

# List all markets
$ curl -H "X-API-Key: $API_KEY" \
    https://api.supagamma.com/v1/markets

Step 4: Query Data

Here are the main endpoints you'll use. MARKET_ID is the numeric id of a market from the markets list, for example 1254468; a hex condition id is not accepted.

# Get market details
$ curl -H "X-API-Key: $API_KEY" \
    https://api.supagamma.com/v1/markets/MARKET_ID

# Get trades for a market
$ curl -H "X-API-Key: $API_KEY" \
    "https://api.supagamma.com/v1/trades?market_id=MARKET_ID&limit=50"

# Get OHLCV candles
$ curl -H "X-API-Key: $API_KEY" \
    "https://api.supagamma.com/v1/trades/ohlcv?market_id=MARKET_ID"

# Download trades as file
$ curl -H "X-API-Key: $API_KEY" \
    "https://api.supagamma.com/v1/download/trades?market_id=MARKET_ID"

Pulling a large or wide window? Use the async /v1/exports flow instead of a direct download — it builds the file in the background and gives you a re-usable link, so a big historical pull never hits a request timeout. Submit the job, poll it, then download when it's ready. A few minutes for a large window is normal, not a hang.

Python Example

Using Python with the requests library:

import os
import requests

API_KEY = os.environ["SUPAGAMMA_API_KEY"]
BASE_URL = "https://api.supagamma.com/v1"
headers = {"X-API-Key": API_KEY}

# List markets
markets = requests.get(f"{BASE_URL}/markets", headers=headers).json()
print(f"Found {len(markets)} markets")

# Get trades for the first market
market_id = markets[0]["id"]
trades = requests.get(
    f"{BASE_URL}/trades",
    headers=headers,
    params={"market_id": market_id, "limit": 100}
).json()

print(f"Got {len(trades)} trades")

What's Next?

API Reference — full list of endpoints, parameters, and response formats
MCP Connector — connect Claude to SupaGamma and research data right in chat
Browse Markets — explore available markets in your dashboard
Pricing — subscription plans: Free (delayed sample) and Professional at $399/mo for undelayed access to every dataset we sell, with 12 months of history (24 on annual)

Questions?

Reach out on X or LinkedIn — we're happy to help.

API Reference Create Account