> ## Documentation Index
> Fetch the complete documentation index at: https://polymarketcn.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Polymarket API 完整中文文档：CLOB、Gamma、Data API 所有端点列表，附 Python/curl 代码示例。行情数据、下单交易、订单管理、WebSocket 实时数据流接口详解。

<Callout type="success">
  還沒有帳號？[點擊這裡註冊 Polymarket](https://polymarket.com/?r=2026VIP) 並完成入金，才能用錢包私鑰為訂單籤名、實際成交。
</Callout>

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

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

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

## 端點使用示例

### 獲取市場列表

```bash theme={null}
curl "https://clob.polymarket.com/markets?limit=10&offset=0"
```

### 獲取訂單簿

```bash theme={null}
curl "https://clob.polymarket.com/book?token_id=YOUR_TOKEN_ID"
```

### 創建訂單

```bash theme={null}
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）

```bash theme={null}
curl "https://gamma-api.polymarket.com/markets?limit=5&offset=0"
```

### 獲取用戶數據（Data API）

```bash theme={null}
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 格式的響應。

### 成功響應

```json theme={null}
{
  "success": true,
  "data": {
    // 響應數據
  }
}
```

### 錯誤響應

```json theme={null}
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "錯誤描述"
  }
}
```

## 狀態碼

* `200`: 成功
* `201`: 創建成功
* `400`: 錯誤的請求
* `401`: 未授權
* `403`: 禁止訪問
* `404`: 未找到
* `429`: 速率限制
* `500`: 伺服器錯誤

## 下一步

<CardGroup cols={2}>
  <Card title="第一筆訂單" icon="rocket" href="/api-tutorial/first-order">
    使用這些端點下您的第一筆訂單
  </Card>

  <Card title="速率限制" icon="gauge" href="/api-tutorial/rate-limits">
    了解各端點的速率限制
  </Card>

  <Card title="CLOB REST API" icon="code" href="/api-tutorial/clob/rest-api">
    深入了解 CLOB REST API
  </Card>

  <Card title="Gamma API" icon="database" href="/api-tutorial/gamma-structure/overview">
    探索 Gamma 市場數據 API
  </Card>
</CardGroup>