Markets

Resolved Up-or-Down markets, indexed by asset and timeframe. The id returned here is the canonical key for the order book and trades endpoints.

List markets

GET/v1/markets

Returns a cursor-paginated list of markets matching the filter. By default only resolved markets are returned, sorted by end_ts descending.

Query parameters

FieldTypeDescription
assetstringOne of BTC, ETH, SOL, XRP, DOGE, BNB, HYPE. Omit for all assets (Pro only).
timeframestringOne of 5m, 15m, 1h, 4h, daily.
resolvedbooleanDefaults to true. Set to false to include in-progress markets (resolved_outcome will be null).
fromISO 8601Lower bound on end_ts.
toISO 8601Upper bound on end_ts.
limitintegerPage size, max 500. Defaults to 100.
cursorstringPass the next_cursor from the previous page.

Example request

terminal
curl https://api.tradrr.dev/v1/markets \
  -H "Authorization: Bearer $TRADRR_API_KEY" \
  -G \
  --data-urlencode "asset=BTC" \
  --data-urlencode "timeframe=1h" \
  --data-urlencode "from=2025-01-01" \
  --data-urlencode "to=2025-03-31" \
  --data-urlencode "limit=2"

Response

200 OK
{
  "data": [
    {
      "id": "0xabc123...",
      "condition_id": "0xabc123...",
      "slug": "btc-updown-1h-1747776000",
      "asset": "BTC",
      "timeframe": "1h",
      "start_ts": "2025-03-31T22:00:00Z",
      "end_ts":   "2025-03-31T23:00:00Z",
      "start_price": 82145.12,
      "end_price":   82310.40,
      "resolved_outcome": "Up",
      "volume": 142908.31,
      "trade_count": 1284,
      "outcome_token_ids": {
        "Up":   "1234567890...",
        "Down": "9876543210..."
      }
    }
  ],
  "next_cursor": "eyJ0cyI6..."
}

Get a single market

GET/v1/markets/{conditionId}

Returns the same shape as a single element of the list endpoint, plus derived stats: 1-minute volatility of the underlying, time spent above each side, and the count of book snapshots stored.

terminal
curl https://api.tradrr.dev/v1/markets/0xabc123... \
  -H "Authorization: Bearer $TRADRR_API_KEY"

Common follow-ups