Up/Down

List Rounds

GET

/api/v1/updown/rounds

Paginated list of UPDOWN rounds for a given token (and optionally timeframe / outcome). Returns rounds newest-first per timeframe. Cursor pagination via roundId (descending).

Auth: API Key

Query params: token (required: btc, eth, bnb), tf or timeframe (numeric 0-4 or slug 5m/15m/1h/4h/24h), outcome (pending, bull_wins, bear_wins, canceled), cursor (roundId), limit (default 20, max 200).

Prices are Chainlink int256 8-decimal — divide by 1e8 for USD. Pools/shares/seedBonus are USDB 18-decimal.

Response

{
  "token": "btc",
  "rounds": [
    {
      "contract": "0x0f761eb2386d0663ee5784552dee141d37957c36",
      "tf": 2,
      "roundId": 14,
      "startTime": "2026-04-30T18:00:00.000Z",
      "endTime": "2026-04-30T19:00:00.000Z",
      "settledAt": null,
      "startPriceUsd8dec": "9483612000000",
      "endPriceUsd8dec": null,
      "endPriceRoundId": null,
      "bullPoolUsdb": "5200000000000000000",
      "bearPoolUsdb": "3100000000000000000",
      "sharesBull": "5180000000000000000",
      "sharesBear": "3090000000000000000",
      "seedBonusUsdb": "0",
      "outcome": "pending",
      "settler": null
    }
  ],
  "pagination": { "limit": 20, "hasMore": true, "nextCursor": "13" }
}

200 Rounds returned400 Invalid query parameter404 Token not deployed