Quickstart

Sign up, mint an API key, and pull your first resolved market. Five minutes, two commands.

1. Get an API key

Create an account, then head to API keys and click Create key. The plaintext value is shown once — copy it somewhere safe.

Note
Free keys are scoped to BTC and the last seven days of data. See pricing for the full Pro tier.

2. Make your first request

Set the key as an environment variable, then list resolved BTC markets on the 1-hour timeframe:

terminal
export TRADRR_API_KEY="tr_live_..."

curl https://api.tradrr.dev/v1/markets \
  -H "Authorization: Bearer $TRADRR_API_KEY" \
  -G \
  --data-urlencode "asset=BTC" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "resolved=true" \
  --data-urlencode "limit=3"

3. Read the response

Each market includes the condition ID (use it to fetch books or trades), the start/end window, the resolved outcome, and total volume.

200 OK
{
  "data": [
    {
      "id": "0xabc123...",
      "slug": "btc-updown-1h-1747776000",
      "asset": "BTC",
      "timeframe": "1h",
      "start_ts": "2025-05-20T12:00:00Z",
      "end_ts":   "2025-05-20T13:00:00Z",
      "start_price": 67342.10,
      "end_price":   67501.88,
      "resolved_outcome": "Up",
      "volume": 184230.55
    }
  ],
  "next_cursor": "eyJ0cyI6..."
}

4. Pull a full order book

Take any id from above and fetch its L25 book snapshots. Pass tier=full for the 25-level depth (Pro), or omit it for top-of-book quotes only.

terminal
curl https://api.tradrr.dev/v1/markets/0xabc123.../book \
  -H "Authorization: Bearer $TRADRR_API_KEY" \
  -G \
  --data-urlencode "tier=full"

What's next