PokerInk
Free API

Developer API

Deterministic poker math over REST and MCP. No accounts, no keys, no usage tiers.

PokerInk exposes its deterministic poker engines — the same ones behind the hold'em and Pot Limit Omaha odds calculators and the in-app AI coach — as a public API.

Exact, not simulated

Hold'em equity enumerates every remaining board runout.

Omaha (game=omaha, four-card hands) is exact on every postflop street, and preflop it scores a fixed, seeded 200,000-board sample — so even the sampled numbers reproduce exactly.

No authentication

No accounts, no keys, no usage tiers. Nothing to sign up for and nothing to rotate.

Bounded, not metered

Requests are capped by shape rather than by quota:

  • 2-4 hands
  • 5 board cards
  • 16KB request bodies

A compute budget returns 429 with Retry-After under load.

Endpoints

VerbPath
GET/api/v1/poker/equityMultiway equity for 2-4 hands (params p1-p4, optional board; game=omaha for four-card PLO)
GET/api/v1/poker/analyzeMade hand + draws with outs for one hand on a board (params hand, board)
GET/api/v1/poker/pot-oddsPot odds and the equity a call needs, plus an exact hit chance and call/fold verdict (params pot, bet, optional outs + street)
POST/api/mcpMCP server (Streamable HTTP, stateless): calculate_equity, analyze_hand, and calculate_pot_odds tools

Try it

curl "https://pokerink.com/api/poker/equity?p1=JhTh&p2=AsAd&board=9h8h2c"

# Pot Limit Omaha: four cards per hand, game=omaha
curl "https://pokerink.com/api/poker/equity?game=omaha&p1=AsAhKsKh&p2=JdTd9c8c"

# Should you call? Pot 80, bet 40, nine outs with two cards to come.
# Returns 3:1, the 25% needed, the exact 35% you hit, and the verdict.
curl "https://pokerink.com/api/poker/pot-odds?pot=80&bet=40&outs=9&street=flop"

Card notation: rank (2-9, T or 10, J, Q, K, A) plus suit letter (h, d, c, s), for example AhKs or 10d 7c. Responses are deterministic and cached immutably.

The two chain naturally: analyze reports a hand's out count as total_outs, and pot-odds turns that count into a decision. Both halves are worth calling rather than working out in a prompt — the break-even share is call ÷ (pot + bet + call), which is easy to slip into bet ÷ (pot + bet), and the Rule of 2 and 4 overstates a fifteen-out flop draw by nearly six points.

Versioning and limits

Versioning

/api/v1/ is the stable surface. The original unversioned /api/poker/ paths are permanent aliases of v1 — they will not be removed.

Breaking changes only ever ship under a new version prefix. The old version stays available for at least six months, and its responses announce the wind-down through Deprecation and Sunset headers.

Rate limits

Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. They are denominated in estimated compute milliseconds for the serving instance, not in request counts — so what you can spend depends on what you ask for:

RequestApprox. cost
Hold'em preflop (full enumeration)~350 ms
PLO preflop (seeded sample)400-800 ms
Any postflop streetnear zero

Exceed the budget and you get a 429 with Retry-After.

Errors

Errors are a typed object, never a bare string. error.code is one of invalid_input, rate_limited or internal; error.message is human-readable and safe to log.

Machine-readable surfaces

The design and engineering story behind the API: AI Assistants Guess at Poker Math. We Gave Them Our Engine Instead. Questions or higher-volume use: contact us.

Building something with poker math?

The API is free and needs no key. An account adds the other half: hand and session tracking, analytics over your own results, and an AI coach that reads your actual play.

Get the free appAll free tools