LIVE
$7.62 min profit is yours / per trade
Get the bot
PolyArb
bot

Tài liệu API Polymarket: các endpoint, giới hạn tốc độ và cách sử dụng

Nếu bạn tìm kiếm "polymarket api docs" thì bạn muốn biết chính xác các endpoint, mô hình xác thực và giới hạn thực tế để xây dựng hoặc tích hợp với Polymarket. Dưới đây là ba REST API công cộng và một WebSocket thị trường mà bạn sẽ dùng, cùng các tham số chính và giới hạn tốc độ. Tôi cũng mô tả yêu cầu của CLOB cho giao dịch và cách PolyArb tận dụng những bề mặt này để tìm arbitrage nội thị.

Get the bot — $99/moArbitrage calculator

Các endpoint chính thức và bản đồ giao diện

Polymarket cung cấp ba bề mặt REST công cộng và một WebSocket thị trường. Gamma API cho markets và events nằm tại https://gamma-api.polymarket.com. Data API cho positions, trades và open interest nằm tại https://data-api.polymarket.com. CLOB API cho order book và trading nằm tại https://clob.polymarket.com. Socket thị trường theo thời gian thực là wss://ws-subscriptions-clob.polymarket.com/ws/market. Mỗi bề mặt có mục đích riêng: Gamma cho danh sách và bộ lọc, Data cho lịch sử và dữ liệu dẫn xuất từ on-chain, CLOB cho đọc sổ lệnh trực tiếp và đặt/cancel lệnh (các thao tác đọc là công khai; giao dịch yêu cầu API key + HMAC). WebSocket truyền sự kiện sổ lệnh và thay đổi giá cho tối đa 500 instrument mỗi kết nối.

Tham số và giới hạn của Gamma /markets

Endpoint /markets của Gamma hỗ trợ phân trang theo keyset: dùng after_cursor trả về bởi lần gọi trước; offset sẽ bị từ chối với HTTP 422. Các tham số truy vấn hữu ích gồm limit (tối đa 1000), slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address, closed, active, archived, order, ascending và tag_id. Giới hạn tốc độ: /markets bị giới hạn 300 requests mỗi 10 giây; các cuộc gọi liệt kê kết hợp /markets + /events bị giới hạn 900 requests mỗi 10 giây. Tổng hạn mức cho Gamma API là 4000 requests mỗi 10 giây.

CLOB và cơ chế giao dịch

CLOB cung cấp order book, midpoint, lịch sử giá, và đặt/hủy lệnh. Giao dịch yêu cầu API key kèm HMAC; các thao tác đọc là công khai. Tick size của Polymarket, sự kiện best_bid_ask, và helper lệnh thị trường FAK được cung cấp qua CLOB và WebSocket thị trường. Hãy nhớ rằng maker fees bằng không và taker fees thay đổi theo danh mục. Nếu bạn xây dựng một agent giao dịch định tuyến, hãy cân nhắc chương trình Builder của Polymarket để được ghi nhận và nhận thưởng builder-fee.

Cách PolyArb sử dụng các API này

PolyArb liên tục polling Gamma và sổ CLOB và đăng ký WebSocket thị trường để phát hiện cơ hội arbitrage nội thị khi Σ bestAsk < $1.00. Bot của chúng tôi chạy trên hạ tầng độ trễ thấp (gói 40ms) để vượt các bot miễn phí (~800ms), với gói $99/month và lợi thế tối thiểu được đảm bảo $7.62 cho mỗi giao dịch. Chúng tôi kết hợp sự kiện best_bid_ask trực tiếp, midpoint của CLOB và lịch sử từ Data API để định kích thước lệnh và tránh khớp một phần. Lưu ý các rủi ro vận hành thông thường: tranh chấp resolution qua UMA, trượt giá, thay đổi phí, thời gian giải quyết và rủi ro hợp đồng thông minh.

Bắt đầu arbitrage trên Polymarket với PolyArb ngay hôm nay

Đăng ký PolyArb với $99/month để nhận độ trễ 40ms, cảnh báo trên Telegram và Discord, thực thi non-custodial, và lợi thế tối thiểu được đảm bảo $7.62 cho mỗi giao dịch.

Get the bot — $99/mo

FAQ

Các URL base chính thức của Polymarket API ở đâu?
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.
Tôi có cần xác thực để đọc dữ liệu thị trường không?
Không. Các thao tác đọc từ Gamma, Data và các endpoint công khai của CLOB không cần xác thực. Việc đặt lệnh trên CLOB yêu cầu API key kèm HMAC.
Các giới hạn tốc độ quan trọng cho /markets là gì?
/markets bị giới hạn 300 requests mỗi 10 giây. Các cuộc gọi liệt kê kết hợp /markets và /events bị giới hạn 900 requests mỗi 10 giây. Tổng hạn mức Gamma API là 4000 req mỗi 10 giây.
Tôi có thể sử dụng WebSocket để cập nhật sổ lệnh theo thời gian thực không?
Có. WebSocket thị trường cung cấp sự kiện real-time về book, price_change, best_bid_ask, last_trade_price và tick_size_change. Nó gửi ping mỗi 10 giây và hỗ trợ đến 500 instrument mỗi kết nối.

Related topics