Gamma API

Polymarket Gamma API ialah REST API awam yang mendedahkan data peringkat-pasaran: pasaran, acara, tag, siri, dan profil. Pembangun dan pedagang menggunakannya untuk menyenaraikan pasaran, mengambil metadata acara, dan membina halaman indeks atau direktori pasaran tanpa pengesahan.

Perkara penting

• Gamma API adalah awam dan tidak memerlukan pengesahan untuk bacaan. Gunakannya untuk menyenaraikan pasaran, acara, tag, siri, dan profil.
• /markets mempunyai had kadar: 300 permintaan setiap 10 saat. Paginasi menggunakan after_cursor berasaskan kursor (offset ditolak).
• Parameter pertanyaan berguna termasuk limit (maks 1000), after_cursor, penapisan array seperti slug atau condition_ids, dan penanda boolean seperti closed atau active.
• Gabungkan /markets dan /events dengan berhati-hati: had gabungan senarai ialah 900 req / 10 s; had keseluruhan API ialah 4000 req / 10 s.

Bagaimana Gamma API digunakan

Gamma API ialah permukaan awam piawai untuk data berorientasikan paparan tentang pasaran Polymarket. Antaramuka hadapan, pengagregat, dan alat penyelidikan memanggil titik hujung seperti /markets dan /events untuk mengisi senarai pasaran, halaman kategori, dan penapis tag.

Parameter dan kelakuan penting

• limit: Mengawal saiz halaman. Lalai 20, maksimum 1000.
• after_cursor: Paginasi berasaskan kursor; offset ditolak dengan HTTP 422—jangan gunakan offset.
• Penapisan: Beberapa param query menerima array (contohnya slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Penanda: closed (lalai false), active, dan archived menapis mengikut keadaan pasaran.
• Pengurutan: Parameter order menerima senarai medan yang dipisahkan koma (contohnya volume24hr,volume,liquidity,endDate), dipadankan dengan ascending (boolean).

Had kadar dan panduan praktikal

• Had khusus /markets: 300 permintaan setiap 10 saat.
• Had gabungan untuk senarai /markets + /events: 900 permintaan setiap 10 saat.
• Permukaan Gamma API keseluruhan: 4000 permintaan setiap 10 saat.

Jika anda merancang pengindeksan berkeluaran-tinggi, laksanakan exponential backoff dan hormati corak paginasi berasaskan kursor. Cache senarai bila wajar; elakkan menyoal sumber yang sama secara agresif.

Contoh permintaan (curl)

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

Dalam konteks di Polymarket

Gamma ialah API bacaan awam dan tidak diautentikasi yang akan anda hubungi apabila anda memerlukan metadata pasaran untuk senarai UI, halaman tag, atau integrasi yang tidak memerlukan keadaan on-chain (untuk posisi dan perdagangan on-chain gunakan Data API; untuk operasi buku pesanan gunakan CLOB API). Kerana Gamma bersifat hanya-baca dan awam, ia adalah tempat yang sesuai untuk membina direktori pasaran dan alat eksploratori.

Lihat juga

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

Nota penutup

Polymarket Gamma API ialah hentian pertama untuk metadata pasaran. Gunakan parameter yang didokumenkan dan hormati had kadar untuk mengelakkan permintaan ditolak.