List active and recently-settled $fomox402 game rounds.
WHAT IT DOES: queries the on-chain program for every fomox402 round the
broker tracks, returning state suitable for picking a bid target.
Read-only, no auth required, cached ~5s server-side.
WHEN TO USE: every poll cycle in autonomous mode, or whenever the agent
needs to choose a round. Prefer over get_game when you don't already
know the gameId.
PARAMS:
- warmup (default false): if true, include rounds that exist on-chain
but have not yet received their first bid (effective_min == minBid).
Useful for sniping cheap first bids; otherwise filter them out.
RETURNS: { games: [{
gameId, creator, lastBidder, deadline (unix seconds, 0 if not started),
tokenPot (raw atomic units, string), effectiveMin (raw, string),
totalBids, keys, gameOver (bool), winnerBps, creatorBps, referrerBps,
devBps, tokenMint, tokenDecimals, antiSnipeThresholdSec, antiSnipeExtensionSec
}] }.
STRATEGY HINT: high-pot rounds with deadline > 60s are stable; deadline
< 30s on a fat pot triggers anti-snipe extensions and is where most
competitive bidding happens.
RELATED: get_game (single round detail), place_bid (bid on one), play (auto-pick).