How do I process poker ranges with an API?
Use PokerKit range endpoints to turn documented notation into concrete combos, inspect deterministic range properties, or estimate range equity with explicit Monte-Carlo controls; use GTO range endpoints when the task is a documented solver range workflow.
POST /v1/pokerkit/range/expand to expand notation. Use /range/value and /range/nut-advantage for deterministic board-based range analysis, and /range/equity-advantage when you need a Monte-Carlo equity-share estimate. For solver-derived ranges, use the published /v1/gto/range, /v1/gto/flop/projected-range, or /v1/gto/turn/projected-range contracts.Quick facts
| Notation | PokerKit range notation arrays such as ["AA", "KQs"]; expand returns concrete two-card combos. |
|---|---|
| Deterministic | range/expand, range/value, and range/nut-advantage do not use Monte-Carlo sampling. |
| Monte-Carlo | range/equity-advantage accepts documented sample_count and seed; a seed supports reproducible sampling. |
| Quota | The deterministic PokerKit range endpoints charge 1 general quota. range/equity-advantage charges 1 solve quota. |
| GTO ranges | GTO range endpoints are separate solver workflows. Read their current request and response schema from the Reference or OpenAPI snapshot. |
| Use boundary | For training, coaching, hand review, study, and research; not real-money real-time assistance. |
Range notation
Pass a JSON array of notation strings. AA denotes a pocket-pair hand class and KQs denotes suited king-queen; the expand response lists concrete card pairs. Keep notation, board, and player order with your stored review input so a result remains interpretable.
Minimal verified request and response
This public docs-code example calls POST /v1/pokerkit/range/expand. Send your API key in Authorization: Bearer $POKERAI_API_KEY and JSON content type.
{"notation": ["AA", "KQs"]}{"result": [["Ac", "Ad"], ["Ac", "Ah"], ["Ac", "As"], ["Ad", "Ah"], ["Ad", "As"], ["Ah", "As"], ["Kc", "Qc"], ["Kd", "Qd"], ["Kh", "Qh"], ["Ks", "Qs"]]}Each inner array is one concrete two-card combo. This response explains the supplied notation; it is not a GTO action recommendation.
Choose the range operation
| Need | Public endpoint | Method |
|---|---|---|
| Expand notation | POST /v1/pokerkit/range/expand | Deterministic combo expansion. |
| Build a value range on a board | POST /v1/pokerkit/range/value | Deterministic made-category floor using aggression or floor. |
| Compare nut share | POST /v1/pokerkit/range/nut-advantage | Deterministic combo-count nut-share split. |
| Compare equity share | POST /v1/pokerkit/range/equity-advantage | Monte-Carlo estimate for two supplied ranges; use sample_count and seed only as documented. |
| Advance a solver range | POST /v1/gto/range, /flop/projected-range, or /turn/projected-range | Published GTO range contracts for the stated solver workflow. |
Deterministic versus Monte-Carlo
Do not label an expand, value, or nut-advantage result as a simulation: those operations are deterministic for the supplied input. equity-advantage is different: it is Monte-Carlo, so its result is an estimate for the submitted ranges and board. A fixed seed makes sampling reproducible, not universally exact; retain the returned sample_count when presenting the result.
Quota and errors
| Signal | Meaning | What to do |
|---|---|---|
| 401 | missing_api_key or invalid_api_key. | Send a valid API-key header; do not expose it in client logs. |
| 429 | quota_exceeded when the applicable monthly counter is exhausted. | Wait for reset or reduce work; do not retry an unchanged request. |
| 422 | Request validation failed. | Check the current Reference or OpenAPI schema for the endpoint and correct the body. |
Check quota documentation and the dashboard for current counters. GTO range endpoints follow their own documented quota behavior.
Training and review only
Related resources
- Developer docs — authentication, PokerKit, GTO workflows, and quotas.
- API Reference — current range operation schemas.
- OpenAPI snapshot — machine-readable English contract.
- Python SDK, TypeScript / JavaScript SDK, and MCP server — official package entry points.
- Poker equity API guide — multi-range equity estimates.
- llms.txt — concise LLM entry point.