Quick Start Guide

Get up and running with SupaGamma in under 5 minutes. Create an account, get an API key, and start pulling historical Polymarket data.

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. Pay per data type — Trades $1/MB, OHLCV $8/MB, Orderbook $2/MB.

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.

Pay-as-you-go pricing — no subscriptions or commitments. See the pricing page for per-data-type rates.

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_live_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:

# 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"

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
Browse Markets — explore available markets in your dashboard
Pricing — Trades $1/MB, OHLCV $8/MB, Orderbook $2/MB ($10 minimum)

Questions?

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

API Reference Create Account