PokerKit API でトーナメント ICM を計算するにはどうすればよいですか?
順序どおりのトーナメント賞金とチップスタックを POST /v1/pokerkit/icm に送信すると、同じプレイヤー順で ICM エクイティ値を受け取れます。
payouts 配列と chips 配列を送信してください。ドキュメントに記載されたレスポンスでは、result.icm の各値は配列内の位置によって、そのプレイヤーが送信したチップスタックとトーナメントの賞金配分構造に対応します。要点
| エンドポイント | POST /v1/pokerkit/icm |
|---|---|
| 必須入力 | payouts と chips。どちらも公開 OpenAPI スキーマ内の数値配列です |
| レスポンス | icm 数値配列を含む result オブジェクト |
| 利用範囲の境界 | トレーニング、コーチング、ハンドレビュー、学習、研究のためのトーナメントエクイティ計算。リアルマネーを伴うリアルタイム支援 (RTA) には使用できません |
入力の意味
chips はトーナメントのチップスタックを指定し、payouts は賞金配分額を指定します。どちらのフィールドも、公開 IcmRequest スキーマで必須です。プレイヤーの順序は固定してください。ドキュメントに記載されたレスポンスは icm 配列を返すため、その位置は送信した chips の位置に対応して解釈されます。
最小限のリクエストとレスポンス
JSON と API キーを使用します。このリクエストとレスポンスは、公開されている pokerkitIcm のドキュメント用コード例です。
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 エクイティの解釈
この例では、最初に送信されたスタック 5000 は、最初に返される ICM 値 38.392857142857146 に対応します。2 番目と 3 番目の位置も同様に対応します。これらの値は、このペイアウトとスタックの入力に対するエンドポイントの ICM エクイティ出力として扱ってください。チップ数、勝率、ソルバーの戦略、推奨ポーカーアクションとして再分類しないでください。
対象範囲と用途
トーナメントのトレーニング、コーチング、または完了済みハンドのレビューのワークフローで、指定されたペイアウト構造と一連のスタックから ICM エクイティを計算する必要がある場合に、このエンドポイントを使用します。ハンドレンジ、カード、ベッティングアクション、トーナメント戦略、またはゲーム中の推奨は提供しません。ライブのリアルマネー意思決定支援には使用しないでください。
クォータとエラー
このエンドポイントは、公開 PokerKit API と同じ API キーおよびアカウントクォータシステムを使用します。制限をハードコードするのではなく、現在のアカウント制限については クォータのドキュメント、料金、ダッシュボードを確認してください。
公開 OpenAPI コントラクトでは、422 のバリデーションエラーのレスポンスが定義されています。リクエストを修正して再送信する前に、必須の両方の配列が現在のリファレンスまたは OpenAPI スキーマに適合していることを確認してください。認証とアカウントのクォータ処理については、現在の エラーのドキュメント を参照してください。内容を変更していない無効なリクエストを再試行しないでください。
リアルマネーでのリアルタイム支援 (RTA) 禁止
Pokerai API は、トレーニング、コーチング、ハンドレビュー、学習、研究にのみ使用できます。リアルマネーテーブルでのリアルタイム支援 (RTA) は禁止されています。ICM の出力をライブテーブルでのアクション指示や自動化シグナルに変換しないでください。
関連リソース
このガイドと併せて、現在の公開コントラクトおよびアカウントドキュメントを参照してください。
| リソース | 対象内容 | 用途 |
|---|---|---|
POST /v1/pokerkit/icm | payouts と chips に基づく ICM エクイティ計算 | 現在公開されているリクエストとレスポンスのコントラクトを確認する |
SDK、MCP、および関連リソース
- 開発者向けドキュメント — 認証とクォータに加え、公式 SDK と MCP のセットアップ
- API リファレンス — 現在の ICM リクエストおよびレスポンス仕様を確認する
- OpenAPI スナップショット — 機械可読な英語の仕様
- Python SDK — 公式パッケージのエントリポイント
- TypeScript / JavaScript SDK — 公式パッケージのエントリポイント
- MCPサーバー — 公式パッケージのエントリポイント
- ポーカーハンドレビュー API ガイド — ICM 計算をセッション後のワークフローに組み込む
- llms.txt — 簡潔な LLM エントリポイント