Skip to main content
還沒有帳號?點擊這裡註冊 Polymarket 並完成入金,才能用錢包私鑰為訂單籤名、實際成交。
法律合規提醒:在使用 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/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: 伺服器錯誤

下一步