API Reference v1 · stable OpenAPI JSON All systems operational
—

OpenAPI

Pokerai API reference

Cache EV/EQ endpoints are available in production since 2026-11-18. POST /v1/gto/postflop/cache/ev and /eq accept only a returned action token and concrete hole_cards. On /query, include_ev:true or include_eq:true returns 400 invalid_request before Auth validation, consumption or Native dispatch; omission/false remains ordinary query behavior. Each admitted independent EV/EQ request consumes 1 existing cache unit, including hit/join, and every admitted success carries that caller's cache_quota. Pre-admission inapplicable/unsupported missing consumes 0; after confirmation, failure, timeout or cancellation can still be charged. 503 cache_charge_unknown carries no quota and is not automatically retried; exhaustion returns 402 cache_quota_exceeded. The retained local-isolated capture is deployed:false, not a production three-street success or real-billing capture. Historical 2026-11-16/17 old query-flags documentation and captures (not current endpoint-call examples). Optional cache EV is available in production since 2026-11-16. To show strategy first, query normally, then request include_ev=true with an action token and hole_cards; this request waits for calculation within its budget. Use response token, not the display node path. EV is raw_net_bb in bb from the quantized cached fixed strategy, not solver live EV or EQ times pot. First release supports proven preset non-ARP configurations; custom and unsupported configurations return missing. Values follow strategy order; zero and negative values are valid, missing is never zero-filled, and any missing action makes combo missing. status is ok, partial, or missing. Non-Hero action returns the existing view and empty action_values with missing/not_applicable. EV uses one slot per owner, busy returns 200 strategy plus missing without queue; normal reader busy is 429, request timeout 504, identity drift 409. Native single EV/EQ calculations have a 15-second hard cap and a 14,900ms soft budget. Service reads remain capped at 15 seconds and Relay requests at 20 seconds; actual work can end sooner for the remaining deadline and cleanup reserve. These are implementation budgets, not a universal SLA. Linux processes remain limited to 2 GiB. Omission or false retains old wire, billing and fixed token TTL. Optional cache EQ is available in production since 2026-11-17. Use include_eq=true only with a returned action token and concrete hole_cards; it is mutually exclusive with include_ev=true, is a free node read, and adds no cache_quota. Its ratio is root_range_joint equity against the effective cached Flop root opponent range, not a path posterior or EV×pot. Existing root, Turn, and River selections retain their charges. On 2026-11-17, an existing Builder test account completed all 11 public HTTPS calls from coverage through Flop, Turn and River. The 6max 4BET UTG/MP hand used AsAh on 2c2d2h → 2s → 3c after CHECK/CHECK on each earlier street. All responses were HTTP 200 and all three EQ results were ok, matching the independent reference exactly; the original strategies were unchanged. The production capture retains complete requests, responses and timings. Its opaque tokens are stable redaction labels, not reusable credentials. The old local-isolated capture and examples remain separate and unchanged. Measured on pokerai-prod through the public HTTPS origin to completion of the response body: single observations, not client-device latency, Native-only time, p95 or an SLA. Only the root and two card selections consumed cache quota: 20→23/2,000. EQ, action navigation and coverage were free; presolved stayed 59 and solve stayed 0. [End of historical query-flags record.]

Download Postman collection — Download and import the public collection, then set its empty apiKey variable. It sends Authorization: Bearer {{apiKey}} to the public base URL and includes GTO and PokerKit examples.

Request body

Content-Type: application/json

* required

Responses

Documented status codes for this operation.