Up/Down

List Rounds

GET
/api/v1/updown/rounds
Paginated list of the Up/Down rounds of one asset (and optionally timeframe / outcome), newest first per timeframe.
Auth: API Key

Query params: token (required: an asset slug or asset index from GET /api/v1/updown/assets; asset is an alias for the index), tf or timeframe (numeric 0-4 or slug 5m/15m/1h/4h/24h), outcome (pending, bull_wins, bear_wins, canceled), noWinner (true/false), cursor (opaque, from pagination.nextCursor), limit (default 20, max 200).

Prices are raw feed answers; divide by 10^priceDecimals (the feed's own decimals, not always 8). Pools, stakes, shares and seed are pool-token amounts (18 decimals). Payouts are in the asset's settle asset (pairDecimals). Fields ending Usdb or Usd8dec are deprecated aliases with their old values. status is live, awaiting_settle, awaiting_cancel, settled or canceled: outcome: "pending" only means not settled in the index. A settled round with nobody on the winning side still reads bull_wins / bear_wins and has noWinner: true: every bet is refunded. endPrice is null on a canceled round.

Response
{
  "token": "btc",
  "asset": 0,
  "latestIndexed": { "0": 812, "1": 270, "2": 14, "3": 4, "4": 1 },
  "rounds": [
    {
      "contract": "0x...",
      "asset": 0,
      "main": "0x...",
      "settle": "0x...",
      "pairAsset": "0x...",
      "poolToken": "0x...",
      "pairDecimals": 6,
      "pairSymbol": "USDG",
      "tf": 2,
      "roundId": 14,
      "startTime": 1777572000,
      "endTime": 1777575600,
      "settledAt": null,
      "startPrice": "9483612000000",
      "endPrice": null,
      "priceFeed": "0x...",
      "priceDecimals": 8,
      "endPriceRoundId": null,
      "bullPool": "5200000000000000000",
      "bearPool": "3100000000000000000",
      "sharesBull": "5180000000000000000",
      "sharesBear": "3090000000000000000",
      "seedBonus": "0",
      "outcome": "pending",
      "status": "live",
      "noWinner": false,
      "settler": null,
      "startPriceUsd8dec": "9483612000000",
      "endPriceUsd8dec": null,
      "bullPoolUsdb": "5200000000000000000",
      "bearPoolUsdb": "3100000000000000000",
      "seedBonusUsdb": "0"
    }
  ],
  "pagination": { "limit": 20, "hasMore": true, "nextCursor": "13" }
}
200 Rounds returned400 Invalid query parameter404 Asset not configured or not listed on chain yet409 Asset index mismatch (config and chain disagree)503 Up/Down not deployed on this network