PokerAI Cache APIで作る低遅延のリアルタイムポーカー分析ツール
保存済みの戦略が届いたら、すぐにアクション頻度を表示できます。実際の200NLの3ベットポットを使い、局面の検索からボードやアクションの切り替え、EVとエクイティの取得まで解説します。
/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です。
| ストリートとカード | アクション | 次の展開 |
|---|---|---|
| フロップ4♣ 8♦ 9♥ | SB 13 BB ベット MP コール | 次のカード A♠ |
| ターンA♠ | SB 14 BB ベット MP コール | 次のカード 7♦ |
| リバー7♦ | SB 22 BB ベット 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" を指定します。
- 1. 局面を探す
/cache/coverage一覧の取得は無料 - 2. 戦略を取得して表示
/cache/queryルートと新カードは各1回。通常のアクションは無料。 - 3. 必要な指標を取得
/cache/evまたは/cache/eq受付条件を満たしたリクエストは各1回
ルートノードの取得で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%)からコールまで進みます。
- チェック 23.53%
- ベット 6 BB 7.45%
- ベット 13 BB 69.02%
- オールイン 0.00%
- チェック 1.96%
- ベット 14 BB 77.65%
- ベット 31 BB 20.39%
- オールイン 0.00%
- チェック 88.63%
- ベット 22 BB 10.20%
- オールイン 1.18%
ベットやコールに進むときは、該当する子ノードのトークンを 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を取得すれば、待ち時間を切り分けられます。
| リクエスト | 所要時間 | 計測 | |
|---|---|---|---|
| フロップ4♣ 8♦ 9♥ | |||
| 戦略・ルート | 4.425秒 | A | |
| EV | 14.184秒 | A | |
| EQ | 8.566秒 | A | |
| ターンA♠ | |||
| 戦略・カード | 1.348秒 | B | |
| EV | 6.983秒 | B | |
| EQ | 6.482秒 | B | |
| リバー7♦ | |||
| 戦略・カード | 1.319秒 | C | |
| EV | 6.519秒 | B | |
| EQ | 6.827秒 | C | |
各バーは成功した公開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ベットポットを使い、両者のレンジを引き継いでターンとリバーの戦略を表示する流れを説明します。