Gamma API

Polymarket Gamma API is the public REST API that exposes market-level data: markets, events, tags, series, and profiles. Developers and traders use it to list markets, fetch event metadata, and build index pages or market directories without authentication.

Key takeaways

• The Gamma API is public and requires no authentication for reads. Use it to list markets, events, tags, series, and profiles.
• /markets is rate-limited: 300 requests per 10 seconds. Pagination uses cursor-based after_cursor (offset is rejected).
• Useful query parameters include limit (max 1000), after_cursor, filtering arrays like slug or condition_ids, and boolean flags such as closed or active.
• Combine /markets and /events carefully: the listing combined limit is 900 req / 10 s; the overall API limit is 4000 req / 10 s.

How the Gamma API is used

The Gamma API is the canonical public surface for display-oriented data about Polymarket markets. Front-ends, aggregators, and research tools call endpoints such as /markets and /events to populate market lists, category pages, and tag filters.

Important parameters and behaviors

• limit: Controls page size. Defaults to 20, maximum 1000.
• after_cursor: Cursor-based pagination; offset is rejected with HTTP 422—do not use offsets.
• Filtering: Several query params accept arrays (for example slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Flags: closed (default false), active, and archived filter by market state.
• Ordering: The order parameter accepts a comma-separated field list (for example volume24hr,volume,liquidity,endDate), paired with ascending (boolean).

Rate limits and practical guidance

• /markets specific limit: 300 requests per 10 seconds.
• Combined listing limit for /markets + /events: 900 requests per 10 seconds.
• Overall Gamma API surface: 4000 requests per 10 seconds.

If you plan high-throughput indexing, implement exponential backoff and respect the cursor-based pagination pattern. Cache listings when appropriate; avoid polling the same resource aggressively.

Example request (curl)

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

In context on Polymarket

Gamma is the public, unauthenticated read API you will hit when you need market metadata for UI lists, tag pages, or integrations that do not require on-chain state (for on-chain positions and trades use the Data API; for order-book operations use the CLOB API). Because Gamma is read-only and public, it is the right place to build market directories and exploratory tools.

See also

• /glossary/data-api
• /glossary/clob-api

Closing note

Polymarket Gamma API is the first stop for market metadata. Use the documented parameters and respect rate limits to avoid rejected requests.