getBetsReport

import { getBetsReport, BetStatusFilter } from '@azuro-org/toolkit'
 
const report = await getBetsReport({
  chainId: 137,
  filter: { bettor: '0x...', status: BetStatusFilter.Settled },
})
 
// `single` is non-null whenever exactly one settlement token is present - the normal case, since a
// chain has one bet token. Fall back to the first row of `byToken` only when there is more than one.
const row = report.single ?? report.byToken[0]
 
// `roi` is `null` when turnover is 0 (e.g. no settled bets yet) - never `NaN`, so guard before formatting
const roiLabel = row && row.roi !== null ? `${row.roi.toFixed(2)}%` : '—'
 
if (report.isTruncated) {
  // more bets matched the filter than the walk covered - present the figures as a lower bound,
  // e.g. "based on the most recent 50,000 bets", instead of a final total
}

type GetBetsReportParams = {
  chainId: ChainId
  filter: BetsFilter
  /** aborts the in-flight multi-page walk, e.g. when the filter changes mid-walk */
  signal?: AbortSignal
  /** default: 1000, the maximum page size the subgraph accepts */
  pageSize?: number
  /** default: 50, which caps the walk at 50 000 bets */
  maxPages?: number
}

type BetsFilter = {
  bettor: Address // bettor address
  affiliate?: Address // affiliate address
  status?: BetStatusFilter // lifecycle preset - narrows both the bet list and this report
  kind?: BetKind // single (Ordinar) vs combo (Express)
  createdFrom?: number // inclusive lower bound, unix seconds (matches `Bet.createdAt`)
  createdTo?: number // inclusive upper bound, unix seconds
  isFreebet?: boolean // `true` = freebet-funded only, `false` = own-funds only, omit = both
  /** @deprecated renamed to `status` - when both are set, `status` wins */
  type?: BetStatusFilter
}
 
enum BetStatusFilter {
  Unredeemed = 'unredeemed', // ready to redeem bets
  Pending = 'pending', // not yet accepted on-chain
  Accepted = 'accepted', // accepted, not yet resolved
  Settled = 'settled', // resolved bets
  CashedOut = 'cashedOut', // cashed out bets
}
 
enum BetKind {
  Single = 'single',
  Combo = 'combo',
}
 
type ChainId =
  | 100     // Gnosis
  | 137     // Polygon
  | 80002   // Polygon Amoy
  | 88888   // Chiliz
  | 88882   // Chiliz Spicy
  | 8453    // Base
  | 84532   // Base Sepolia
  | 97      // BSC Testnet
  | 56      // BSC
 
import { type Address } from 'viem'

type GetBetsReportResult = BetsReportResult & {
  /** `true` when the walk stopped before the end of the bettor's history (it hit `maxPages`, or more
   * than 5000 bets share one timestamp) - the figures below are then a lower bound, not an exact
   * total, and the UI must surface that */
  isTruncated: boolean
}
 
type BetsReportResult = {
  /** one row per settlement token, sorted by turnover descending */
  byToken: BetsReportRow[]
  /** non-null iff exactly one token is present - render this instead of `byToken` whenever it is
   * non-null, which is the normal case since a chain has one bet token */
  single: BetsReportRow | null
  /** every bet matching the filter, freebet-funded ones included - see count semantics below */
  betsCount: number
}
 
type BetsReportRow = {
  token: { address: Address, decimals: number, symbol: string | null }
  /** own-funds bets only - freebet-funded ones are counted in `freebet.count` instead */
  betsCount: number
  /** `betsCount` splits into these three */
  settledCount: number
  pendingCount: number
  canceledCount: number
  /** decimal strings, already formatted with the token's decimals - the whole result is JSON-safe,
   * no bigint ever appears in it */
  turnover: string
  returns: string
  profit: string
  /** percent, `profit / turnover * 100`; `null` when turnover is 0 - never `NaN` or `Infinity` */
  roi: number | null
  /** sum of the stakes of unsettled, non-freebet bets */
  atStake: string
  /** sum of the stakes returned by voided bets, excluded from every figure above */
  refunded: string
  /** freebet-funded bets, excluded from every figure above */
  freebet: {
    count: number
    canceledCount: number
    /** stakes of freebet-funded bets */
    turnover: string
    /** the bettor's share of their payouts */
    returns: string
    /** equals `returns` - the bettor staked none of their own money */
    profit: string
    atStake: string
    refunded: string
  }
}

type BetsReportSelection = {
  /** @deprecated ignored: the report reads the payout recorded for the bet and never prices it from the odds of its legs */
  odds?: string
  isCanceled: boolean
}
 
type BetsReportEntry = {
  id: string
  status: GraphBetStatus
  result: BetResult | null
  isCashedOut: boolean
  isFreebet: boolean
  /** whether a freebet's stake goes back to the freebet fund when it wins - decides the bettor's share;
   * null or absent counts as returnable; ignored on a bet funded by the bettor */
  isFreebetAmountReturnable?: boolean | null
  /** @deprecated ignored: `rawPayout` already holds the amount actually paid once the bet is redeemed,
   * so the report reads it whether the bet is redeemed or not */
  isRedeemed: boolean
  /** @deprecated ignored: the report reads the payout recorded for the bet, which is already priced by the rules
   * in force when the bet was placed */
  createdAt?: number
  /** integer string, token base units */
  rawAmount: string
  /** integer string, token base units: the payout recorded for the bet; a freebet's goes to the freebet contract,
   * which passes the bettor only a share of it */
  rawPayout: string | null
  rawCashoutPayout: string | null
  /** every leg of the bet - a single is a bet with exactly one of them */
  selections: BetsReportSelection[]
  token: { address: Address, decimals: number, symbol: string | null }
}