Skip to main content
SupaGamma
Getting Started
3 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 historical Polymarket data.

Step 01

Create an Account

Sign up with your email. We use Magic.link for passwordless login — no password needed.

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. First 1 MB is free.

Step 1: Create an Account

Visit supagamma.com/signup and enter your email address. We'll send you a magic link — click it to log in. No password required.

Your first 1 MB of data downloads is free. No credit card needed to get started.

Step 2: Generate an API Key

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

  1. Click "Create API Key"
  2. Give your key a descriptive name (e.g., "Research Notebook" or "Backtest Script")
  3. 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 — $0.45/MB after the first free megabyte

Questions?

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

API ReferenceCreate Account