PokerInk Developer API

Deterministic poker math, free, no authentication.

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. Hold'em equity enumerates every remaining board runout; nothing is simulated. Omaha equity (game=omaha, four-card hands) is exact on every postflop street and scores a fixed, seeded 200,000-board sample preflop, so even the sampled numbers are deterministic and reproducible. There are no accounts, keys, or usage tiers: requests are bounded by input caps (2-4 hands, 5 board cards, 16KB bodies) and a compute budget that returns 429 with a Retry-After header under load.

Endpoints

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)

POST/api/mcpMCP server (Streamable HTTP, stateless): calculate_equity and analyze_hand 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"

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.

Versioning and limits

/api/v1/ is the stable surface; the original unversioned /api/poker/ paths are permanent aliases of v1. Breaking changes only ever ship under a new version prefix, with at least six months of dual availability announced via Deprecation and Sunset headers on the old version. Every response carries RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset headers denominated in estimated compute milliseconds for the serving instance (a hold'em preflop enumeration costs about 350, a sampled PLO preflop 400-800, postflop near zero); a 429 includes Retry-After. Errors are a typed object: an error.code of invalid_input, rate_limited, or internal, plus a human-readable error.message.

Machine-readable surfaces

OpenAPI 3.1 spec: /api/poker/openapi.json (works as-is for custom GPT Actions and function-calling agents)
MCP manifest: /.well-known/mcp.json; connect assistants to https://pokerink.com/api/mcp (Streamable HTTP, no auth)
Site guide for AI crawlers: /llms.txt

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.