On this page

Frequently asked questions

Updated · Maintained by Pokerai API · Source Docs

What is Pokerai API?

Direct answer
The self-serve, solver-grade GTO strategy API for 6-max No-Limit Hold'em. It returns mixed-frequency strategies for preflop and flop from presolved solutions, with turn and river solved on demand; every request is stateless and self-contained.
Use this when
Building training, coaching, hand-review, study, research, or agent workflows around 6-max NLHE strategy.
Not for
PLO, ICM, gambling transactions, or real-money table assistance.
Verify in
Docs

What is GTO?

GTO (game-theory-optimal) is a strategy that can't be exploited no matter how your opponents adjust. Instead of one “best” move, each spot has a balanced mix of actions at specific frequencies — which is exactly what Pokerai API returns.

What is a solver?

Software that computes the GTO strategy for a spot by iterating (counterfactual regret minimization, CFR) until both players’ strategies stop improving — i.e. converge to equilibrium. Solving is compute-heavy, so Pokerai serves millions of presolved spots instantly and solves the rest on demand.

Why frequencies instead of one “best” move?

Because a single fixed action is exploitable. GTO stays balanced by mixing — e.g. 99 facing an open might raise 64%, call 11%, fold 25%. You randomize per those frequencies (a clock, a die, your own scheme) so opponents can't read you.

What’s an “isomorphic board”?

Boards identical up to suit relabeling — A♠K♠2♠ and A♥K♥2♥ play the same. Collapsing these suit-symmetric duplicates to one canonical board is why ~66K isomorphic flop spots cover every real flop, keeping the presolved database small and fast.

Which formats and streets does it cover?

Direct answer
6-max NLHE across all four streets: preflop and flop use presolved solutions, while turn and river solve on demand. PLO and ICM are not covered.
Use this when
6-max No-Limit Hold'em strategy workflows that can use the documented GTO endpoints.
Not for
PLO, ICM, or unsupported poker formats.
Verify in
Docs

Is Pokerai API a desktop solver download?

Direct answer
No. Pokerai API is a hosted HTTP API for documented strategy data. Use desktop solver software when you need local tree construction or research control; use a benchmark or gameplay API when you need to evaluate an agent or simulate a game.
Use this when
Integrating documented strategy data into a training, review, research, or agent workflow.
Not for
Downloading local solver software, ranking desktop solvers, or treating benchmark/gameplay outcomes as GTO strategy output.

What stack depths are available?

Multiple depths (e.g. 100bb, 40bb), selected via the preflop chart version. Call GET /v1/gto/preflop/versions to list them.

How do I authenticate?

Direct answer
Send an Authorization: Bearer <API_KEY> header. Get a free key at /login — no credit card.
Use this when
Calling authenticated public API endpoints from your server, SDK, or MCP configuration.
Not for
Embedding an API key in browser-delivered client code or sharing it publicly.

How does the quota work?

Direct answer
Each key has independent monthly counters for presolved preflop/flop lookups and real-time turn/river solves. An exhausted counter returns HTTP 402 quota_exceeded.
Use this when
Estimating usage for a key and handling quota-exhausted responses in an integration.
Not for
Assuming unused capacity in one counter can be transferred to the other.
Verify in
Quota docs

Which calls are free?

Reading a solved spot's tree/nodes (/solver/tree, /solver/node), node EVs (/evs), a flop node (/flop/node), and reusing a cached solve. /v1/gto/solver only charges when it triggers a new solve.

Does it return a single recommended action?

No. It returns the GTO frequency of each action (check/call/bet/raise/fold), so you randomize per your own strategy rather than always taking one move.

Are requests stateless? Do you store my hands?

Requests are stateless and self-contained. The API does not store the hands/spots you send — only your account email and per-key usage counts.

Can I use it for real-time assistance (RTA)?

Direct answer
No. RTA at real-money tables is prohibited. Pokerai API is for training, coaching, hand review, study, and research.
Use this when
Offline study, coaching, post-hand review, research, and training products.
Not for
Real-time assistance during play at real-money tables.
Verify in
Terms

Is there a free tier?

Direct answer
Yes. The Free tier includes 1,000 presolved lookups and 25 real-time solves per month, with no credit card required.
Use this when
Trying the documented API workflows within the published Free monthly allocation.
Not for
Assuming Free capacity covers production usage beyond those published counters.
Verify in
Pricing

How fast is it?

Preflop and flop are served in milliseconds. Turn/river are solved on demand: submit to /v1/gto/solver, poll /v1/gto/solver/tree until queryable, then read — an available → computing → queryable state machine.

Is there an OpenAPI spec and interactive reference?

Direct answer
Yes. The public OpenAPI snapshot is at /openapi.en.json, with an interactive reference and LLM context.
Use this when
Inspecting documented operations or generating a client from the public API contract.
Not for
Treating undocumented endpoints or fields as supported.

Do you have SDKs or an MCP server?

Direct answer
Yes. Official clients are pokerai-bet for Python, @pokerai/client for TypeScript, and @pokerai/mcp for AI agents; other clients can be generated from the public OpenAPI contract.
Use this when
Integrating through the listed official client packages or an OpenAPI-generated client.
Not for
Assuming an unlisted package is official or supports undocumented API behavior.
Verify in
API reference

How do I contact support or sales?

Use the Contact page to choose the right official channel. Email support@pokerai.bet for product, account, quota, or billing help; email sales@pokerai.bet for Scale plans and partnerships.

How do I report a security issue?

Email security@pokerai.bet. Do not publish vulnerability details, API keys, authentication headers, or personal data in Telegram, Discord, GitHub, or another public channel.