← すべてのガイド
このページの内容
ガイド GTO戦略 · 01/08 ソルバーアプリ 10 分 中級

PokerAI Cache APIで作る低遅延のリアルタイムポーカー分析ツール

保存済みの戦略が届いたら、すぐにアクション頻度を表示できます。実際の200NLの3ベットポットを使い、局面の検索からボードやアクションの切り替え、EVとエクイティの取得まで解説します。

更新 保守担当者 Pokerai API

/cache/query の応答が届いたら戦略を表示します。EVやエクイティのパネルを開いたときに /cache/ev または /cache/eq を呼び出せば、指標を待つ間も戦略を確認できます。

Cache API が適している場面

3ストリートの戦略をすぐに表示したいときに使う方法です。全ストリートの計算済みデータがある局面では、フロップ、ターン、リバーを1本のポストフロップゲーム木でまとめて解きます。ボードやアクションを切り替えても同じ解のノードを読むため、ストリート間の均衡の整合性が保たれます。ナッシュ均衡の近似は、元のレンジ、スタック、ベットツリーと計算精度の範囲内で得られたものです。

戦略と個別のEV・エクイティを取得できるのはBuilderまたはProです。有効なAPIキーがあれば、カバレッジは無料で確認できます。現在のキャッシュは一部の局面を対象とします。一覧は利用可能なルートを示し、個別のアクションやカードの可否は戦略レスポンスで確認します。

200NLの3ベットポットの基本情報

プリフロップパックは 6max_RC_100bb_200NL です。MPがオープンし、SBが A♥K♥ で3ベットします。フロップは 4♣8♦9♥。ポットは19 BB、残りの実効スタックは91 BBです。

3ストリートのベットライン
ストリートとカードアクション次の展開
フロップ4♣ 8♦ 9♥SB 13 BB ベット
MP コール
次のカード A♠
ターンA♠SB 14 BB ベット
MP コール
次のカード 7♦
リバー7♦SB 22 BB ベット
MP コール
ショーダウン
図1。各ストリートでMPがコールし、ショーダウンまで進みます。

SBが13、14、22 BBとベットし、MPが各ストリートでコールするラインをたどります。リバーでA♥K♥はチェックが主流ですが、ここでは22 BBベットの分岐からショーダウンまで進みます。

保存済みの局面を探す

/cache/coverage にプリフロップパックとフロップを送ると、戦略が保存されている局面を調べられます。有効なAPIキーがあれば、presolved、solve、cacheのいずれの利用枠も消費せずに参照できます。

curl -G 'https://pokerai.bet/v1/gto/postflop/cache/coverage' \
  -H "Authorization: Bearer $POKERAI_API_KEY" \
  --data-urlencode 'preflop_pack=6max_RC_100bb_200NL' \
  --data-urlencode 'board=4c8d9h' \
  --data-urlencode 'limit=200'

preflop_pack と board は必須です。このハンドでは、一覧に次の項目が含まれていました。一覧の応答を含む実測データ

{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"raiser": "MP", "three_bettor": "SB", "hero": "SB"}
}

「MPオープン・SB 3ベット」が選ばれたら、返された各フィールドを使ってルートノードを取得します。ページを送るときはパックとフロップを変えず、next_cursor をそのまま cursor に指定します。items が空でもカーソルがあれば次へ進み、next_cursor: null で終了します。該当局面がなければその旨を表示し、その場でソルブするかどうかはユーザーに選んでもらいます。

フロップ戦略を表示する

APIキーはバックエンドで管理し、/cache/query もサーバーから呼び出します。A♥K♥の戦略には hole_cards: "AhKh" を指定します。

Cache APIの利用手順
  1. 1. 局面を探す/cache/coverage一覧の取得は無料
  2. 2. 戦略を取得して表示/cache/queryルートと新カードは各1回。通常のアクションは無料。
  3. 3. 必要な指標を取得/cache/ev または /cache/eq受付条件を満たしたリクエストは各1回
