← すべてのガイド
このページの内容
  1. ホーム
  2. ガイド
  3. APIからプリフロップ戦略を取得するには？
ガイド GTO戦略 · 06/06 レンジツール 12 分 初心者

APIからプリフロップ戦略を取得するには？

ヒーローの2枚のカード、ヒーローのポジション、ヒーロー以前のすべてのプリフロップアクションを指定して POST /v1/gto/preflop を呼び出します。Pokerai API がスポットを導出し、そのハンドの JSON 戦略分布を返します。

更新日 メンテナンス担当 Pokerai API

直接の回答: APIキーで認証し、hole_cards、positions.hero、完全なpreflop_actionsシーケンスを送信します。必要に応じてpreflop_versionを選択します。strategy内の各項目は、推奨アクションではなく頻度として読んでください。

基本情報

エンドポイントPOST /v1/gto/preflop
必須入力hole_cards、positions.hero、およびpreflop_actions
出力導出された situation、ミックスされた strategy[]、および現在の quota 使用量
クォータ各呼び出しで一般の事前解析済みルックアップを1回消費します。リアルタイム解析のクォータは使用しません
想定用途トレーニング、学習、コーチング、ハンドレビュー、研究 — リアルマネーRTAには決して使用しないでください

プリフロップリクエストを作成

アクションラインは明示的で順序付けられています。ブラインドのポストから始め、ヒーローより前のすべてのフォールド、コール、レイズを含め、ヒーローがアクションする前で終えてください。preflop_actions にヒーローを含めないでください。

フィールド送信する内容
hole_cardsちょうど2枚のカードを区切りなしの1つの文字列として指定します。例："AhKh"。
positions.hero現在の6-maxポジションセットにおけるヒーローの席: SB、BB、UTG、MP、CO、または BTN。
preflop_actionsヒーローより前の完全なアクションシーケンス。各項目には position と action があります。フォールド以外のアクションには、累計ではなく、新たに投入した BB 単位の amount が含まれます。
preflop_version任意のチャートセットID。プラットフォームのデフォルトを使用するにはこのパラメータを省略するか、GET /v1/gto/preflop/versions から返されるIDを使用します。

最小限の curl リクエスト

curl -s https://pokerai.bet/v1/gto/preflop \
  -H "Authorization: Bearer $POKERAI_API_KEY" -H "Content-Type: application/json" \
  -d '{"hole_cards":"AhKh","positions":{"hero":"MP"},"preflop_version":"6max_RC_100bb_200NL",
       "preflop_actions":[{"position":"SB","action":"small blind","amount":0.5},
                          {"position":"BB","action":"big blind","amount":1},
                          {"position":"UTG","action":"raise","amount":3}]}'

実際のレスポンスを読む

この取得済みのレスポンスは上記のリクエストに対応しています。ヒーローは MP で AhKh を持ち、UTG のオープンに直面しています。situation はアクションラインから導出され、quota はこのキーの月間使用量を報告します。

{"hole_cards": "AhKh", "situation": "Raise", "strategy": [{"action": "raise", "frequency": 1, "amount_bb": 9, "sizing_pot": 0.8}], "quota": {"used": 7, "limit": 100}}

ミックス頻度の仕組み

各 frequency は0から1までの確率で、通常、ハンドのアクション頻度の合計はおよそ1になります。上のレスポンスのように純粋戦略となるハンドもあれば、真にミックスされたハンドもあります。

たとえば、MPで2.5BBのUTGオープンに対する 9h9s の取得済みレスポンスでは、フォールド 0.254、コール 0.106、レイズ 0.64 が返されました。これはフォールド25.4%、コール10.6%、レイズ64%を意味します。API は分布を公開しますが、推奨アクションを約束または選択するものではありません。

amount_bb の意味

返されたレイズでは、amount_bb はビッグブラインド単位で示した、レイズ後の 絶対的な合計額 です。これはリクエストのアクション履歴内で使用する増分の amount ではありません。

ヒーローの前のレイズ回数導出されたスポットamount_bb
0オープン3
13ベット9
24ベット25
3回以上5ベット以上100（allin: true を伴う）

preflop_version を安全に選択

任意の preflop_version はプリフロップのチャートセットを選択し、同じスポットでもバージョンによって頻度が異なる場合があります。例では 6max_RC_100bb_200NL を使用しています。このフィールドを省略すると、プラットフォームのデフォルトが選択されます。

GET /v1/gto/preflop/versions を正式な情報源となる探索エンドポイントとして扱ってください。現在の ID、スタック深度、またはフォーマットが恒久的であると仮定せず、このエンドポイントが返す ID を使用してください。

クォータと再試行

プリフロップの検索は、一般の事前解析済みクォータを 1 消費します。レスポンスの quota.used と quota.limit には、その API キーの現在の月間カウンターが表示されます。使用量は ダッシュボード でも確認できます。

クォータを使い切ったリクエストを再試行しないでください。月次リセットを待つか、利用可能なクォータを変更してください。再試行ロジックは、API が文書化している一時的な失敗に限定してください。

よくあるエラー

HTTPエラー原因と対処法
400invalid_hole_cardshole_cards には有効なカードをちょうど 2 枚送信してください。
400invalid_positions / invalid_actionsドキュメントに記載されたヒーローのポジションと、ブラインドのポストから始まる完全で有効なアクションシーケンスを使用してください。
400unsupported_preflop_versionGET /v1/gto/preflop/versions を再取得し、返された ID のいずれかを渡してください。
401missing_api_key / invalid_api_keyAuthorization: Bearer ヘッダーで有効な API キーを送信してください。
404no_solution要求されたスポットには事前解析済みデータがありません。変更せずに再試行するのではなく、スポットを確認または変更してください。
429quota_exceeded月間の一般クォータを使い切っています。直ちに再試行しても解決しません。

使用する場合と使用しない場合

プリフロップ戦略の検索は、トレーナー、学習ツール、コーチングのワークフロー、ハンドレビューのキュー、研究、オフラインのエージェント分析で使用できます。レビューを再現可能にするため、返された頻度をバージョンおよび入力スポットとともに保存してください。

リアルマネーテーブルでのリアルタイム支援 (RTA) に Pokerai API を使用しないでください。また、ミックスされた出力を、ある一手が保証または推奨されているという主張に変換しないでください。リアルマネーテーブルでのリアルタイム支援 (RTA) は禁止されています。利用規約をご覧ください。

リアルマネーテーブルでのリアルタイム支援 (RTA) に Pokerai API を使用しないでください。また、ミックス出力を、ある一つのアクションが保証されている、または推奨されているという主張に変えないでください。リアルマネーでのリアルタイム支援 (RTA) は 利用規約 で禁止されています。

リファレンス、SDK、次のステップ