Gamma API

Polymarket Gamma API は、マーケット単位のデータ（markets、events、tags、series、profiles）を公開するパブリックな REST API です。開発者やトレーダーは、認証なしでマーケットの一覧取得、イベントのメタデータ取得、インデックスページやマーケットディレクトリの構築にこの API を利用します。

Key takeaways

Gamma API はパブリックで読み取りに認証を必要としません。markets、events、tags、series、profiles の一覧取得に使用してください。
/markets はレート制限があります：10 秒あたり 300 リクエスト。ページネーションはカーソルベースの after_cursor（offset は拒否されます）を使用します。
便利なクエリパラメータは limit（最大 1000）、after_cursor、slug や condition_ids のようなフィルタ配列、closed や active といったブールフラグです。
/markets と /events を組み合わせる場合は注意してください：両方のリスティングの合計リミットは 10 秒あたり 900 req、API 全体では 10 秒あたり 4000 req です。

How the Gamma API is used

Gamma API は、Polymarket のマーケットに関する表示指向のデータを公開する標準的なパブリックサーフェスです。フロントエンド、アグリゲーター、調査ツールは /markets や /events のようなエンドポイントを呼び出して、マーケット一覧、カテゴリページ、タグフィルタを構築します。

Important parameters and behaviors

limit: ページサイズを制御します。デフォルトは 20、最大は 1000。
after_cursor: カーソルベースのページネーション。offset は HTTP 422 で拒否されます—オフセットは使用しないでください。
Filtering: 複数のクエリパラメータは配列を受け取ります（例：slug、id、condition_ids、clob_token_ids、question_ids、market_maker_address）。
Flags: closed（デフォルト false）、active、archived によってマーケットの状態でフィルタできます。
Ordering: order パラメータはカンマ区切りのフィールドリストを受け取ります（例：volume24hr,volume,liquidity,endDate）。ascending（ブール）と組み合わせて使用します。

Rate limits and practical guidance

/markets 固有のリミット：10 秒あたり 300 リクエスト。
/markets + /events の組み合わせリスティングリミット：10 秒あたり 900 リクエスト。
Gamma API 全体のサーフェス：10 秒あたり 4000 リクエスト。

高スループットでインデックスを行う場合は、指数バックオフを実装し、カーソルベースのページネーションを順守してください。リストは適宜キャッシュし、同じリソースを過度にポーリングするのは避けてください。

Example request (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

In context on Polymarket

Gamma は、UI のリスト、タグページ、オンチェーン状態を必要としない統合のためのマーケットメタデータを取得する際に利用する、公開かつ認証不要の読み取り API です（オンチェーンのポジションやトレードには Data API、オーダーブック操作には CLOB API を使用してください）。Gamma は読み取り専用でパブリックであるため、マーケットディレクトリや探索ツールを構築するのに適しています。

Gamma API

関連用語