Discovery mode

Ask a node for its structure instead of a strategy: legal actions, sizes and tokens. Free of charge.

What it returns

discovery=true switches /v1/strategy to a structural answer: the legal actions at the node (type, amount, node_token) plus the two derivation gates, to_act and round_start_pot_bb. Legal means walkable: only actions whose destination node exists in the tree are listed (fold and street closes always). Frequency plays no part: an action our strategy never takes is still listed when the tree holds the answer to the villain taking it. If none of a node's actions has a continuation, the node is served as is and the walk ends with an informative 404 at the child. No frequencies in the body, no combo filtering: a discovery response cannot be mistaken for a hero decision.

When to use it

Discover the exact bet/raise sizes the tree offers before translating an observed table size.
Map a line ahead of time (which nodes exist, which tokens lead to a node) without spending quota.
Cross-check your node walk: if to_act disagrees with the seat you believe is acting, the walk is desynced.

Request

Same endpoint and same pool selectors. hand is IGNORED if sent (stripped before validation, so a malformed hand can never fail a discovery request), and verbosity is ignored too.

Discovery request

curl 'https://api.gtokiller.com/v1/strategy?platform=gg&stakes=10_50&playerType=regs&situation=srp&position=btn_bb&flop=2c2d2h&node=root-x-b1.82-r5.46-c-turn_9c&discovery=true' \
  -H "X-API-Key: $GTOKILLER_KEY"

Response

Flat shape, deliberately NOT wrapped in the data envelope. amount is present only on bet and raise; to_act and round_start_pot_bb use the exact same derivation as the strategy response, so the two modes can never disagree.

200Discovery response · 200

{
  "node_id": "root-x-b1.82-r5.46-c-turn_9c",
  "to_act": "oop",
  "round_start_pot_bb": 16.42,
  "actions": [
    { "type": "check", "node_token": "x" },
    { "type": "bet",   "node_token": "b8.21",  "amount": 8.21 },
    { "type": "bet",   "node_token": "b13.14", "amount": 13.14 }
  ]
}

Free of charge

Discovery requests are exempt from the monthly quota and the hard cap. The per-second rate limit still applies. Served discovery calls are tracked under a separate counter — never billed, never counted against quota.

Discovery pairs with the 404 diagnosis: when a walk goes off tree, the 404 body's legal_tokens tells you the walkable keys at the parent node, with the same rule (their destination node exists). Discovery is the proactive version of the same information: ask before you walk.

Outputs

Stateless mode