Send two or more player ranges to the public PokerKit equity endpoint; add a board, sample count, and seed only when your use case needs them.
POST /v1/pokerkit/equity with the required ranges array. It is a Monte-Carlo equity calculation, not a GTO recommendation or real-time play assistant.| Fact | Value |
|---|---|
| Operation | POST /v1/pokerkit/equity |
| Required parameter | ranges: per-player range notation arrays. |
| Optional parameters | board (defaults to an empty string), sample_count, and seed. |
| Method | Monte-Carlo; the OpenAPI description says sample_count is capped and an unset value uses the default. |
| Reproducibility | seed is the public request parameter for reproducible sampling. |
curl -s https://pokerai.bet/v1/pokerkit/equity \
-H "Authorization: Bearer $POKERAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ranges":[["AA","KK"],["QQ","JJ"]]}'The public EquityRequest schema requires only ranges. Add board for a known board and sample_count or seed only when the documented sampling controls are needed.
A successful response is documented as HTTP 200. The public OpenAPI snapshot intentionally leaves its response schema open, so client code should inspect the returned JSON and avoid assuming undocumented fields or a single recommended action. Equity describes the submitted ranges and cards; it does not supply GTO strategy.
| HTTP | Public contract | What to do |
|---|---|---|
| 422 | HTTPValidationError | Check the required ranges shape and any supplied parameter types. |
| Sampling | sample_count is capped | Do not assume a larger submitted value will be used; use the API response and reference for current behavior. |
Use this endpoint for training, coaching, hand review, study, and research. Real-money real-time assistance (RTA) is prohibited. This page does not publish plan-specific allowances or promise live-table assistance.
EquityRequest contract.Real-time assistance at real-money tables is prohibited.