เอกสาร API ของ Polymarket: endpoints, ข้อจำกัดอัตรา, และการใช้งาน
ถ้าคุณค้นหา "polymarket api docs" คุณต้องการ endpoints ที่แน่นอน รูปแบบการยืนยันตัวตน และขีดจำกัดเชิงปฏิบัติสำหรับการสร้างหรือผสานรวมกับ Polymarket ด้านล่างคือสาม public REST APIs และ market WebSocket ที่คุณจะใช้ พร้อมพารามิเตอร์สำคัญและข้อจำกัดด้านอัตรา ฉันยังอธิบายด้วยว่า CLOB ต้องการอะไรสำหรับการเทรดและ PolyArb ใช้พื้นผิวเหล่านี้อย่างไรเพื่อค้นหา intra-market arbitrage
Official API endpoints and surface map
Polymarket เปิดเผยสาม public REST surfaces และหนึ่ง market WebSocket Gamma API สำหรับ markets และ events อยู่ที่ https://gamma-api.polymarket.com Data API สำหรับ positions, trades และ open interest อยู่ที่ https://data-api.polymarket.com CLOB API สำหรับ order book และการเทรด อยู่ที่ https://clob.polymarket.com ซ็อกเก็ตตลาดแบบเรียลไทม์คือ wss://ws-subscriptions-clob.polymarket.com/ws/market แต่ละ surface มีจุดประสงค์: Gamma สำหรับการลิสต์และการกรอง, Data สำหรับกิจกรรมเชิงประวัติและข้อมูลจากเชน, CLOB สำหรับการอ่าน order-book แบบสดและการวางคำสั่ง (การอ่านเป็นสาธารณะ; การเทรดต้องการ API key + HMAC) WebSocket สตรีมเหตุการณ์ book และ price-change สำหรับสูงสุด 500 instruments ต่อการเชื่อมต่อ
Gamma /markets parameters and limits
endpoint /markets ของ Gamma รองรับการแบ่งหน้าแบบ keyset: ใช้ after_cursor ที่ส่งกลับโดยการเรียกก่อนหน้า; offset จะถูกปฏิเสธด้วย HTTP 422 พารามิเตอร์ที่มีประโยชน์รวมถึง limit (สูงสุด 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending และ tag_id ข้อจำกัดอัตรา: /markets จำกัดที่ 300 requests ต่อ 10 วินาที; การเรียกรายการรวม /markets + /events จำกัดที่ 900 requests ต่อ 10 วินาที ค่าอนุญาตรวมของ Gamma API คือ 4000 requests ต่อ 10 วินาที
CLOB and trading mechanics
CLOB เปิดเผย order book, midpoint, price history และการวาง/ยกเลิกคำสั่ง การเทรดต้องการ API key พร้อม HMAC; การอ่านเป็นสาธารณะ tick size ของ Polymarket, เหตุการณ์ best_bid_ask และตัวช่วยคำสั่งตลาดแบบ FAK ถูกเผยผ่าน CLOB และ market WebSocket จำไว้ว่า maker fees เป็นศูนย์และ taker fees แตกต่างตามหมวดหมู่ หากคุณสร้างเอเจนต์เทรดที่เส้นทาง ให้พิจารณาโปรแกรม Builder ของ Polymarket สำหรับการให้เครดิตและรางวัล builder-fee
How PolyArb uses these APIs
PolyArb โพลล์ Gamma และหนังสือ CLOB และสมัครรับ market WebSocket เพื่อตรวจจับโอกาส intra-market arbitrage ที่ Σ bestAsk < $1.00 บอทของเรารันบนโครงสร้างพื้นฐานความหน่วงต่ำ (40ms plan) เพื่อเอาชนะบอทฟรี (~800ms) โดยมีแผน $99/month และ $7.62 minimum guaranteed edge ต่อการเทรด เราใช้เหตุการณ์ best_bid_ask แบบสด midpoint ของ CLOB และประวัติจาก Data API เพื่อกำหนดขนาดคำสั่งและหลีกเลี่ยง partial fills โปรดทราบความเสี่ยงในการดำเนินงานที่พบได้ทั่วไป: ข้อพิพาทการตัดสินโดย UMA, slippage, การเปลี่ยนแปลงค่าธรรมเนียม, เวลาในการชำระบัญชี, และความเสี่ยงของสมาร์ทคอนแทรกต์
เริ่มทำ arbitrage บน Polymarket ด้วย PolyArb วันนี้
สมัครรับ PolyArb ในราคา $99/month เพื่อรับความหน่วง 40ms, การแจ้งเตือนทาง Telegram และ Discord, การดำเนินการแบบ non-custodial, และ $7.62 minimum guaranteed edge ต่อการเทรด
FAQ
- Where are the official Polymarket API base URLs?
- 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.
- Do I need authentication to read market data?
- ไม่ ระบบอ่านจาก Gamma, Data และ public CLOB endpoints ไม่ต้องการการยืนยันตัวตน การวางคำสั่งบน CLOB ต้องการ API key พร้อม HMAC
- What are the important rate limits for /markets?
- /markets ถูกจำกัดที่ 300 requests ต่อ 10 วินาที การเรียกรายการรวม /markets และ /events ถูกจำกัดที่ 900 requests ต่อ 10 วินาที ขีดจำกัดรวมของ Gamma API คือ 4000 req ต่อ 10 วินาที
- Can I use the WebSocket for real-time order book updates?
- ได้ WebSocket ตลาดให้ข้อมูลแบบเรียลไทม์ทั้ง book, price_change, best_bid_ask, last_trade_price และ tick_size_change มันส่ง PING ทุก 10 วินาทีและรองรับสูงสุด 500 instruments ต่อการเชื่อมต่อ