Quickstart

1. Check the API is running

curl https://hedgeem-v5.qeetoto.com/api/health

{
  "status": "ok",
  "service": "hedgeem-api",
  "version": "0.1.0",
  "timestamp": "2026-03-19T10:00:00.000Z"
}

2. Get a Supabase JWT

# Store your token
TOKEN="your-supabase-jwt-here"

3. Sit at a table

curl -X POST https://hedgeem-v5.qeetoto.com/api/tables/1/sit \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"playerId": "your-player-id", "buyInAmount": 500}'

{
  "acknowledgement": "ACK",
  "seatId": 1,
  "seatBalance": 500.00
}

4. Get the game state

curl https://hedgeem-v5.qeetoto.com/api/tables/1/state \
  -H "Authorization: Bearer $TOKEN"

The response includes the current game state, all four hands, community cards, and the odds panels for each hand.

5. Advance to the Hole stage

curl -X POST https://hedgeem-v5.qeetoto.com/api/tables/1/advance \
  -H "Authorization: Bearer $TOKEN"

The response returns the updated game state with gameState: "STATUS_HOLE" and four dealt hands in the hands array.

6. Place a bet

Bet 50 chips on hand index 0 (the first hand):

curl -X POST https://hedgeem-v5.qeetoto.com/api/tables/1/bet \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "playerId": "your-player-id",
    "seatIndex": 0,
    "handIndex": 0,
    "betAmount": 50
  }'

{
  "acknowledgement": "ACK",
  "message": "Bet placed successfully.",
  "updatedSeatBalance": 450.00
}

Next steps

Game States — understand the full game lifecycle
Card Notation — how cards are represented in the API
Full API Reference — all endpoints