Dokumen API Polymarket: endpoint, batas laju, dan penggunaan
Jika Anda mencari "polymarket api docs", Anda menginginkan endpoint yang tepat, model otentikasi, dan batas praktis untuk membangun atau mengintegrasikan dengan Polymarket. Di bawah ini ada tiga REST API publik dan WebSocket pasar yang akan Anda gunakan, serta parameter kunci dan batas laju. Saya juga membahas apa yang diperlukan CLOB untuk trading dan bagaimana PolyArb memanfaatkan permukaan ini untuk menemukan arbitrase intra-market.
Endpoint resmi API dan peta permukaan
Polymarket menyediakan tiga permukaan REST publik dan satu WebSocket pasar. Gamma API untuk markets dan events berada di https://gamma-api.polymarket.com. Data API untuk positions, trades, dan open interest berada di https://data-api.polymarket.com. CLOB API untuk order book dan trading berada di https://clob.polymarket.com. Socket pasar real-time berada di wss://ws-subscriptions-clob.polymarket.com/ws/market. Setiap permukaan memiliki tujuan: Gamma untuk listing dan filter, Data untuk aktivitas historis dan turunan on-chain, CLOB untuk pembacaan order-book langsung dan penempatan order (pembacaan bersifat publik; trading membutuhkan API key + HMAC). WebSocket men-stream event buku dan perubahan harga untuk hingga 500 instrumen per koneksi.
Parameter dan batas Gamma /markets
Endpoint /markets Gamma mendukung pagination keyset: gunakan after_cursor yang dikembalikan oleh panggilan sebelumnya; offset ditolak dengan HTTP 422. Parameter query yang berguna termasuk limit (maks 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending, dan tag_id. Batas laju: /markets dibatasi hingga 300 permintaan per 10 detik; panggilan listing gabungan /markets + /events dibatasi hingga 900 permintaan per 10 detik. Izin keseluruhan API Gamma adalah 4000 permintaan per 10 detik.
CLOB dan mekanika trading
CLOB mengekspos order book, midpoint, riwayat harga, serta penempatan/pembatalan order. Trading membutuhkan API key ditambah HMAC; pembacaan bersifat publik. Tick size Polymarket, event best_bid_ask, dan helper order pasar FAK tersedia melalui CLOB dan WebSocket pasar. Ingat bahwa maker fee nol dan taker fee bervariasi menurut kategori. Jika Anda membangun agen trading yang melakukan routing, pertimbangkan Builder Program Polymarket untuk atribusi dan reward builder-fee.
Bagaimana PolyArb menggunakan API ini
PolyArb mem-poll Gamma dan buku CLOB serta berlangganan WebSocket pasar untuk mendeteksi peluang arbitrase intra-market di mana Σ bestAsk < $1.00. Bot kami berjalan di infrastruktur latensi rendah (paket 40ms) untuk mengalahkan bot gratis (~800ms), dengan paket $99/month dan edge minimum terjamin $7.62 per trade. Kami menggabungkan event best_bid_ask langsung, midpoint CLOB, dan riwayat API Data untuk menentukan ukuran order dan menghindari partial fills. Perhatikan risiko operasional biasa: sengketa resolusi melalui UMA, slippage, perubahan fee, waktu penyelesaian, dan risiko smart-contract.
Mulai arbitrase Polymarket dengan PolyArb hari ini
Berlangganan PolyArb seharga $99/month untuk mendapatkan latensi 40ms, notifikasi Telegram dan Discord, eksekusi non-kustodian, dan edge minimum terjamin $7.62 per trade.
FAQ
- Di mana URL dasar resmi API Polymarket?
- Gamma: https://gamma-api.polymarket.com; Data: https://data-api.polymarket.com; CLOB: https://clob.polymarket.com; WebSocket: wss://ws-subscriptions-clob.polymarket.com/ws/market.
- Apakah saya memerlukan otentikasi untuk membaca data pasar?
- Tidak. Pembacaan dari Gamma, Data, dan endpoint CLOB publik tidak memerlukan otentikasi. Penempatan order di CLOB membutuhkan API key ditambah HMAC.
- Apa saja batas laju penting untuk /markets?
- /markets dibatasi hingga 300 permintaan per 10 detik. Panggilan listing gabungan /markets dan /events dibatasi hingga 900 permintaan per 10 detik. Batas keseluruhan API Gamma adalah 4000 req per 10 detik.
- Bisakah saya menggunakan WebSocket untuk pembaruan order book real-time?
- Ya. WebSocket pasar menyediakan event real-time book, price_change, best_bid_ask, last_trade_price, dan tick_size_change. Ia melakukan ping setiap 10 detik dan mendukung hingga 500 instrumen per koneksi.
Related topics
- Polymarket API: data pasar cepat untuk trader
- Kalshi API: bagaimana perbandingannya dengan Polymarket untuk trader
- Polymarket bot: cara cepat untuk arb otomatis
- Dokumentasi API Kalshi: Apa yang Harus Diketahui Trader
- Polymarket trading bot: arbitrase otomatis dengan PolyArb
- Kalshi bot: arbitrase Polymarket cepat dengan PolyArb