API でポーカーレンジを処理するにはどうすればよいですか？

PokerKit レンジエンドポイントを使用して、ドキュメント化された表記を具体的なコンボに変換し、決定論的なレンジ特性を確認するか、明示的なモンテカルロ制御でレンジエクイティを推定します。タスクがドキュメント化されたソルバーのレンジワークフローである場合は、GTO レンジエンドポイントを使用してください。

更新日 2026年7月26日管理者 Pokerai API

直接の回答：表記を展開するには POST /v1/pokerkit/range/expand を使用します。決定論的なボードベースのレンジ分析には /range/value と /range/nut-advantage を、モンテカルロ法によるエクイティシェアの推定が必要な場合は /range/equity-advantage を使用します。ソルバー由来のレンジには、公開されている /v1/gto/range、/v1/gto/flop/projected-range、または /v1/gto/turn/projected-range の契約を使用します。

早見情報

表記法	`["AA", "KQs"]` などの PokerKit レンジ表記配列。expand は具体的な 2 枚カードのコンボを返します。
決定論的	`range/expand`、`range/value`、および `range/nut-advantage` はモンテカルロ・サンプリングを使用しません。
モンテカルロ	`range/equity-advantage` は文書化された `sample_count` と `seed` を受け付けます。シードにより再現可能なサンプリングをサポートします。
クォータ	決定論的な PokerKit レンジエンドポイントは一般クォータを 1 消費します。`range/equity-advantage` は解析クォータを 1 消費します。
GTOレンジ	GTOレンジエンドポイントは別個のソルバーワークフローです。現在のリクエストおよびレスポンスのスキーマは、リファレンスまたはOpenAPIスナップショットで確認してください。
利用範囲	トレーニング、コーチング、ハンドレビュー、学習、研究向け。リアルマネーでのリアルタイム支援ではありません。

レンジ表記

表記文字列の JSON 配列を渡します。AA はポケットペアのハンドクラス、KQs はスーテッドのキング・クイーンを表します。expand レスポンスには具体的なカードペアが列挙されます。結果を解釈可能な状態に保つため、表記、ボード、プレイヤー順序を保存済みのレビュー入力とともに保持してください。

最小限の検証済みリクエストとレスポンス

この公開ドキュメントのコード例では POST /v1/pokerkit/range/expand を呼び出します。API キーは Authorization: Bearer $POKERAI_API_KEY で送信し、コンテンツタイプを JSON に設定してください。

{"notation": ["AA", "KQs"]}

{"result": [["Ac", "Ad"], ["Ac", "Ah"], ["Ac", "As"], ["Ad", "Ah"], ["Ad", "As"], ["Ah", "As"], ["Kc", "Qc"], ["Kd", "Qd"], ["Kh", "Qh"], ["Ks", "Qs"]]}

各内部配列は 1 つの具体的な 2 枚カードのコンボです。このレスポンスは指定された表記を説明するものであり、GTO アクションの推奨ではありません。

レンジ操作を選ぶ

目的	公開エンドポイント	方法
表記を展開	`POST /v1/pokerkit/range/expand`	決定論的なコンボ展開。
ボード上のバリューレンジを構築	`POST /v1/pokerkit/range/value`	決定論的なメイドカテゴリの下限。使用するのは `aggression` または `floor`。
ナッツシェアを比較	`POST /v1/pokerkit/range/nut-advantage`	決定論的なコンボ数によるナッツシェアの分割。
エクイティシェアを比較	`POST /v1/pokerkit/range/equity-advantage`	指定された 2 つのレンジに対するモンテカルロ推定。`sample_count` と `seed` は、ドキュメントで説明されているとおりにのみ使用してください。
ソルバーのレンジを進行	`POST /v1/gto/range`、`/flop/projected-range`、または `/turn/projected-range`	指定されたソルバーワークフロー向けの公開済み GTO レンジ契約。

決定論的処理とモンテカルロ

expand、value、または nut-advantage の結果をシミュレーションと表記しないでください。これらの操作は指定された入力に対して決定論的です。equity-advantage は異なり、モンテカルロ方式のため、その結果は送信されたレンジとボードに対する推定値です。固定の seed によりサンプリングは再現可能になりますが、常に正確になるわけではありません。結果を提示する際は、返された sample_count を保持してください。

クォータとエラー

シグナル	意味	対応方法
401	`missing_api_key` または `invalid_api_key`。	有効な API キーヘッダーを送信してください。クライアントログに公開しないでください。
429	`quota_exceeded` は該当する月次カウンターを使い切った場合に発生します。	リセットを待つか作業量を減らしてください。変更されていないリクエストを再試行しないでください。
422	リクエストのバリデーションに失敗しました。	エンドポイントの最新のリファレンスまたは OpenAPI スキーマを確認し、ボディを修正してください。

現在のカウンターはクォータのドキュメントとダッシュボードで確認してください。GTO レンジエンドポイントは、独自に文書化されたクォータ動作に従います。

トレーニングとレビュー専用

Pokerai API はトレーニング、コーチング、ハンドレビュー、学習、研究に使用してください。リアルマネーテーブルでのリアルタイム支援 (RTA) は禁止されています。レンジ解析をライブテーブルの自動化に接続したり、ライブアクションの指示として提示したりしないでください。