Guides · learn by product job

Pick a job. Ship the next call.

Start with one working request, then follow the track for the product you are building. Every guide uses the same public API contract, real endpoints, and study-only safety boundary.

26guides across GTO, PokerKit, SDKs, and MCP
Recommended first · 8 minutes

Make one real GTO strategy request.

Create a key, send one preflop spot, and read the mixed frequencies. The free tier covers the entire quickstart.

Start quickstart →Open Reference
POST /v1/gto/preflop41ms · 200 OK
{
  "situation": "Raise",
  "strategy": [
    { "action": "fold",  "frequency": 0.254 },
    { "action": "call",  "frequency": 0.106 },
    { "action": "raise", "frequency": 0.640 }
  ]
}

Complete library

Choose by outcome, not endpoint name.

Guidesemantics

How do I process poker ranges with an API?

Expand documented notation, classify value and nut advantage deterministically, compare equity with Monte-Carlo controls, and keep every result in training or review.

14 min · IntermediateOpen →
Guidesemantics

How do I analyze board texture with an API?

Send a flop, turn, or river board to PokerKit Texture and interpret its documented categorical texture and suit-shape fields.

8 min · BeginnerOpen →
Guidesemantics

How do I analyze a poker board with an API?

Choose Board Report for texture plus nuts, Category Combos for live combos by made-hand category, Texture for board labels, or Nuts for the strongest makeable hand.

10 min · IntermediateOpen →
Guidesemantics

How do I analyze a poker hand with an API?

Submit hole cards and a board to PokerKit Hand Report, interpret factual texture, tier, draws, outs, and blocker context, and keep the workflow in post-session study.

12 min · IntermediateOpen →
Guidesemantics

How do I get poker draws, outs, and blockers with an API?

Use the public PokerKit draws, outs, and blockers contracts to label a completed hand without treating labels as equity, advice, or real-time assistance.

10 min · IntermediateOpen →
Guidesemantics

How do I calculate tournament ICM with an API?

Send ordered chip stacks and payouts to PokerKit ICM, then interpret the returned ICM equity values by player position.

9 min · IntermediateOpen →
Guidesemantics

How do I parse and replay PokerKit hand histories?

Parse a PokerKit .phh hand history into structured data, then replay its documented actions into full-information snapshots for post-session display or review.

15 min · AdvancedOpen →
Guidesemantics

How do I calculate poker range equity with an API?

Submit two or more ranges, an optional board, and Monte-Carlo sampling controls; then read each returned equity with its sample count.

11 min · IntermediateOpen →
Guidelive solve

How do I query GTO node EVs with an API?

After a solver spot is queryable, request per-hand, per-action EV arrays for one node and interpret them against the returned action order.

11 min · AdvancedOpen →
Quickstartpresolved

Make your first GTO poker API request

Get an API key, run one minimal curl request, interpret a real mixed-strategy response, and handle quotas and errors.

8 min · BeginnerOpen →
Guidefoundation

How should I handle Pokerai API errors and retries?

Classify documented 400, 401, 429, and applicable 5xx responses, redact diagnostics, and retry only within the current public contract.

7 min · IntermediateOpen →
Quickstartpresolved

How do I make my first request with the Pokerai Python SDK?

Install the official Python package, authenticate an API client from an environment variable, and call the documented preflop strategy endpoint.

10 min · BeginnerOpen →
Quickstartpresolved

How do I make my first request with the Pokerai JavaScript SDK?

Install the official JavaScript package, create a typed client with an environment-supplied API key, and call the documented preflop strategy endpoint.

10 min · BeginnerOpen →
Guidefoundation

How do I authenticate securely with Pokerai API?

Keep API keys on the server, send the documented Bearer header or SDK client, and handle authentication, access, and quota responses without exposing secrets.

6 min · BeginnerOpen →
Guidefoundation

What are Pokerai API quotas and pricing boundaries?

Verify the published Free monthly counters, distinguish an exhausted quota from solver busy capacity, and use the current Pricing page for paid-plan details.

6 min · BeginnerOpen →
Tutorialpresolved

Build a GTO trainer

Part 1 — make your first preflop strategy call, read mixed frequencies, and grade a decision by its GTO frequency. Runnable Python, real API responses.

18 min · IntermediateOpen →
Guideoverview

What is a GTO poker solver API?

A citation-friendly explanation of Pokerai API: what it returns, when to use it, which endpoints map to product tasks, and how SDKs and MCP fit.

9 min · BeginnerOpen →
Guidelive solve

How do I safely run a GTO solver API solve?

Schedule, poll, read, and release one solver handle using only the documented solver, tree, node, and release contracts.

16 min · AdvancedOpen →
Guideoverview

Hosted solver API vs desktop solver

Choose a hosted API for product integration and repeatable requests, or a desktop solver for local research and custom tree design.

7 min · BeginnerOpen →
Guidepresolved

How do I get preflop strategy from an API?

Send hole cards, Hero's position, the prior action line, and an optional strategy version; then read mixed frequencies, raise-to sizes, quota, and errors.

12 min · BeginnerOpen →
Case studycase study

Counterplay · 过招

A real-time GTO trainer for iOS built entirely on the API — 270-line client, zero cached strategy. See exactly which endpoint powers which part of the app.

6 min · IntermediateOpen →
Referencereference

Poker & GTO glossary

Plain-English definitions of every term used across the API and these ranges — GTO, solver, mixed frequency, isomorphic board, blocker, SPR, and more.

Browse · All levelsOpen →
Chartsreference

GTO preflop ranges

Browsable 13×13 range grids for 6-max — every opening and defense spot at 100bb and 40bb, straight from the API.

Browse · All levelsOpen →
Guideworkflow

How can a poker AI agent use MCP?

Connect an AI agent to the official Pokerai MCP server, discover its actual tools, keep a human in review, and use poker data only for study workflows.

12 min · IntermediateOpen →
Guideworkflow

How do I build a poker hand review workflow?

Parse a completed hand, explain board and hand semantics, estimate equity, and attach a GTO lookup for study-time review.

20 min · AdvancedOpen →
Guidesemantics

How do I build a deterministic poker game-state workflow?

Rebuild a full-information game snapshot from documented actions, inspect legal actions, and append one checked action for training or post-session review.

14 min · AdvancedOpen →