# CHANCE

> Integrate on-chain Chance bets with GraphQL discovery, realtime proofs, and viem.

## Docs

- [GraphQL — betResult / betResults](https://docs.chance.money/api-reference/bet-result.md): Fetch result, payout, and Groth16 proof for one bet or a batch — the poll fallback to the socket.
- [Errors & limits](https://docs.chance.money/api-reference/errors-and-limits.md): GraphQL error extension codes, batch and pagination limits, and socket caps.
- [GraphQL — health](https://docs.chance.money/api-reference/health.md): Liveness probe, available as a GraphQL query and a plain GET endpoint.
- [GraphQL — networkConfigs](https://docs.chance.money/api-reference/network-configs.md): Query.networkConfigs — chain ids and live contract addresses per Robinhood network.
- [Overview](https://docs.chance.money/api-reference/overview.md): Public Chance API — one GraphQL endpoint and one Socket.IO channel, no auth.
- [GraphQL — playerBets / pendingBetCount](https://docs.chance.money/api-reference/player-bets.md): Indexed wallet history with status filters and offset pagination, plus the pending-bet counter.
- [Socket.IO — bets](https://docs.chance.money/api-reference/socket-bets.md): bets:subscribe / bets:unsubscribe / bets:update — exact payloads, the wallet cap, and reconnect behavior.
- [Acquiring CHANCE](https://docs.chance.money/chance-token/acquiring.md): The two live acquisition paths — claim-as-CHANCE on wins and staker rewards.
- [Overview](https://docs.chance.money/chance-token/overview.md): CHANCE is the protocol token; USDG is the money. How the two relate.
- [Selling](https://docs.chance.money/chance-token/selling.md): CHANCE→USDG sells are public through the Uniswap V4 router — even under the transfer lock.
- [Transfer lock](https://docs.chance.money/chance-token/transfer-lock.md): What a wallet can and cannot do with CHANCE while transfers are locked.
- [Claiming](https://docs.chance.money/integrate/claiming.md): claim vs claimWithProof vs claimBets, and choosing USDG vs CHANCE payout.
- [History](https://docs.chance.money/integrate/history.md): playerBets and pendingBetCount — paginated wallet history with status filters.
- [Introduction](https://docs.chance.money/integrate/introduction.md): The integrator mental model — value moves on-chain, the API handles discovery, results, and realtime.
- [Networks & contracts](https://docs.chance.money/integrate/networks.md): Resolve chainId and contract addresses via networkConfigs — never hardcode them.
- [Placing bets](https://docs.chance.money/integrate/placing-bets.md): Building place args per mode, keeping expectedCommitId fresh, and attributing bets to your platform.
- [Results & proofs](https://docs.chance.money/integrate/results-and-proofs.md): Socket-first result delivery with a GraphQL poll fallback — and what proof:null means.
- [Bet constraints](https://docs.chance.money/protocol/bet-constraints.md): Every gate a place call must pass — size limits, liability caps, the EV identity, and commit freshness.
- [Bet modes](https://docs.chance.money/protocol/bet-modes.md): Strike, Range, and Ladder — payout shapes, formulas, and when to use each.
- [Contract methods](https://docs.chance.money/protocol/contract-methods.md): The player-path ChancePool call surface — place, claim, stake, and the views you'll actually use.
- [Events](https://docs.chance.money/protocol/events.md): Player-relevant ChancePool events — bet lifecycle, epochs, staking — with field tables.
- [Overview](https://docs.chance.money/protocol/overview.md): ChancePool, the staker bankroll, and Uniswap V4 — the protocol from a player's point of view.
- [Provably fair](https://docs.chance.money/protocol/provably-fair.md): Epoch commit–reveal with Poseidon entropy and ZK proofs — no key can decide a payout.
- [Place → proof → claim](https://docs.chance.money/quickstart/place-proof-claim.md): End-to-end Chance bet with viem (TypeScript) — networkConfigs, approve, place, proof over socket, claimWithProof.
- [Coming soon](https://docs.chance.money/sdk/coming-soon.md): A typed Chance SDK is planned. Use the Quickstart and API reference today.
- [Deposit & withdraw](https://docs.chance.money/staking/deposit-and-withdraw.md): stake, the two-step unstake with cooldown or early unlock, and the views that tell you when funds are ready.
- [Overview](https://docs.chance.money/staking/overview.md): Stakers are the house — bankroll LPs who underwrite every bet and earn on house wins.
- [Rewards](https://docs.chance.money/staking/rewards.md): USD compounding vs claimable CHANCE — each staker picks the form of their house-win share.
- [Welcome](https://docs.chance.money/welcome/index.md): Chance docs for game integrators — place bets, verify proofs, claim winnings, and read the protocol reference.