SupaGamma for Developers

What is SupaGamma?

SupaGamma is a historical and raw-data marketplace for prediction markets and event-contract venues. Our edge is the raw, event-granular L2 order-book delta tape — the full order-book delta stream as it happened, captured live from the venue feed since June 2026 and not reconstructable after the fact. Alongside it we serve trades, reconstructed L2 snapshots, OHLCV, greeks, and wallet analytics across Polymarket (global + US/QCX), Hyperliquid, and Limitless — plus a retained crypto options + futures archive (Deribit since 2016, Lyra). Every fill, every book change, every greek, billed by the compressed megabyte. Access it all through a single REST API.

Available Data

• Trades— Every fill indexed at the venue's API or the underlying chain. Price, size, side, instrument, maker/taker. Polymarket goes back to 2024-02-01.
• Orderbook L2 — Led by the raw, event-granular L2 delta tape: every order-book change as it happened, captured live from the venue feed and not reconstructable after the fact — running for Polymarket, Hyperliquid, Polymarket US, and Limitless since June 2026 and growing daily. Reconstructed bid/ask ladder snapshots come alongside it as a secondary product: Polymarket on a tiered cadence, as often as every ~5s near expiry; other venues every ~5 minutes, top instruments by liquidity.
• Lifecycle & settlement — Outcome lifecycle and settlement events per market — creation, resolution, and final settlement (Polymarket, Hyperliquid) — plus best-bid/offer where the venue publishes it.
• Snapshots — L1 ticker + venue greeks (Lyra), per-market stats (Polymarket Gamma), price-history bins, cross-platform event matches, wallet analytics.
• OHLCV Candles — Pre-aggregated candles in 1m, 1h, 1d timeframes. Polymarket candles cover all markets since 2024-02-01 (9.1M+ 1h bars, 1.6M+ 1d bars).
• Greeks— Black-76 delta, gamma, vega, theta, rho computed per options trade using the venue's reported IV at trade time.
• Series catalogue — One GET /v1/series call returns every buyable series with coverage, cost rate, and row estimates.

Getting Started

1. Sign up at supagamma.com/signup
2. Create an API key in your dashboard
3. Make requests with your key in the X-API-Key header

Pricing

Subscription, not per file. Professional $399/mo covers everything — trades, OHLCV, reconstructed snapshots and market stats, plus the raw, event-granular L2 order-book delta tape and a commercial licence. Paying annually costs two months less and deepens your history window from 12 months to 24. The plan is unlimited up to a 50 GB monthly fair-use cap, and a free tier gives delayed daily candles and top-of-book. Size any download before you pull it with POST /v1/series/{id}/estimate.

API Overview

Base URL: https://api.supagamma.com/v1

Example: Python SDK

The official client wraps every endpoint above, sync or async. supagamma on PyPI · source on GitHub

pip install supagamma

from supagamma import SupaGamma

client = SupaGamma(api_key="sg_your_key_here")   # or set SUPAGAMMA_API_KEY

# Walk the catalogue — paging is handled for you
for market in client.markets.auto_paginate(limit=500):
    print(market["id"], market["question"])

# Check the balance behind the key
print(client.billing.balance())

Example: Python (raw HTTP)

import requests

API_KEY = "sg_your_key_here"
BASE = "https://api.supagamma.com/v1"
H = {"X-API-Key": API_KEY}

# 1. Browse the catalogue
series = requests.get(f"{BASE}/series", headers=H).json()
print([s["series_id"] for s in series if not s["coming_soon"]])

# 2. Price a Deribit BTC options range before paying
est = requests.post(
    f"{BASE}/series/deribit:btc-options/estimate",
    headers=H,
    json={"data_type": "trades", "start": "2026-01-01", "end": "2026-02-01"},
).json()
print(f"$${est['estimated_cost_usd']:.2f} for {est['estimated_rows']:,} trades")

# 3. Download a Polymarket OHLCV day as Parquet
resp = requests.get(
    f"{BASE}/download/series",
    headers=H,
    params={
        "series_id": "polymarket:ohlcv-1h",
        "start": "2026-03-15",
        "end": "2026-03-16",
        "format": "parquet",
    },
)
with open("polymarket_ohlcv_1h.parquet", "wb") as f:
    f.write(resp.content)

Example: curl

# List series
curl -H "X-API-Key: sg_your_key_here" "https://api.supagamma.com/v1/series"

# Estimate the cost of a Polymarket OHLCV date range
curl -H "X-API-Key: sg_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"data_type":"ohlcv","start":"2026-04-01","end":"2026-05-01"}' \
  "https://api.supagamma.com/v1/series/polymarket:ohlcv-1h/estimate"

# Download a Deribit BTC options day
curl -H "X-API-Key: sg_your_key_here" \
  -o deribit_btc_options.parquet \
  "https://api.supagamma.com/v1/download/options?series_id=deribit:btc-options&start=2026-04-01&end=2026-04-02&format=parquet"

Resources

• Full Documentation
• Quick Start Guide
• API Reference
• OpenAPI Specification
• MCP Connector — connect Claude to research the data in chat