ActionRequest

The ActionRequest is the one payload your agent reads: a complete, self-contained snapshot of the decision in front of you. It contains only what you may see: your own hole cards, the public board, and the exact legal actions with amounts.

note

Opponent hole cards are never included. This is an engine-level guarantee backed by an allow-list test suite that runs on every street.

Example

{
  "handId": 7,
  "seat": 0,
  "isButton": false,
  "holeCards": ["As", "Kd"],
  "board": ["Qh", "7s", "2c"],
  "street": "flop",
  "pot": 800,
  "stacks": { "you": 19800, "opp": 19400 },
  "toCall": 400,
  "minBet": 0,
  "minRaiseTo": 800,
  "maxRaiseTo": 19800,
  "legalActions": ["fold", "call", "raise"],
  "actionHistory": "b150c/kb400",
  "timeLimitMs": 8000
}

Field reference

Field	Type	Description
handId	integer	Hand number within the current match. Increments by 1 each deal.
seat	0 | 1	Your seat identity for the whole match. Fixed at match start; does not change between hands.
isButton	boolean	true when you hold the button this hand. In heads-up, the button posts the small blind and acts first preflop, last postflop.
holeCards	string[]	Your two private cards in 2-char notation (see Card notation). Opponent hole cards are never present.
board	string[]	Public community cards in 2-char notation. Length: 0 preflop, 3 flop, 4 turn, 5 river.
street	string	Current betting round: preflop, flop, turn, or river.
pot	integer	Total pot in chips: everything both players have committed across all streets, including chips committed on the current street.
stacks	{you, opp}	Chips behind (not in the pot) for both seats.
toCall	integer	Chips you must add to match the current bet and stay in the hand. 0 means check is legal (no bet in front of you).
minBet	integer	Minimum opening bet size in chips when bet is in legalActions. 0 when bet is not legal (a bet is already in front of you).
minRaiseTo	integer	Minimum legal raise, measured in chips added by this action (Slumbot semantics). An exact all-in (maxRaiseTo) is always legal even if it falls below this floor.
maxRaiseTo	integer	Your all-in size, measured in chips added by this action (Slumbot semantics). Submitting this exact value is always a legal raise, regardless of minRaiseTo.
legalActions	string[]	The exact menu of moves you may submit this turn. Any type outside this list will be rejected.
actionHistory	string	Compact encoding of every move played this hand, streets separated by /. See encoding below.
timeLimitMs	integer	Your decision budget in milliseconds for this turn. v1 default is 8000 (8 seconds). Exceeding it causes the engine to play the safe default (check if legal, else fold) and issues a strike.

minRaiseTo is an amount to ADD, despite the name

The name reads as a raise-to total. It is not one, and the difference is the size of your call. Getting it backwards produces a below_min rejection, which costs a strike — three of those bench you, on a live broadcast.

Worked example. Blinds are 50/100, stacks start at 5000, and in heads-up the button posts the small blind and acts first preflop. It is your turn, on the button:

{
  "street": "preflop",
  "pot": 150,
  "toCall": 50,
  "minRaiseTo": 150,
  "maxRaiseTo": 4950,
  "legalActions": ["fold", "call", "raise"]
}

You have 50 in the pot already (your small blind). To make the minimum legal raise:

{ "type": "raise", "amount": 150 }

You send 150, and that puts you at 50 + 150 = 200 for the street — which is the raise-to total the engine is checking against, and which never appears on the wire.

The mistake this section exists to prevent: reading minRaiseTo: 150 as "raise to a total of 150", subtracting the 50 you have already committed, and submitting 100. That is below the minimum, so it is refused as below_min and takes a strike with it. The 50 is not to be subtracted — it is already accounted for.

The same holds at the top end. maxRaiseTo: 4950 is your all-in add: submit exactly 4950 and you are all in. Submit 5000 and you get above_max.

you have committed	you receive	you send for a min-raise	your street total becomes
50 (small blind)	minRaiseTo: 150	150	200
0 (opened the betting)	minBet: 100	100	100

minBet is the one field where both readings agree, because you have nothing committed yet when you open. That is also why the bug hides: an agent tested only on opening bets looks correct.

History encoding

One token per move, streets joined by /:

Token	Meaning
f	fold
k	check
c	call
b<N>	bet or raise adding N chips

Blinds are implicit; they are not encoded in actionHistory.

Example: "b150c/kb400" reads: preflop, the button raised (adding 150 chips) and the opponent called; on the flop, the opponent checked and the button bet 400. Your turn.