法律合規提醒:在使用 Polymarket 服務或 API 前,請確認您所在地區的法律規定。Polymarket 目前不支援比利時、法國、新加坡、泰國、中國大陸等地區,政策可能隨時變化。
Polymarket 提供多個 API 來訪問不同類型的數據和功能。以下是所有主要端點的概述。
基礎 URL
- CLOB API:
https://clob.polymarket.com
- Gamma API:
https://gamma-api.polymarket.com
- Data API:
https://data-api.polymarket.com
- Strapi API:
https://strapi-matic.poly.market
CLOB API 端點
市場數據
| 方法 | 端點 | 描述 |
|---|
| GET | /markets | 獲取所有可用市場 |
| GET | /market | 獲取特定市場信息 |
| GET | /sampling-markets | 獲取採樣市場 |
| GET | /sampling-simplified-markets | 獲取簡化的採樣市場 |
訂單簿
| 方法 | 端點 | 描述 |
|---|
| GET | /book | 獲取市場訂單簿 |
| GET | /midpoint | 獲取市場中間價 |
| GET | /price | 獲取市場當前價格 |
| GET | /spread | 獲取買賣價差 |
訂單管理
| 方法 | 端點 | 描述 |
|---|
| POST | /order | 創建新訂單 |
| GET | /order | 獲取訂單信息 |
| DELETE | /order | 取消訂單 |
| POST | /orders | 批量創建訂單 |
| GET | /orders | 獲取多個訂單 |
| DELETE | /orders | 批量取消訂單 |
| DELETE | /cancel-all | 取消所有訂單 |
| DELETE | /cancel-market-orders | 取消特定市場的所有訂單 |
交易歷史
| 方法 | 端點 | 描述 |
|---|
| GET | /trades | 獲取交易歷史 |
| GET | /data/trades | 獲取歷史交易數據 |
| 方法 | 端點 | 描述 |
|---|
| GET | /balances | 獲取帳戶餘額 |
| GET | /positions | 獲取當前持倉 |
| 方法 | 端點 | 描述 |
|---|
| GET | /tick-size | 獲取最小价格變動單位 |
| GET | /neg-risk | 獲取負風險市場信息 |
| 方法 | 端點 | 描述 |
|---|
| POST | /auth/api-key | 創建 API 密鑰 |
| GET | /auth/api-key | 獲取 API 密鑰信息 |
| DELETE | /auth/api-key | 刪除 API 密鑰 |
Gamma API 端點
| 方法 | 端點 | 描述 |
|---|
| GET | /markets | 搜索和過濾市場 |
| GET | /markets/{condition_id} | 獲取特定市場詳情 |
| GET | /markets/data | 獲取批量市場數據 |
| 方法 | 端點 | 描述 |
|---|
| GET | /events | 獲取事件列表 |
| GET | /events/{slug} | 獲取特定事件詳情 |
| 方法 | 端點 | 描述 |
|---|
| GET | /comments | 獲取評論列表 |
| POST | /comments | 發布評論 |
用戶資料
| 方法 | 端點 | 描述 |
|---|
| GET | /profiles/{address} | 獲取用戶資料 |
標籤和分類
| 方法 | 端點 | 描述 |
|---|
| GET | /tags | 獲取所有標籤 |
| GET | /sports | 獲取體育類別 |
| GET | /series | 獲取系列市場 |
健康檢查
| 方法 | 端點 | 描述 |
|---|
| GET | /health | 檢查 API 狀態 |
Data API 端點
核心數據
| 方法 | 端點 | 描述 |
|---|
| GET | /events | 獲取事件數據 |
| GET | /markets | 獲取市場數據 |
| GET | /prices | 獲取價格歷史 |
用戶數據
| 方法 | 端點 | 描述 |
|---|
| GET | /users/{address} | 獲取用戶統計 |
| GET | /users/{address}/trades | 獲取用戶交易歷史 |
| GET | /users/{address}/positions | 獲取用戶持倉 |
| GET | /users/{address}/pnl | 獲取用戶盈虧 |
構建者數據
| 方法 | 端點 | 描述 |
|---|
| GET | /builders/{api_key} | 獲取構建者統計 |
| GET | /builders/{api_key}/volume | 獲取歸因交易量 |
健康檢查
| 方法 | 端點 | 描述 |
|---|
| GET | /health | 檢查 API 狀態 |
Strapi API 端點
新聞和內容
| 方法 | 端點 | 描述 |
|---|
| GET | /articles | 獲取文章列表 |
| GET | /articles/{id} | 獲取特定文章 |
WebSocket 端點
- URL:
wss://ws-subscriptions-clob.polymarket.com/ws/
market: 訂閱市場數據更新
user: 訂閱用戶訂單和餘額更新
all: 訂閱所有更新
實時數據流(RTDS)
Crypto Prices
- URL:
wss://price-feeds.polymarket.com
- 訂閱加密貨幣實時價格
端點使用示例
獲取市場列表
curl "https://clob.polymarket.com/markets?limit=10&offset=0"
獲取訂單簿
curl "https://clob.polymarket.com/book?token_id=YOUR_TOKEN_ID"
創建訂單
curl -X POST "https://clob.polymarket.com/order" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"tokenID": "YOUR_TOKEN_ID",
"price": "0.55",
"size": "10",
"side": "BUY"
}'
搜索市場(Gamma API)
curl "https://gamma-api.polymarket.com/markets?limit=5&offset=0"
獲取用戶數據(Data API)
curl "https://data-api.polymarket.com/users/YOUR_ADDRESS"
請求參數
常見查詢參數
limit: 返回結果的最大數量(默認:10)
offset: 分頁偏移量(默認:0)
next_cursor: 遊標分頁的下一頁標識符
市場過濾參數
closed: 是否包含已關閉市場(true/false)
active: 是否只返回活躍市場(true/false)
tag: 按標籤過濾
category: 按類別過濾
order: 排序順序(volume, liquidity, etc.)
響應格式
所有 API 端點都返回 JSON 格式的響應。
成功響應
{
"success": true,
"data": {
// 響應數據
}
}
錯誤響應
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "錯誤描述"
}
}
狀態碼
200: 成功
201: 創建成功
400: 錯誤的請求
401: 未授權
403: 禁止訪問
404: 未找到
429: 速率限制
500: 伺服器錯誤
下一步