Up/Down

Round Detail

GET
/api/v1/updown/rounds/{token}/{tf}/{roundId}
Single Up/Down round with aggregate bet/claim statistics. Per-bettor wallet lists are NOT returned: use /api/v1/me/updown for per-wallet history, or read one wallet's bet with getUserBet(asset, tf, roundId, user).
Auth: API Key

Path params: token (an asset slug or asset index from GET /api/v1/updown/assets), tf (numeric 0-4 or slug 5m/15m/1h/4h/24h), roundId (positive integer).

Prices are raw feed answers; divide by 10^priceDecimals. Pools, stakes, shares and seed are pool-token amounts (18 decimals). Payouts are in the asset's settle asset (pairDecimals): totalPayout is in settle-asset units. paidByToken lists what bettors paid, per input token, in that token's own units. Fields ending Usdb or Usd8dec are deprecated aliases with their old values. A user counts in fullyClaimed once a claim leaves nothing remaining (claims can be partial). carry lists the carryover captured from this round (loser_cut, seed_excess or seed_rolled, in pool-token wei). endPriceRoundId is the feed round the settle used, stored when the round settles (as in the example); it is null while the round is open and for a canceled round.

Response
{
  "token": "btc",
  "asset": 0,
  "round": {
    "contract": "0x...",
    "asset": 0,
    "main": "0x...",
    "settle": "0x...",
    "pairAsset": "0x...",
    "poolToken": "0x...",
    "pairDecimals": 6,
    "pairSymbol": "USDG",
    "tf": 2,
    "roundId": 13,
    "startTime": 1777568400,
    "endTime": 1777572000,
    "settledAt": 1777572084,
    "startPrice": "9480000000000",
    "endPrice": "9512345000000",
    "priceFeed": "0x...",
    "priceDecimals": 8,
    "endPriceRoundId": "18446744073709551823",
    "bullPool": "8500000000000000000",
    "bearPool": "5180000000000000000",
    "sharesBull": "8480000000000000000",
    "sharesBear": "5160000000000000000",
    "seedBonus": "0",
    "outcome": "bull_wins",
    "status": "settled",
    "noWinner": false,
    "settler": "0xabcd...1234",
    "startPriceUsd8dec": "9480000000000",
    "endPriceUsd8dec": "9512345000000",
    "bullPoolUsdb": "8500000000000000000",
    "bearPoolUsdb": "5180000000000000000",
    "seedBonusUsdb": "0"
  },
  "bets": {
    "totalEvents": 14,
    "distinctBettors": 9,
    "bull": {
      "bettors": 5,
      "stakePoolTokens": "8500000000000000000",
      "stakeUsdb": "8500000000000000000",
      "sharesTotal": "8480000000000000000"
    },
    "bear": {
      "bettors": 4,
      "stakePoolTokens": "5180000000000000000",
      "stakeUsdb": "5180000000000000000",
      "sharesTotal": "5160000000000000000"
    },
    "paidByToken": [
      { "inputToken": "0x...", "amount": "13900000000000000000" }
    ]
  },
  "claims": {
    "total": 5,
    "events": 5,
    "won": 5,
    "refunded": 0,
    "fullyClaimed": 4,
    "totalPayout": "12800000",
    "totalPayoutUsdb": "12800000"
  },
  "carry": [
    { "kind": "loser_cut", "amount": "51800000000000000", "txHash": "0x..." }
  ]
}
200 Round detail returned400 Invalid path parameter404 Round not indexed, or asset not listed409 Asset index mismatch (config and chain disagree)503 Up/Down not deployed on this network