Skip to main content
POST
/
api
/
deal
Deal hands
curl --request POST \
  --url https://hedgeem-v5.qeetoto.com/api/deal \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "numberOfHands": 4
}
'
{
  "hands": [
    "AcKd",
    "QsJs",
    "8h7c",
    "5d2c"
  ],
  "handOdds": [
    {
      "handIndex": 0,
      "bettingStage": 0,
      "handStatus": "IN_PLAY_FAVOURITE",
      "winPercentage": 62.4,
      "drawPercentage": 2.1,
      "odds": 1.6
    },
    {
      "handIndex": 1,
      "bettingStage": 0,
      "handStatus": "IN_PLAY_BETTING_STAGE_ACTIVE",
      "winPercentage": 21.3,
      "drawPercentage": 1.8,
      "odds": 4.69
    },
    {
      "handIndex": 2,
      "bettingStage": 0,
      "handStatus": "IN_PLAY_BETTING_STAGE_ACTIVE",
      "winPercentage": 10.2,
      "drawPercentage": 0.9,
      "odds": 9.8
    },
    {
      "handIndex": 3,
      "bettingStage": 0,
      "handStatus": "IN_PLAY_BETTING_STAGE_ACTIVE",
      "winPercentage": 6.1,
      "drawPercentage": 0.5,
      "odds": 16.39
    }
  ],
  "remainingDeck": [
    "2c",
    "3d",
    "4h",
    "..."
  ]
}

Authorizations

​
Authorization
string
header
required

Supabase Auth JWT. Obtain via Supabase Auth sign-in.

Body

application/json
​
numberOfHands
integer
default:4

Number of simultaneous hole card hands to deal (2–6, default 4)

Required range: 2 <= x <= 6
Example:

4

Response

Shuffled hands and pre-flop odds

​
hands
string[]

Dealt hole card pairs. Each string is two concatenated card codes, e.g. "AcKd" = Ace of clubs + King of diamonds. See Card Notation.

Example:
["AcKd", "QsJs", "8h7c", "5d2c"]
​
handOdds
object[]

Pre-flop odds for each hand. Same shape as the handOdds array in HedgeEmGameState — the game client renders these directly as betting panels.

​
remainingDeck
string[]

The 44 cards not yet in play. The flop (3 cards), turn (1), and river (1) will be drawn from this pool when the game advances.

Example:
["2c", "3d", "4h", "5s"]