LIVE
keunggulan minimum $7,62 per perdagangan
Dapatkan bot
PolyArb

Definisi

Gamma API

Polymarket's public REST API untuk markets, events, tags, dan series.

Gamma API

Polymarket Gamma API adalah REST API publik yang menyediakan data tingkat pasar: markets, events, tags, series, dan profiles. Developer dan trader menggunakannya untuk membuat daftar markets, mengambil metadata event, dan membangun halaman indeks atau direktori pasar tanpa autentikasi.

Inti yang perlu diketahui

  • Gamma API bersifat publik dan tidak memerlukan autentikasi untuk operasi baca. Gunakan untuk membuat daftar markets, events, tags, series, dan profiles.
  • /markets dibatasi oleh rate limit: 300 request per 10 detik. Paginasi menggunakan cursor-based after_cursor (offset ditolak).
  • Parameter kueri berguna termasuk limit (maks 1000), after_cursor, filter array seperti slug atau condition_ids, dan flag boolean seperti closed atau active.
  • Gabungkan /markets dan /events dengan hati-hati: batas gabungan untuk listing adalah 900 req / 10 s; batas seluruh API adalah 4000 req / 10 s.

Bagaimana Gamma API digunakan

Gamma API adalah surface publik kanonis untuk data yang ditujukan untuk tampilan tentang markets Polymarket. Front-end, aggregator, dan alat riset memanggil endpoint seperti /markets dan /events untuk mengisi daftar market, halaman kategori, dan filter tag.

Parameter dan perilaku penting

  • limit: Mengontrol ukuran halaman. Default 20, maksimum 1000.
  • after_cursor: Paginasi berbasis cursor; offset ditolak dengan HTTP 422—jangan gunakan offset.
  • Filtering: Beberapa query param menerima array (misalnya slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
  • Flags: closed (default false), active, dan archived menyaring berdasarkan status market.
  • Ordering: Parameter order menerima daftar field dipisah koma (misalnya volume24hr,volume,liquidity,endDate), dipasangkan dengan ascending (boolean).

Rate limits dan panduan praktis

  • Batas khusus /markets: 300 request per 10 detik.
  • Batas listing gabungan untuk /markets + /events: 900 request per 10 detik.
  • Seluruh surface Gamma API: 4000 request per 10 detik.

Jika Anda merencanakan pengindeksan throughput tinggi, terapkan exponential backoff dan patuhi pola paginasi berbasis cursor. Cache listing bila sesuai; hindari polling resource yang sama secara agresif.

Contoh permintaan (curl)

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

Dalam konteks Polymarket

Gamma adalah API baca publik dan tanpa autentikasi yang akan Anda panggil ketika membutuhkan metadata market untuk daftar UI, halaman tag, atau integrasi yang tidak memerlukan state on-chain (untuk posisi dan trade on-chain gunakan Data API; untuk operasi order-book gunakan CLOB API). Karena Gamma bersifat read-only dan publik, ini adalah tempat yang tepat untuk membangun direktori market dan alat eksplorasi.

Lihat juga

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

Catatan penutup

Polymarket Gamma API adalah titik awal untuk metadata market. Gunakan parameter yang didokumentasikan dan patuhi rate limits untuk menghindari request yang ditolak.

Istilah terkait