Up/Down

My Up/Down Summary

GET

/api/v1/me/updown

Aggregate UPDOWN bet/claim summary for the authenticated wallet across BTC/ETH/BNB and all timeframes. Multi-bet on the same round counts as one position for win/loss tallying.

Auth: Session or API Key

All on-chain numeric values returned as decimal strings. Stake/payout amounts are USDB 18-dec. Use netUsdbfor "am I up or down" — it can be negative for losing wallets.

Response

{
  "wallet": "0x1234...abcd",
  "totalBetEvents": 27,
  "distinctRoundsBet": 18,
  "totalStakeUsdb": "12500000000000000000",
  "totalPayoutUsdb": "15000000000000000000",
  "netUsdb": "2500000000000000000",
  "wins": 7,
  "losses": 8,
  "refunds": 1,
  "activeBetsCount": 2,
  "claimableCount": 1,
  "activeBets": [
    {
      "token": "btc",
      "contract": "0x0f761eb2386d0663ee5784552dee141d37957c36",
      "tf": 2,
      "roundId": 14,
      "side": "bull",
      "stakeUsdb": "1000000000000000000",
      "placedAt": "2026-04-30T18:42:11.000Z",
      "endTime": "2026-04-30T19:00:00.000Z"
    }
  ],
  "claimableBets": [
    {
      "token": "btc",
      "contract": "0x0f761eb2386d0663ee5784552dee141d37957c36",
      "tf": 0,
      "roundId": 12,
      "side": "bear",
      "stakeUsdb": "500000000000000000",
      "outcome": "bear_wins"
    }
  ]
}

For the exact USDB amount a claimableBets entry will pay, call quoteClaimPayout(tf, roundId, user) on-chain.

200 Summary returned401 Not authenticated