Strategy Grid V1

Endpoint:

<gto-glue>/strategy-grid

Requests:

Fields:

• stack_sizes: Player stacks in BB. The number of stacks represent the number of players.

  • Restrictions:
    • Only supports up to 8 players for specific models and 9 for global/generic models (it won’t break with more players).
    • Does not support zero stack players, please ignore them on the request (it will break the request).
    • Deph limit of the model is 2000bb’s (it won’t break with higher values).
    • The order matters. The list starts with the stack of the player in the Small Blind position:
      • SB → BB → STR (if applicable) → UTG → …

• request_id:

  • Field for client control. Currently also used for log control. Can be any string.
  • It is an optional field, but is strongly suggested to be used.

• action_line:

  • Compressed action-history string.
  • Money actions have it’s amount represented as big-blind in front of the actions name.
  • Example:
    • F-F-R6.8-C-F-F-F-F-6h8d4c-B10.5-C-2d-B21-C-8s-X

• game_format:

  • Essencial for auto-model selection and it is ignored for most model with manual model selectio
  • Currently available:
    • “2b-0.0”
    • “2b-0.5”
    • "2b-1.0"
    • “2b-2.0”
    • “2b-2.5”
    • “3b-0.0”
    • "3b-0.5"
    • “3b-1.0”
    • “3b-2.0”
    • “3b-2.5”

Example:

{
    "request_id": "request_example_01",
    "game_format": "3b-0.5",
    "action_line": "F-F-F-F-F-R7.5-F-C-7hQsKd-C",
    "stack_sizes": "200,200,200,200,200,200,200,200"
}

Response

• model: Model used to generate the response.

• strategy: Model response — array of combo-level entries.

  • combo: First level: pair, suited or offsuit (e.g. KK, KTo, KTs).
  • detail: First-level detail: list of all specific hands in this combo (e.g. KhTs).
    • combo: Second level: the specific hand (e.g. AsAh).
    • detail: Second-level detail: list of actions; each is ["action name", "strategy probability", "ev"].
    • reach: Probability that this specific hand would reach the current decision point given the action history (product of action probabilities along the path; from replay or solver).
  • detail_agg: Aggregated result for the combo: list of ["action name", "strategy probability", "ev"].
  • ev: Expected value for the combo at this node.
  • reach: Average reach probability over all specific hands in this combo — (sum of each hand’s reach) / (number of hands in combo). Indicates how much of this combo is still in range at the current node.
  • strategy: Probability of every action for this combo. Order of 11 entries (indices 0–10):
    • 0 — fold
    • 1 — call (or check)
    • 2 — all-in
    • 3 — ~33% pot (bet/raise)
    • 4 — ~50% pot (bet/raise)
    • 5 — ~75% pot (bet/raise)
    • 6 — ~100% pot (bet/raise)
    • 7 — ~150% pot (bet/raise)
    • 8 — ~250% pot (bet/raise)
    • 9 — ~10% pot (bet/raise)
    • 10 — ~25% pot (bet/raise)

• strategy_compute_time: Compute time in ms (if present).

• success: Boolean.

Example:

{

    "model": "moe_ev_2b1_bsz1.onnx",
    "strategy": [
        {
            "combo": "AA",
            "detail": [
                {
                    "combo": "AsAh",
                    "detail": [
                        [
                            "call",
                            "100.0%",
                            "24.89"
                        ]
                    ],
                    "reach": 1.0
                },
                (...)
            ],
            "detail_agg": [
                [
                    "fold",
                    "0.0%",
                    "0.00"
                ],
                [
                    "call",
                    "100.0%",
                    "24.89"
                ],
                (...)
            ],
            "ev": 24.88633728027344,
            "reach": 1.0,
            "strategy": [
                0.000013484615010384005,
                0.9999337196350098,
                1.532069826906679e-14,
                8.220706892991814e-10,
                1.6047474460378908e-10,
                0.0,
                0.000012085341040801724,
                0.000040630678995512426,
                1.5992345936410857e-7,
                0.0,
                0.0
            ]
        },
        (...)
    ],
    "strategy_compute_time": 703,
    "success": true
}