ICM deals

When play stops and the remaining players want to split the prize pool, the Independent Chip Model (ICM) converts their chip stacks into real-money equity. Use it for final-table deal-making and tournament tooling.

POST /v1/calculations/icm/deal

Smallest runnable example

Code
curl https://api.pokerworks.io/v1/calculations/icm/deal \
  -H "Authorization: Bearer pw_test_…" \
  -H "Content-Type: application/json" \
  -d '{
    "players": [
      { "id": "seat-1", "stack": 420000 },
      { "id": "seat-2", "stack": 280000 },
      { "id": "seat-3", "stack": 160000 }
    ],
    "payouts": [
      { "place": 1, "amount": 5000 },
      { "place": 2, "amount": 3000 },
      { "place": 3, "amount": 2000 }
    ]
  }'

Important inputs

• players — the remaining players, each with an id and a chip stack.
• payouts — the prize for each remaining paid place.
• blendPct (optional) — blend the pure-ICM result toward a straight chip-chop, 0–100. A common deal-making lever.
• unit (optional) — the currency label for the amounts (e.g. "USD").

players must contain 2-10 entries; each player has id (1-64 characters), optional name (1-80 characters), and a positive integer stack. payouts must contain 1-10 entries with positive integer place and non-negative finite amount. unit defaults to units and can be chips, points, units, USD, EUR, GBP, AUD, or CAD.

Response highlights

• Each player's ICM-fair payout (and the blended payout if blendPct is set).
• The standard envelope: requestId, creditsCharged, engine, method, warnings, and result.

result contains players, payouts, finishProbabilities, summary, advice, input, and meta. Each player includes icmAmount, icmSharePct, chipChopAmount, floorFirstChipChopAmount, equalChopAmount, blendedAmount, stack/share fields, and deltas against chip-chop baselines. method.type is deterministic.

Common mistakes

• Payout total not matching the prize pool you intend to split — the model distributes exactly what you provide.
• Sending zero or negative stacks.
• Expecting a chip-chop — pure ICM is not proportional to chips; use blendPct to lean that way.

Reference

Full schema and all fields → API reference