図2。局面を選び、戦略を表示します。指標パネルを開いたらEVまたはEQを取得します。

ルートノードの取得でcache利用枠を1回分消費します。

POST /v1/gto/postflop/cache/query
{
  "preflop_pack": "6max_RC_100bb_200NL",
  "board": "4c8d9h",
  "pot_type": "3BET",
  "positions": {"hero": "SB", "raiser": "MP", "three_bettor": "SB"},
  "hole_cards": "AhKh"
}

応答の strategy をアクション頻度として表示し、token を保存します。応答の node: "root" は画面上の経路表示に使えます。次のリクエストでは、進みたいノードのトークンを node に指定します。レンジ全体の行列を取得済みなら、ハンド変更時は該当行を表示できます。アクションノードやボードが変わったときに改めて取得します。

アクションをたどってターンとリバーへ

フロップでSBがA♥K♥を使って13 BBをベットする頻度は約 69.02% です。MPがコールしてA♠が落ちると、14 BBのベットが 77.65%。MPがもう一度コールし、7♦が落ちると、SBは 88.63% チェックします。ここでは22 BBベット(10.20%)からコールまで進みます。

A♥K♥のアクション頻度
フロップ 4♣ 8♦ 9♥
  • チェック 23.53%
  • ベット 6 BB 7.45%
  • ベット 13 BB 69.02%
  • オールイン 0.00%
ターン A♠
  • チェック 1.96%
  • ベット 14 BB 77.65%
  • ベット 31 BB 20.39%
  • オールイン 0.00%
リバー 7♦
  • チェック 88.63%
  • ベット 22 BB 10.20%
  • オールイン 1.18%
図3。各ストリートの頻度は前述の経路に沿っています。割合は正規化して丸めています。元の値は実測記録を参照してください。

ベットやコールに進むときは、該当する子ノードのトークンを node に指定します。chance ノードでは、そのトークンと turn_card または river_card を送ります。以下の query は /cache/query を呼び出す関数です。認証とエラー処理を含むNode.jsサンプル

const opponent = await query("flop-bet", {
  node: cachedAction(flop, "bet", 13),
});
const chance = await query("flop-call", {
  node: cachedAction(opponent, "call"),
});
const turn = await query("turn-deal", {
  node: chance.token,
  turn_card: "As",
  hole_cards: "AhKh",
});

有効なトークンでベットやコールをたどるリクエストは無料です。ターンやリバーの新しいカードを指定するたび、cache利用枠を1回分消費します。経路を残しておけば、ユーザーは確認済みのノードに戻れます。

必要なときだけEVとエクイティを取得する

/cache/ev はアクションの期待値を、/cache/eq はハンドのエクイティを返します。各エンドポイントには現在の action ノードのトークンと具体的なハンドを渡します。パック、ボード、レンジはトークンから決まります。

const hand = { node: flop.token, hole_cards: "AhKh" };

const ev = await http("flop-ev", "/v1/gto/postflop/cache/ev", hand);
const actionValues = ev.ev.status === "ok" ? ev.ev.action_values : null;

const eq = await http("flop-eq", "/v1/gto/postflop/cache/eq", hand);
const equityPercent = eq.eq.status === "ok" ? eq.eq.value * 100 : null;

/cache/query は戦略を返します。旧パラメーターの include_ev:true や include_eq:true は HTTP 400 になり、利用枠の消費も計算の開始もありません。省略するか、旧クライアントであれば false のままにします。

EVは保存済みの戦略に従った純期待値で、単位はBBです。EQは現在のボードと、保存済みフロップのルートでの相手レンジを使います。このレンジはアクションを進めても固定です。

ノードと直前までのアクション A♥K♥のEV EQ
フロップ 4♣8♦9♥(先行計測) −6.4512 BB 44.5677%
ターン A♠(13 BBベット、コール) 18.8904 BB 83.2143%
リバー 7♦(続けて14 BBベット、コール) 5.3115 BB 73.4660%(再検証)

