最初の GTO ポーカー API リクエストを行うにはどうすればよいですか？

クイック情報

このクイックスタートを使う場合

認証の確認、レスポンス形式の確認、またはトレーナー、学習ツール、ハンドレビューのワークフロー、バックエンドサービス、AIエージェント統合の開始に使用します。

使用しない場合

実戦のリアルマネープレイ中に、このエンドポイントをライブの助言として使用しないでください。カスタムのフロップ、ターン、またはリバーのツリーについては、このプリフロップ検索を一般的なポストフロップソルバーとして扱うのではなく、開発者向けドキュメントにあるリアルタイムソルバーのワークフローに従ってください。

最小限のcurlリクエスト

キーを作成し、POKERAI_API_KEYとしてローカルに保存してから、このリクエストを実行します。本物のキーをコミットしたり、クライアント側のコードに記載したりしないでください。

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

実際のレスポンス

この取得済みレスポンスは、UTGが2.5bbでオープンした後にMPが9h9sを持っている場合のものです：

{
  "hole_cards": "9h9s",
  "situation": "Raise",
  "strategy": [
    { "action": "fold", "frequency": 0.254 },
    { "action": "call", "frequency": 0.106 },
    { "action": "raise", "frequency": 0.64, "amount_bb": 9, "sizing_pot": 1 }
  ]
}

3つの頻度の合計は1です: フォールド 25.4%、コール 10.6%、9bbへのレイズ 64%。これは学習またはサンプリングのための分布として扱い、1つのアクションが勝つことを保証するものではありません。

割り当て

Pokerai APIでは、事前解析済みのルックアップとリアルタイム解析を別々に計測します。このプリフロップリクエストでは、事前解析済みのルックアップを1件使用します。無料プランには月あたり事前解析済みルックアップ1,000件とリアルタイム解析25件が含まれます。両方のカウンターは毎月リセットされ、現在の使用量はダッシュボードに表示されます。現在の公開上限については料金を参照してください。

よくあるエラー

このエンドポイントの公開OpenAPI契約では、以下の非成功レスポンスが定義されています：

SDKとMCPの選択肢

公式クライアントは同じ公開OpenAPI 契約に従い、同じ API キーとクォータを使用します。完全な型付きの例はSDK ドキュメントにあります。

• Python SDK：pip install pokerai-bet（pokeraiとしてインポート）。
• TypeScript / JavaScript SDK: npm install @pokerai/client.
• AIエージェント向けMCPサーバー: npx @pokerai/mcp。事前解析済みツールはデフォルトで有効です。ソルバーツールを有効にすると、別枠の解析割り当てが消費されます。

リアルマネーRTAは禁止