Gamma API

Polymarket Gamma API ay ang public REST API na naglalantad ng data sa antas ng market: markets, events, tags, series, at profiles. Ginagamit ito ng mga developer at trader para mag-lista ng mga market, kumuha ng metadata ng event, at bumuo ng mga index page o market directory nang walang authentication.

Key takeaways

• Ang Gamma API ay public at hindi nangangailangan ng authentication para sa reads. Gamitin ito para mag-lista ng markets, events, tags, series, at profiles.
• /markets ay may rate limit: 300 requests bawat 10 segundo. Ang pagination ay gumagamit ng cursor-based after_cursor (na-reject ang offset).
• Mga kapaki-pakinabang na query parameter: limit (max 1000), after_cursor, mga filtering array tulad ng slug o condition_ids, at mga boolean flag gaya ng closed o active.
• Pagsamahin nang maingat ang /markets at /events: ang combined listing limit ay 900 req / 10 s; ang overall API limit ay 4000 req / 10 s.

How the Gamma API is used

Ang Gamma API ang canonical public surface para sa display-oriented na data tungkol sa mga Polymarket markets. Tumatawag ang front-ends, aggregator, at research tools sa mga endpoint gaya ng /markets at /events para punuan ang mga market list, category page, at tag filter.

Important parameters and behaviors

• limit: Kinokontrol ang laki ng pahina. Default 20, maximum 1000.
• after_cursor: Cursor-based pagination; offset ay nire-reject na may HTTP 422—huwag gumamit ng offsets.
• Filtering: Ilang query param ang tumatanggap ng arrays (halimbawa slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Flags: closed (default false), active, at archived nagsi-filter ayon sa estado ng market.
• Ordering: Tumatanggap ang order parameter ng comma-separated na listahan ng field (halimbawa volume24hr,volume,liquidity,endDate), kasabay ng ascending (boolean).

Rate limits and practical guidance

• /markets specific limit: 300 requests bawat 10 segundo.
• Combined listing limit para sa /markets + /events: 900 requests bawat 10 segundo.
• Overall Gamma API surface: 4000 requests bawat 10 segundo.

Kung magplaplano ka ng high-throughput indexing, magpatupad ng exponential backoff at igalang ang cursor-based pagination pattern. I-cache ang mga listing kapag angkop; iwasang i-poll nang agresibo ang parehong resource.

Example request (curl)

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

In context on Polymarket

Gamma ay ang public, unauthenticated read API na tatawagin mo kapag kailangan mo ng market metadata para sa UI lists, tag pages, o integrations na hindi nangangailangan ng on-chain state (para sa on-chain positions at trades gamitin ang Data API; para sa order-book operations gamitin ang CLOB API). Dahil ang Gamma ay read-only at public, ito ang tamang lugar para bumuo ng market directories at exploratory tools.

See also

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

Closing note

Polymarket Gamma API ang unang hinto para sa market metadata. Gamitin ang dokumentadong mga parameter at igalang ang rate limits para maiwasan ang na-reject na requests.