同じノードでアクションごとのEVを比べるには、応答の action_values を使います。実測した指標の応答

応答時間と利用枠

同じフロップ計測で、戦略は 4.425秒、EVは 14.184秒、EQは 8.566秒 で返りました。リバーの再検証では、カードを指定してから戦略が 1.319秒、EQが 6.827秒 でした。頻度を先に表示し、指標パネルを開いた時点でEVまたはEQを取得すれば、待ち時間を切り分けられます。

ストリート別の応答時間 200NLのベットライン・共通の秒目盛り
リクエスト所要時間計測
フロップ4♣ 8♦ 9♥
戦略・ルート4.425秒A
EV14.184秒A
EQ8.566秒A
ターンA♠
戦略・カード1.348秒B
EV6.983秒B
EQ6.482秒B
リバー7♦
戦略・カード1.319秒C
EV6.519秒B
EQ6.827秒C
同じ文字は同じ計測回・11月18日香港時間 A フロップのルート、13:37–13:38 B ベットライン、17:44–17:45 C リバーEQ再検証、20:52
図4。公開HTTPSリクエストの送信から応答を読み終えるまで。リバーのEVとEQは別の回の計測です。 計測記録を見る。

各バーは成功した公開HTTPSリクエスト1件を表し、計測は応答を読み終えるまでです。所要時間はノードやサービスの状態で変わります。

API操作 cache利用枠の消費
/cache/coverage で一覧を参照 0
/cache/query でルートノードを取得 1回分
有効なトークンで通常のアクションをたどる 0
/cache/query で新しいターン・リバーカードを指定 1件につき1回分
受付条件を満たした独立のEVまたはEQリクエスト 1件につき1回分

3ストリートの戦略を読むと3回分消費します。 各ストリートでEVとEQも取得する場合は合計9回分です。リバーの再検証はEQを1件だけ取得して計4回分。直前のターンのコールは 1.317秒 で、消費はゼロでした。

不正な入力、期限切れトークンなど、受付前に拒否されたリクエストでは利用枠を消費しません。消費後にエラーが返ることもあります。cache_quota があれば確認し、自動再試行は避けてください。再送は新しいリクエストになります。

サンプルを動かす

ポジション、ハンド、ボード、アクション履歴をまとめて管理します。EVとEQに個別の読み込み状態とエラー表示を持たせると、指標が取得できない場合にも戦略を表示できます。

Node.jsサンプルをダウンロード。局面を探し、3回のベットとコールを経てショーダウンまで進んだ後、各ストリートのEVとEQを取得します。一覧が1ページで、すべて成功した場合は16リクエスト、9回分を消費します。

本番で動かすにはBuilderまたはProのAPIキーが必要で、そのアカウントの利用枠を使います。エラーが出ると停止し、それまでに出力した結果は残ります。

export POKERAI_API_KEY='YOUR_SERVER_API_KEY'
node reproduce.mjs

本番計測データと引用方法

計測日は 2026年11月18日 です。最初の収録では13件が成功し、リバーEQの1件がHTTP 503でした。再検証は同じラインを新しいトークンでたどり、8件すべてが成功しました。フロップのルート、新しいカード2枚、リバーEQでそれぞれ1回分を消費しました。

引用する際は、パック、ボード、アクション経路、日付、計測方法を添えてください。所要時間は個々のリクエストの実測値です。この手順はトレーニング、研究、プレー後のレビュー向けです。リアルマネーの卓でのリアルタイム支援は禁止されています。

APIドキュメント · APIリファレンス · OpenAPI · llms.txt

キャッシュが見つからない場合、Free・Starterを使っている場合、後続ストリートのレンジやサイズを変えたい場合は、計算済みのフロップを先に表示し、残りを必要に応じて解きます。

計算済みデータとリアルタイムソルバーで作る低遅延のポーカー分析。続編では、同じ200NLの3ベットポットを使い、両者のレンジを引き継いでターンとリバーの戦略を表示する流れを説明します。