レート制限

定義

API のレート制限は、ある時間ウィンドウ内に API が受け付けるリクエスト数の上限です。制限を超えたクライアントはエラーを受け取るか、ウィンドウがリセットされるまで一時的にブロックされます。レート制限はサーバーの過負荷を防ぎ、クライアント間での公平な利用を確保し、サービス品質を保つ役割を果たします。

コンテキスト

Polymarket では Gamma サーフェスが /markets のような公開 REST エンドポイントを提供しています。そのエンドポイントは具体的に「10 秒あたり 300 リクエスト」を許容します。/markets と /events の組み合わせによるリスティング使用は、より大きな合算制限（10 秒あたり 900 リクエスト）があります。これらの制限を超えると、該当するウィンドウが切れるまで API が追加リクエストを拒否するため、ページネーションやポーリング間隔はそれを踏まえて設計してください。

実用的なヒント

• /markets を効率的にページングするには offset の代わりにキーセットページネーション（after_cursor）を使ってください。
• 可能な限りリクエストをバッチ化し、短いポーリングループは避けてください。制限に達したら適切なバックオフを取ることを優先してください。
• ワークフローがわずかに古いデータを許容できるなら、短時間だけ繰り返し応答をキャッシュしてください。

関連項目

• gamma-api