回答 · 制限 · プラン
オッズAPIのプラン別レート制限
回答： RESTはキーごとのトークンバケット方式で、WebSocket接続数はアカウント単位で数えられます。上限を超えると、分かりやすいコード付きの 429 が返ります。
| プラン | REST | 1日の上限 | WebSocket |
|---|---|---|---|
| Free | 毎秒1 | 1,000件（00:00 UTCにリセット） | なし |
| Hobby | 毎秒2 | なし | なし |
| Builder | 毎秒10 | なし | 3接続 |
| Pro | 毎秒30 | なし | 10接続 |
429の中身#
| コード | 原因 | 対処 |
|---|---|---|
rate_limited | 1秒あたりのリクエストが多すぎる | Retry-After ヘッダーの秒数だけ待つ（本文の retryAfterMs も参照） |
daily_quota | Freeの1,000件を使い切った | 00:00 UTCまで待つか、プランを変更 |
connection_limit | WebSocketの同時接続が多すぎる | 1本閉じるか、Proへ |
実践のヒント#
- ライブのダッシュボードにはBuilderのWebSocketを使えば、ポーリングは不要です。
GET /v1/accountで上限とusage.restRequestsTodayを確認できます。- MCPツールの呼び出しは1回ごとにRESTリクエスト1件として数えられます。
- 詳細：制限。
WebSocketとクロージング履歴ならBuilder（月額99ユーロ）。3日間のトライアルにはカード登録が必要で、解約しない場合は3日目の後に課金されます。無料のREST：登録。
18歳以上の方を対象とした教育目的のコンテンツです。
よくある質問#
WebSocketのメッセージにもRESTのような制限はありますか？#
制限されるのは接続数です。メッセージ量はフィルター次第です。処理が遅いクライアントには 4008 slow_consumer が送られます。
制限はキー単位ですか、アカウント単位ですか？#
RESTの毎秒の上限はキー単位、WebSocket接続数と選択した競技はアカウント単位です。
MCPはRESTとして数えられますか？#
はい。ツール呼び出し1回がRESTリクエスト1件です。