Docs topic · PokerKit ICM

How do I calculate ICM equity with Pokerai API?

Send payout and chip arrays to the public PokerKit ICM endpoint to calculate an ICM equity split.

Updated Maintained by Pokerai API

Direct answer: call POST /v1/pokerkit/icm with the required payouts and chips arrays. It is a deterministic ICM equity calculation, not tournament GTO solving or real-time play assistance.

Quick facts

FactValue
OperationPOST /v1/pokerkit/icm
Required parameterspayouts and chips, both number arrays.
OpenAPI examplespayouts: [50, 30, 20]; chips: [5000, 3000, 2000].
CalculationDeterministic ICM equity split from payouts and chips.
Not includedThis operation is not documented as a tournament GTO solver or a real-time recommendation endpoint.

Minimal API request

curl -s https://pokerai.bet/v1/pokerkit/icm \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"payouts":[50,30,20],"chips":[5000,3000,2000]}'

The public IcmRequest schema requires both arrays. Preserve the relationship between each player's chip value and the corresponding payout model in your own request construction.

How to interpret the response

A successful response is documented as HTTP 200. The public OpenAPI snapshot leaves its response schema open, so client code should consume the returned JSON without relying on undocumented field names. Treat the result as an ICM equity split for the submitted inputs, not as a recommended poker action.

Errors, limits, and safe use

HTTPPublic contractWhat to do
422HTTPValidationErrorConfirm that both required arrays are provided and contain numbers.
ScopeICM equity onlyDo not infer tournament GTO coverage, payout variants, or plan allowances that are not in the public contract.

Use this endpoint for training, coaching, hand review, study, and research. Real-money real-time assistance (RTA) is prohibited. This page makes no live-table or real-time advisory claim.

Related documentation

Real-time assistance at real-money tables is prohibited.