APIでポーカーレンジのエクイティを計算するには？

各プレイヤーのレンジ、任意のボード、および再現可能なモンテカルロ制御を PokerKit エクイティエンドポイントへ送信し、返されたシェアを使用して、結果を予測するのではなく、指定されたシナリオを説明します。

更新日 2026年7月26日メンテナンス担当 Pokerai API

直接回答: プレイヤーごとに1つの表記配列を含む ranges を指定して、POST /v1/pokerkit/equity を呼び出します。必要に応じてボード、sample_count、seed を含めます。レスポンスは、指定された各レンジのモンテカルロエクイティと、使用したサンプル数を返します。

概要

エンドポイント	`POST /v1/pokerkit/equity`
入力	PokerKitレンジ表記によるプレイヤーごとのレンジを2つ以上指定します。`board` は任意です。
方法	モンテカルロ法によるエクイティ推定。指定されたレンジとボードに対する推定値を返すものであり、オッズを保証するものではありません。
レスポンス	`result.equities` は `ranges` と対応する順序です。`result.sample_count` はサンプリングのコンテキストを示します。
クォータ	このエンドポイントは解析クォータを 1 回分消費します。現在の無料ティアには、月あたり 25 回のリアルタイム解析が含まれます。
アクセス	PokerKitとGTOエンドポイントは同じAPIキーを使用します。サポートされているAPIキーヘッダーを1つ送信してください。

入力の意味

プレイヤーごとに1つのネストされたレンジ配列を使用します。返されるエクイティは同じ順序を使用するため、配列の順序は重要です。ボードを指定する場合は、AhKhQh のように区切りのないカード文字列にします。

フィールド	意味
`ranges`	必須。各プレイヤーのレンジ表記文字列の配列。例：`[["AA"], ["KK"]]`。
`board`	既知のボードに対する任意のカード文字列。ボードが不明な場合は、このパラメータを省略するか空文字列を使用します。
`sample_count`	任意のモンテカルロサンプル数です。文書化されたサービス上限が適用されます。未指定の場合はデフォルトが使用されます。
`seed`	再現可能なサンプリングのための任意のシード。

最小限の API リクエスト

この公開ドキュメントコード例では、固定されたサンプル数とシードで、ボードが出る前の AA と KK を比較します。HTTP リクエストを送信する際は、認証ヘッダーとして API キーを追加してください。

{"ranges": [["AA"], ["KK"]], "board": "", "sample_count": 2000, "seed": 7}

レスポンス例と解釈

{"result": {"equities": [0.8235, 0.1765], "sample_count": 2000}}

最初の値 0.8235 は最初の入力レンジ（AA）に対応し、2 番目の値 0.1765 は KK に対応します。UI またはレポートではこの順序を維持してください。

sample_count: 2000 は、このレスポンスに使用されたモンテカルロ・サンプル数として読み取ってください。これはこの推定値のサンプリング条件を示すものであり、将来の配札、賭け、または将来のパフォーマンスを保証するものではありません。

これを使用するタイミング

トレーニング製品、完了したハンドのレビュー、コーチングツール、研究、またはレンジとボードがユーザーに明示される説明 UI でこのエンドポイントを使用してください。推定結果を監査可能な状態に保つため、指定した入力を結果とともに保存してください。

使用しない場合

エクイティ推定をリアルマネーのハンド中のアクション指示として使用しないでください。これはプレイヤーの判断、完全なゲームモデル、またはソルバー戦略に取って代わるものではありません。1 つの推定値が勝利、将来のカード、またはベッティングの結果を保証するかのように示唆しないでください。

クォータと認証

リクエストには Authorization: Bearer $POKERAI_API_KEY（または同等の X-API-Key）を送信します。このエンドポイントは1回の解析クォータを消費します。現在の無料プランでは、月25回のリアルタイム解析が利用できます。ダッシュボードで現在の使用状況を確認し、バッチ処理を設計する前にクォータのトピックをお読みください。

エラー

HTTP	意味	対応方法
401	`missing_api_key` または `invalid_api_key`。	有効な API キーヘッダーを1つ送信し、キーをクライアントログに残さないでください。
クォータ	該当する月間クォータを使い切った場合の `quota_exceeded`。	月次リセットを待つか、ワークロードを調整してください。変更していないリクエストを再試行しないでください。
422	無効な本文形式などにより、リクエストの検証に失敗しました。	現在のリファレンスまたは OpenAPI スキーマを確認し、入力を修正してください。

トレーニングおよびレビュー専用

Pokerai API は、トレーニング、コーチング、ハンドレビュー、学習、研究に使用してください。リアルマネーテーブルでのリアルタイム支援 (RTA) は禁止されています。エクイティ表示をライブテーブルの自動化から除外し、アクションの推奨に変換しないでください。

概要