Skip to main content
SupaGamma
Documentation

SupaGamma Documentation

Access historical Polymarket data — orderbook snapshots and on-chain trades — through a simple REST API. Built for quant researchers, traders, and data scientists.

Quick Start Guide
Create an account, get an API key, and make your first request
API Reference
All endpoints, authentication, rate limits, and response formats

What is SupaGamma?

SupaGamma is a historical data platform for Polymarket prediction markets. We continuously collect and archive two core datasets:

Orderbook L2 Snapshots

Level 2 (L2) depth-of-book snapshots captured every 60 seconds across all active markets we're tracking. Each row contains the full bid and ask ladder — every price level, every size — not just the top of book.

Per-row schema:

{
  timestamp,
  bids:  [[price, size], [price, size], …],   // every level
  asks:  [[price, size], [price, size], …],   // every level
  best_bid, best_ask, mid_price, spread,      // derived
  bid_depth, ask_depth                        // sum of size × price
}
  • Captured from the Polymarket CLOB API
  • 60-second intervals, 24/7
  • Tiered collection priority (fast for hot markets, slow for cold)
  • Stored as Parquet in Cloudflare R2, one file per market per day

On-Chain Trade History

Every trade execution indexed directly from the Polygon blockchain. This is verifiable, on-chain data — not API-reported fills. Continuously backfilled and updated in real time.

  • Indexed from Polygon CTF Exchange smart contracts
  • Both USDC and CTF token amounts with 6-decimal precision
  • Includes maker, taker, side, price, size, and block timestamp
  • Continuous backfill expanding historical coverage

How It Works

  1. Create an account
  2. Generate an API key from your dashboard
  3. Query the REST API — use curl, Python requests, or any HTTP client
  4. Download data as CSV, JSON, or Parquet

Pricing

Simple pay-as-you-go, priced per data type: Trades $1/MB, OHLCV $8/MB, Orderbook $2/MB. $10 minimum order. No subscriptions, no commitments — you only pay for what you download.

Quick Example

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

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

# Python example
import requests

headers = {"X-API-Key": "YOUR_API_KEY"}
resp = requests.get(
    "https://api.supagamma.com/v1/markets",
    headers=headers
)
markets = resp.json()
print(f"Found {len(markets)} markets")

Ready to get started?

Create your account and start querying historical Polymarket data.

Quick StartGet Started