Polymarket API ドキュメント：エンドポイント、レート制限、利用方法
「polymarket api docs」を検索してここに来たなら、Polymarket と統合・構築するために必要な正確なエンドポイント、認証モデル、実用的な制限を知りたいはずです。以下に、利用する三つの公開 REST API とマーケット WebSocket、主要パラメータ、レート制限を示します。さらに、CLOB がトレードに要求する要件と、PolyArb がこれらのサーフェスを使ってインラ・マーケット裁定を検出する方法も説明します。
公式 API エンドポイントとサーフェスマップ
Polymarket は三つの公開 REST サーフェスと一つのマーケット WebSocket を公開しています。マーケットとイベント向けの Gamma API は https://gamma-api.polymarket.com、ポジション・トレード・オープンインタレスト向けの Data API は https://data-api.polymarket.com、オーダーブックと取引向けの CLOB API は https://clob.polymarket.com です。リアルタイムのマーケットソケットは wss://ws-subscriptions-clob.polymarket.com/ws/market です。 各サーフェスには用途があります：Gamma は上場とフィルタリング、Data は履歴とオンチェーン由来のアクティビティ、CLOB はライブのオーダーブック読み取りと注文配置（読み取りは公開、取引は API key + HMAC が必要）です。WebSocket は接続ごとに最大 500 銘柄までの book と price-change イベントをストリームします。
Gamma /markets パラメータと制限
Gamma の /markets エンドポイントはキーセットページネーションをサポートします：前回の呼び出しで返された after_cursor を使ってください；offset は HTTP 422 で拒否されます。よく使うクエリパラメータには limit（最大 1000）、slug、id、condition_ids、clob_token_ids、question_ids、market_maker_address、closed、active、archived、order、ascending、tag_id などがあります。 レート制限：/markets は 10 秒あたり 300 リクエストに制限されています；/markets と /events の一覧呼び出しを組み合わせたものは 10 秒あたり 900 リクエストに制限されます。Gamma API 全体の許容量は 10 秒あたり 4000 リクエストです。
CLOB と取引のメカニクス
CLOB はオーダーブック、ミッドポイント、価格履歴、注文配置／キャンセルを公開します。取引には API key と HMAC が必要で、読み取りは公開です。Polymarket のティックサイズ、best_bid_ask イベント、そして FAK 市場注文ヘルパーは CLOB とマーケット WebSocket を通じて提供されます。 メイカー手数料はゼロで、テイカー手数料はカテゴリによって異なる点を忘れないでください。取引エージェントのルートを構築する場合は、アトリビューションとビルダーフィー報酬のために Polymarket の Builder Program を検討してください。
PolyArb がこれらの API をどう使うか
PolyArb は Gamma と CLOB のブックをポーリングし、マーケット WebSocket にサブスクライブして Σ bestAsk < $1.00 となるインラ・マーケット裁定の機会を検出します。ボットは低遅延インフラ（40ms プラン）で動作し、無料ボット（約 800ms）に先んじます。プランは $99/month で、取引ごとに $7.62 の最低保証エッジがあります。 ライブの best_bid_ask イベント、CLOB のミッドポイント、Data API の履歴を組み合わせて注文サイズを決め、部分約定を回避します。通常の運用リスクとしては、UMA を介した決着紛争、スリッページ、手数料の変更、決済タイミング、スマートコントラクトリスクがあることに注意してください。
今日から PolyArb で Polymarket を裁定取引しよう
月額 $99 の PolyArb に登録すれば、40ms のレイテンシ、Telegram と Discord のアラート、非カストディアルな実行、および取引ごとの $7.62 の最低保証エッジを利用できます。
FAQ
- 公式の Polymarket API ベース URL はどこですか？
- Gamma: https://gamma-api.polymarket.com；Data: https://data-api.polymarket.com；CLOB: https://clob.polymarket.com；WebSocket: wss://ws-subscriptions-clob.polymarket.com/ws/market。
- マーケットデータを読むのに認証は必要ですか？
- いいえ。Gamma、Data、公開 CLOB エンドポイントからの読み取りは認証不要です。CLOB で注文を出すには API key と HMAC が必要です。
- /markets の重要なレート制限は何ですか？
- /markets は 10 秒あたり 300 リクエストに制限されています。/markets と /events の一覧呼び出しを合わせたものは 10 秒あたり 900 リクエストに制限されています。Gamma API 全体の上限は 10 秒あたり 4000 リクエストです。
- リアルタイムのオーダーブック更新に WebSocket を使えますか？
- はい。マーケット WebSocket はリアルタイムの book、price_change、best_bid_ask、last_trade_price、tick_size_change イベントを提供します。10 秒ごとに ping を送り、接続ごとに最大 500 銘柄をサポートします。