Up/Down

Round Detail

GET

/api/v1/updown/rounds/{token}/{tf}/{roundId}

Single UPDOWN round with aggregate bet/claim statistics. Per-bettor wallet lists are NOT returned — use /api/v1/me/updown for per-wallet history (the same data is also queryable on-chain via getLogs).

Auth: API Key

Path params: token (btc/eth/bnb), tf (numeric 0-4 or slug 5m/15m/1h/4h/24h), roundId (positive integer).

Response

{
  "token": "btc",
  "round": {
    "contract": "0x0f761eb2386d0663ee5784552dee141d37957c36",
    "tf": 2,
    "roundId": 13,
    "startTime": "2026-04-30T17:00:00.000Z",
    "endTime": "2026-04-30T18:00:00.000Z",
    "settledAt": "2026-04-30T18:01:24.000Z",
    "startPriceUsd8dec": "9480000000000",
    "endPriceUsd8dec": "9512345000000",
    "endPriceRoundId": "18446744073709551823",
    "bullPoolUsdb": "8500000000000000000",
    "bearPoolUsdb": "5180000000000000000",
    "sharesBull": "8480000000000000000",
    "sharesBear": "5160000000000000000",
    "seedBonusUsdb": "0",
    "outcome": "bull_wins",
    "settler": "0xabcd...1234"
  },
  "bets": {
    "totalEvents": 14,
    "distinctBettors": 9,
    "bull": {
      "bettors": 5,
      "stakeUsdb": "8500000000000000000",
      "sharesTotal": "8480000000000000000"
    },
    "bear": {
      "bettors": 4,
      "stakeUsdb": "5180000000000000000",
      "sharesTotal": "5160000000000000000"
    }
  },
  "claims": {
    "total": 5,
    "won": 5,
    "refunded": 0,
    "totalPayoutUsdb": "12800000000000000000"
  }
}

200 Round detail returned400 Invalid path parameter404 Round not found or token not deployed