# Documentation

## Docs

- [Deal hands](https://hedgeem-api.qeetoto.com/api-reference/game/deal-hands.md): Shuffles a fresh deck, deals hole cards to N simultaneous hands, and returns pre-flop win/draw odds for each hand.
- [Generate bulk game data](https://hedgeem-api.qeetoto.com/api-reference/game/generate-bulk-game-data.md): Generates N complete pre-calculated game states — each containing all 4 stages (HOLE, FLOP, TURN, RIVER) with odds already computed for every hand.
- [Get player](https://hedgeem-api.qeetoto.com/api-reference/players/get-player.md): Returns a player's profile, account balance, and personal table assignment.
- [Health check](https://hedgeem-api.qeetoto.com/api-reference/system/health-check.md): Returns the API status and version. No authentication required.
- [Advance game](https://hedgeem-api.qeetoto.com/api-reference/tables/advance-game.md): Advances the game to the next stage: - **Setup → Hole** — shuffles deck, deals two cards to each hand - **Hole → Flop** — deals three community cards - **Flop → Turn** — deals the turn card - **Turn → River** — deals the river card, resolves winning hand, pays out bets - **River → Setup** — clears t…
- [Get game state](https://hedgeem-api.qeetoto.com/api-reference/tables/get-game-state.md): Returns the full current game state for a table, including: - Current game state and betting stage - All four hands (once dealt) - Community cards (flop, turn, river) as they are revealed - Per-hand odds panels for the current and previous stages - All seats and their balances - All bets placed in t…
- [Place a bet](https://hedgeem-api.qeetoto.com/api-reference/tables/place-a-bet.md): Places a bet on a specific hand at the current betting stage.
- [Sit at table](https://hedgeem-api.qeetoto.com/api-reference/tables/sit-at-table.md): Seats a player at a table with a specified buy-in amount. The buy-in is deducted from the player's account balance and credited to their seat balance.
- [Top up chips](https://hedgeem-api.qeetoto.com/api-reference/tables/top-up-chips.md): Transfers chips from the player's account balance to their seat balance.
- [HedgeEm Feature Specification — Index](https://hedgeem-api.qeetoto.com/feature-docs/_index.md): Version parity matrix and living feature catalogue for all Texas HedgeEm implementations
- [F010 — Chip Denominations](https://hedgeem-api.qeetoto.com/feature-docs/betting/F010-chip-denominations.md): Chip denomination values available for betting, passed to the GDK at init and used by the chip selector UI
- [F011 — Bet Placement](https://hedgeem-api.qeetoto.com/feature-docs/betting/F011-bet-placement.md): How players place bets on hands at each deal stage
- [F012 — Bet Cancellation](https://hedgeem-api.qeetoto.com/feature-docs/betting/F012-bet-cancellation.md): Cancelling pending bets before they are committed to the server, restoring the display to the last confirmed API state
- [F013 — Multi-hand Betting](https://hedgeem-api.qeetoto.com/feature-docs/betting/F013-multi-hand-betting.md): Betting independently on each of the multiple hands dealt simultaneously in one game round
- [F014 — Multi-stage Betting](https://hedgeem-api.qeetoto.com/feature-docs/betting/F014-multi-stage-betting.md): Operator-configurable betting stages: ANTE-BET, PRE-FLOP, POST-FLOP, TURN
- [F015 — Payout Calculation](https://hedgeem-api.qeetoto.com/feature-docs/betting/F015-payout-calculation.md): How winnings are calculated at river — winning hand bets paid at locked-in odds
- [F083 — Skill-based Bonus Rounds](https://hedgeem-api.qeetoto.com/feature-docs/bonus/F083-bonus-rounds.md): Occasional skill-based bonus games that add variety and incentivise longer play
- [F084 — Multi-level Progressive Jackpots](https://hedgeem-api.qeetoto.com/feature-docs/bonus/F084-progressive-jackpots.md): Small, medium, and large jackpots that accumulate and pay on operator-configured trigger events
- [F032 — RTP Configuration](https://hedgeem-api.qeetoto.com/feature-docs/config/F032-rtp-config.md): Operator install-time configuration of target RTP and related parameters
- [F033 — Rounding Algorithms](https://hedgeem-api.qeetoto.com/feature-docs/config/F033-rounding-algorithms.md): Odds rounding to player-friendly values; affects displayed odds and actual RTP
- [F001 — Hand Count Rules](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F001-hand-count.md)
- [F002 — Deck Management](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F002-deck-management.md)
- [F004 — Game Stages](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F004-game-stages.md)
- [F005 — Hand Evaluation](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F005-hand-evaluation.md)
- [F006 — Odds Calculation](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F006-odds-calculation.md): Converting win probability to player-facing payout odds with RTP margin applied
- [F007 — RTP Margin Application](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F007-rtp-margin.md): Operator-configured house margin subtracted from fair odds to achieve target RTP
- [F008 — Hand Status](https://hedgeem-api.qeetoto.com/feature-docs/game-engine/F008-hand-status.md): Per-hand status labels emitted by the server at each betting stage, driving UI indicators and GDK win flow
- [F020 — Deal Button / Auto-deal on Load](https://hedgeem-api.qeetoto.com/feature-docs/ui/F020-deal-button.md): Game initialises at hole stage automatically on load; DEAL button starts subsequent games
- [F022 — Card Display](https://hedgeem-api.qeetoto.com/feature-docs/ui/F022-card-display.md): Hole cards dealt face-up for all hands; community cards dealt face-down and revealed per stage
- [F043 — Config and Sound Controls](https://hedgeem-api.qeetoto.com/feature-docs/ui/F043-config-sound-bar.md): Gear (settings) and sound-level buttons rendered as HTML overlay on the game canvas
- [F044 — Info Modal (i + ? tabs)](https://hedgeem-api.qeetoto.com/feature-docs/ui/F044-info-modal.md): Two-tab information overlay: illustrated tutorial ('i') and text rules ('?')
- [F045 — Deal Animation (Hole Cards Fly from Shuffler)](https://hedgeem-api.qeetoto.com/feature-docs/ui/F045-deal-animation.md): On deal, hole cards animate from the card shuffler/shoe to their target hand panel positions
- [F046 — Deal Sound Effects (Per-Card dealing_cards SFX)](https://hedgeem-api.qeetoto.com/feature-docs/ui/F046-deal-sounds.md): A dealing_cards sound effect fires for each hole card as it launches from the shuffler, synced to the fly animation
- [F047 — Fast Play Config (2× animation speed)](https://hedgeem-api.qeetoto.com/feature-docs/ui/F047-fast-play.md): Fast Play config toggle halves all card animation durations — deal fly, community flip, stagger delays
- [F048 — Coin Spill Animation (Win Payout)](https://hedgeem-api.qeetoto.com/feature-docs/ui/F048-coin-spill-animation.md): On a winning round, gold coins burst from the centre of the win panel and cascade across the screen while YOU WON and the amount are displayed
- [F090 — Horse Name Nicknames](https://hedgeem-api.qeetoto.com/feature-docs/v7/F090-horse-name-nicknames.md): Poker hand to horse name mapping — 169-entry lookup table covering all Texas Hold'Em starting hands
- [V7 UI Component Inventory](https://hedgeem-api.qeetoto.com/feature-docs/v7/ui-components.md): Complete catalogue of UI components in HedgeEm — common components shared across game variants and V7 horse-race–specific components
- [Versions Overview](https://hedgeem-api.qeetoto.com/versions/overview.md): All HedgeEm client versions — tech stacks, repos, and deployment URLs.

## OpenAPI Specs

- [openapi](https://hedgeem-api.qeetoto.com/openapi.yaml)