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 Snapshots

Full depth-of-book snapshots captured every 60 seconds across 1,000+ active markets. Each snapshot includes all bids and asks with their prices and sizes. Data archived since early 2024 and growing daily.

  • Captured from the Polymarket CLOB API
  • 60-second intervals, 24/7
  • 1,000+ markets with tiered collection priority
  • Stored in Cloudflare R2, cataloged in our database

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 — first 1 MB of data is free
  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: $0.45 per MB after the first free megabyte. 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