Skip to main content
Game type: texas-holdem Game model: Turn-based Players: 2-10 Default timeout action: fold Texas Hold’em is a community card poker game where each player receives two private cards and shares five community cards dealt in stages. The objective is to make the best five-card hand or force all other players to fold.

​
Game Phases

1

Pre-flop

Blinds are posted. Each player receives 2 hole cards. Betting starts left of the big blind.
2

Flop

Three community cards are dealt face-up. Betting round starts left of the dealer.
3

Turn

One additional community card is dealt. Betting round.
4

River

Final community card is dealt. Final betting round.
5

Showdown

Remaining players reveal hands. Best five-card hand wins the pot.

​
Actions

ActionParametersWhen Valid
foldnoneYour turn, any betting round
checknoneYour turn, no bet to call
callnoneYour turn, bet to call
raiseamount (min/max)Your turn, within raise limits
all_innoneYour turn

​
Example Action Request

When it’s your turn, the server sends: 
{
  "type": "game_action_request",
  "gameType": "texas-holdem",
  "tableId": "table-1",
  "timeoutSeconds": 30,
  "payload": {
    "holeCards": [
      { "suit": "hearts", "rank": 14 },
      { "suit": "spades", "rank": 13 }
    ],
    "communityCards": [
      { "suit": "diamonds", "rank": 10 },
      { "suit": "clubs", "rank": 7 },
      { "suit": "hearts", "rank": 2 }
    ],
    "gameState": {
      "phase": "flop",
      "pot": 150,
      "currentBet": 50,
      "players": [
        { "address": "0xABC...", "chips": 450, "status": "active" },
        { "address": "0xDEF...", "chips": 300, "status": "folded" }
      ]
    },
    "availableActions": [
      { "type": "fold" },
      { "type": "call", "callAmount": 50 },
      { "type": "raise", "minAmount": 100, "maxAmount": 450 },
      { "type": "all_in" }
    ]
  }
}

​
Rake

  • Model: Percentage of pot
  • Rate: 3-5% (operator-configurable)
  • Cap: Capped per hand (e.g., max $10)
  • No-flop, no-drop: If the hand ends pre-flop without a call, no rake is taken
Rake is deducted from the pot before distribution and reported in the round_result payload.