Polymarket API 中文教程｜CLOB/Gamma/Data 所有端点列表与代码示例【2026】

還沒有帳號？點擊這裡註冊 Polymarket 並完成入金，才能用錢包私鑰為訂單籤名、實際成交。

法律合規提醒：在使用 Polymarket 服務或 API 前，請確認您所在地區的法律規定。Polymarket 目前不支援比利時、法國、新加坡、泰國、中國大陸等地區，政策可能隨時變化。

Polymarket 提供多個 API 來訪問不同類型的數據和功能。以下是所有主要端點的概述。

選哪個 API？

API	用途	需要認證
CLOB API	下單、取消訂單、查訂單簿、帳戶餘額	✅ 是（交易操作）
Gamma API	搜索市場、事件列表、標籤分類、用戶資料	❌ 否（只讀）
Data API	歷史交易數據、用戶盈虧、價格歷史、市場統計	❌ 否（只讀）
WebSocket	即時訂單簿推送、成交更新、用戶事件	部分需要

只要查數據：用 Data API 或 Gamma API，不需要錢包或 API 金鑰。 要自動化交易：用 CLOB 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	`/search`	搜索市場和事件

標籤和分類

方法	端點	描述
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
訂閱加密貨幣實時價格

Comments

訂閱: 市場評論的實時更新

端點使用示例

獲取市場列表

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: 伺服器錯誤

歷史數據端點（常用）

「polymarket historical data」是開發者最常搜索的需求。以下是主要的歷史數據端點：

價格歷史

# 獲取某個市場的歷史價格（Data API）
curl "https://data-api.polymarket.com/prices?market=CONDITION_ID&interval=1d&fidelity=60"

參數說明：

market：市場的 condition ID（可從 Gamma API 的 /markets 獲取）
interval：時間範圍（1d、1w、1m、all）
fidelity：數據點間隔（分鐘，最小 1，最大 1440）

歷史成交記錄

# 獲取某市場的歷史成交（CLOB API）
curl "https://clob.polymarket.com/data/trades?market=CONDITION_ID&limit=100"

用戶歷史盈虧

# 查詢特定地址的盈虧記錄（Data API）
curl "https://data-api.polymarket.com/users/0xYOUR_ADDRESS/pnl"

完整的歷史數據文檔請參考 CLOB Historical Data。

常見問題

Q：不需要 API 金鑰也能獲取市場數據嗎？ 可以。Gamma API 和 Data API 的只讀端點不需要認證，直接用 curl 或 fetch 即可訪問市場列表、價格和歷史數據。只有 CLOB API 的交易操作（下單、取消）需要 API 金鑰和錢包簽名。 Q：CLOB API 和 Gamma API 的 /markets 端點有什麼不同？

	CLOB `/markets`	Gamma `/markets`
主要用途	取得訂單簿交易所需的 token ID	搜索、過濾市場（支持關鍵字、標籤）
返回格式	以 condition ID 為中心	以事件和市場為中心，包含更多元數據
過濾能力	有限	豐富（標籤、分類、關閉狀態等）

Q：速率限制是多少？ 各端點限制不同，詳見速率限制頁面。一般免費訪問的限制是每分鐘約 100 次請求。 Q：可以用 Python 直接調用嗎？ 可以。官方提供了 Python 客戶端 py-clob-client，也可以用 requests 庫直接調用 REST 端點。具體示例請看第一筆訂單教程。 Q：WebSocket 連接斷開後需要重新訂閱嗎？ 是的，WebSocket 連接斷開後需要重新發送訂閱消息。建議在客戶端實作自動重連和重新訂閱的邏輯。

下一步

第一筆訂單

使用這些端點下您的第一筆訂單

速率限制

了解各端點的速率限制

CLOB REST API

深入了解 CLOB REST API

歷史數據

完整歷史數據 API 文檔

​選哪個 API？

​基礎 URL

​CLOB API 端點

​市場數據

​訂單簿

​訂單管理

​交易歷史

​帳戶

​配置

​認證

​Gamma API 端點

​市場

​事件

​評論

​用戶資料

​搜索

​標籤和分類

​健康檢查

​Data API 端點

​核心數據

​用戶數據

​構建者數據

​健康檢查

​Strapi API 端點

​新聞和內容

​WebSocket 端點

​連接

​頻道

​實時數據流（RTDS）

​Crypto Prices

​Comments

​端點使用示例

​獲取市場列表

​獲取訂單簿

​創建訂單

​搜索市場（Gamma API）

​獲取用戶數據（Data API）

​請求參數

​常見查詢參數

​市場過濾參數

​響應格式

​成功響應

​錯誤響應

​狀態碼

​歷史數據端點（常用）

​價格歷史

​歷史成交記錄

​用戶歷史盈虧

​常見問題

​下一步

第一筆訂單

速率限制

CLOB REST API

歷史數據

選哪個 API？

基礎 URL

CLOB API 端點

市場數據

訂單簿

訂單管理

交易歷史

帳戶

配置

認證

Gamma API 端點

市場

事件

評論

用戶資料

搜索

標籤和分類

健康檢查

Data API 端點

核心數據

用戶數據

構建者數據

健康檢查

Strapi API 端點

新聞和內容

WebSocket 端點

連接

頻道

實時數據流（RTDS）

Crypto Prices

Comments

端點使用示例

獲取市場列表

獲取訂單簿

創建訂單

搜索市場（Gamma API）

獲取用戶數據（Data API）

請求參數

常見查詢參數

市場過濾參數

響應格式

成功響應

錯誤響應

狀態碼

歷史數據端點（常用）

價格歷史

歷史成交記錄

用戶歷史盈虧

常見問題

下一步