如何用 PokerKit API 计算锦标赛 ICM?
将按位置排列的锦标赛奖金结构和筹码量发送至 POST /v1/pokerkit/icm,即可按相同玩家顺序获得 ICM equity 值。
payouts 与 chips 数组。公开示例的响应中,result.icm 的每个值都按数组位置对应提交的玩家筹码量和奖金结构。核心事实
| 端点 | POST /v1/pokerkit/icm |
|---|---|
| 必填输入 | 公开 OpenAPI schema 中的数字数组 payouts 与 chips |
| 响应 | 含 icm 数字数组的 result 对象 |
| 用途边界 | 用于锦标赛 equity 计算、训练、教学、手牌复盘、学习和研究;禁止真实资金 RTA |
输入语义
chips 提供锦标赛筹码量,payouts 提供奖金数值。公开 IcmRequest schema 要求这两个字段。请保持玩家顺序不变:已文档化响应返回 icm 数组,因此应按提交 chips 的位置解读其各项。
最小请求与响应
使用 JSON 和 API key。下方请求和响应来自公开 pokerkitIcm docs-code 示例。
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]}'{"result":{"icm":[38.392857142857146,32.75,28.857142857142854]}}
解读 ICM equity
在该示例中,第一个提交的筹码量 5000 对应第一个返回的 ICM 值 38.392857142857146;第二和第三项也按相同位置对应。应将这些数值读作该奖金结构和筹码输入的 endpoint ICM equity 输出,不要改写为筹码量、胜率、solver 策略或推荐扑克行动。
适用边界与用途
当锦标赛训练、教学或已结束手牌复盘流程需要根据给定奖金结构和筹码量计算 ICM equity 时,使用此 endpoint。它不提供手牌范围、卡牌、下注行动、锦标赛策略或牌局中的建议;不得用于真实资金牌局的实时决策辅助。
配额和错误
该端点与公开 PokerKit API 使用相同的 API key 和账号配额体系。请查看配额文档、定价页和 dashboard 的当前账号限制,不要硬编码额度。
公开 OpenAPI contract 声明了 422 参数校验错误响应。请先按当前 Reference 或 OpenAPI schema 检查两个必填数组,再修正并重新提交请求。鉴权和账号配额处理请参照当前错误文档;不要重试未改变的无效请求。
禁止真实资金 RTA
Pokerai API 仅用于训练、教学、手牌复盘、学习和研究。禁止在真实资金牌桌上提供实时辅助。不要将 ICM 输出转为 live-table 行动指令或自动化信号。
相关资源
请将本指南与当前公开 contract 和账号文档结合使用。
| 资源 | 涵盖内容 | 使用目的 |
|---|---|---|
POST /v1/pokerkit/icm | 根据 payouts 与 chips 计算 ICM equity | 查看当前公开请求与响应 contract |
SDK、MCP 与相关资源
- 开发者文档 — 官方 SDK 和 MCP 设置,以及鉴权和配额
- API Reference — 查看当前 ICM 请求与响应 contract
- OpenAPI snapshot — 机器可读的中文 contract
- Python SDK — 官方 package 入口
- TypeScript / JavaScript SDK — 官方 package 入口
- MCP server — 官方 package 入口
- 扑克手牌复盘 API 指南 — 将 ICM 计算放入牌局结束后的工作流
- llms.txt — 精简的 LLM 入口