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

# CLOB 介紹

> 了解 Polymarket 的中央限價訂單簿（CLOB）系統

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

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

Polymarket 的中央限價訂單簿（CLOB）是一個高性能的訂單匹配引擎，為預測市場提供高效的價格發現和交易執行。

## 什麼是 CLOB？

CLOB（Central Limit Order Book）是傳統金融市場中使用的標準交易機制。與自動化做市商（AMM）不同，CLOB 提供：

<CardGroup cols={2}>
  <Card title="更好的價格發現" icon="chart-line">
    買賣雙方直接匹配，形成真實的市場價格
  </Card>

  <Card title="更低的滑點" icon="arrow-down">
    訂單直接與訂單簿匹配，減少大額交易的價格影響
  </Card>

  <Card title="更高的資本效率" icon="coins">
    做市商可以在多個價格層級提供流動性
  </Card>

  <Card title="專業交易工具" icon="wrench">
    支援限價單、市價單、FOK、GTD 等多種訂單類型
  </Card>
</CardGroup>

## 系統架構

Polymarket 的 CLOB 系統由幾個關鍵組件組成：

### 鏈下訂單簿

訂單簿在鏈下維護，實現：

* **高性能**：毫秒級訂單匹配
* **低成本**：創建和取消訂單無需 gas 費用
* **實時更新**：通過 WebSocket 推送訂單簿變化

### 鏈上結算

雖然訂單簿在鏈下，但所有交易在鏈上結算：

* **安全性**：利用區塊鏈的不可篡改性
* **透明度**：所有交易可公開驗證
* **自託管**：用戶完全控制自己的資金

### 籤名認證

訂單使用 EIP-712 籤名：

* **無需 gas**：籤名訂單不需要鏈上交易
* **安全**：使用加密籤名驗證訂單真實性
* **靈活**：支援多種錢包類型

## 訂單類型

### 限價訂單（Limit Order）

以指定價格或更好價格執行的訂單。

```python theme={null}
order = OrderArgs(
    price=0.55,      # 最高願意支付的價格
    size=100,        # 數量
    side=BUY,        # 買入
    token_id="..."   # 代幣 ID
)
```

**特點**：

* 價格保證：買單不會超過指定價格，賣單不會低於指定價格
* 部分成交：可能部分成交
* 掛單時間：可能需要等待匹配

### 市價訂單（Market Order）

以當前最佳可用價格立即執行。

**特點**：

* 立即執行：優先考慮速度
* 價格不確定：取決於當前訂單簿
* 適用場景：需要立即進入或退出頭寸

### FOK（Fill-Or-Kill）

必須立即完全成交，否則取消。

```python theme={null}
resp = client.post_order(signed_order, OrderType.FOK)
```

**特點**：

* 全部成交或全部取消
* 無部分成交
* 適合大額訂單

### GTC（Good-Till-Cancelled）

訂單保持活躍直到完全成交或手動取消。

```python theme={null}
resp = client.post_order(signed_order, OrderType.GTC)
```

**特點**：

* 默認訂單類型
* 可部分成交
* 需要手動取消

### GTD（Good-Till-Date）

訂單保持活躍直到指定時間。

```python theme={null}
order = OrderArgs(
    price=0.55,
    size=100,
    side=BUY,
    token_id="...",
    expiration=int(time.time()) + 3600  # 1小時後過期
)
```

**特點**：

* 自動過期
* 時間控制
* 風險管理

## 訂單生命周期

```mermaid theme={null}
graph LR
    A[創建訂單] --> B[籤名訂單]
    B --> C[提交到 CLOB]
    C --> D{匹配}
    D -->|有對手方| E[部分/完全成交]
    D -->|無對手方| F[掛在訂單簿上]
    F --> G{等待}
    G -->|匹配| E
    G -->|取消| H[已取消]
    G -->|過期| I[已過期]
    E --> J[已成交]
```

## 訂單匹配規則

訂單按以下規則匹配：

1. **價格優先**：更好的價格優先匹配
2. **時間優先**：相同價格，更早的訂單優先
3. **數量匹配**：訂單可以部分成交

### 示例

假設訂單簿狀態：

**買單（Bids）**：

* 0.54: 100 份
* 0.53: 200 份
* 0.52: 150 份

**賣單（Asks）**：

* 0.56: 150 份
* 0.57: 200 份
* 0.58: 100 份

現在提交一個以 0.56 賣出 100 份的限價單：

* 立即與 0.54 的買單匹配 100 份
* 訂單完全成交

提交一個以 0.56 買入 200 份的限價單：

* 與 0.56 的賣單匹配 150 份
* 剩餘 50 份掛在訂單簿上，等待 0.56 或更低的賣單

## 費用結構

Polymarket CLOB 採用 Maker-Taker 費用模式：

| 角色        | 費用       | 說明                      |
| --------- | -------- | ----------------------- |
| **Maker** | 0% - 負費用 | 向訂單簿添加流動性（限價單）          |
| **Taker** | \~0.5%   | 從訂單簿移除流動性（市價單或立即成交的限價單） |

<Callout type="info">
  **流動性激勵**：Maker 可能獲得返傭或流動性獎勵，鼓勵提供流動性。
</Callout>

## 優勢

### 對交易者

* **價格透明**：看到所有訂單和深度
* **低滑點**：大額交易的價格影響更小
* **訂單控制**：選擇確切的價格和數量
* **成本效益**：Maker 費用低或負費用

### 對做市商

* **流動性挖礦**：提供流動性獲得獎勵
* **價格控制**：在多個層級設置訂單
* **風險管理**：使用限價單控制風險
* **專業工具**：API 支援算法交易

## 限制和注意事項

<Warning>
  **重要限制**：

  1. **最小訂單規模**：某些市場有最小訂單要求
  2. **價格精度**：價格必須符合最小价格變動單位（tick size）
  3. **速率限制**：API 調用受速率限制約束
  4. **地理限制**：某些地區無法訪問
  5. **NegRisk 市場**：需要特殊處理
</Warning>

## 與 AMM 的比較

| 特性     | CLOB     | AMM     |
| ------ | -------- | ------- |
| 價格發現   | 買賣雙方直接決定 | 算法決定    |
| 滑點     | 低（大額交易）  | 高（大額交易） |
| 流動性提供  | 主動做市     | 被動流動性池  |
| 資本效率   | 高        | 中       |
| 複雜度    | 高        | 低       |
| Gas 成本 | 僅結算時     | 每次交易    |

## 開始使用

準備好開始交易了嗎？

<Steps>
  <Step title="設置客戶端">
    安裝並配置 CLOB 客戶端庫
  </Step>

  <Step title="認證">
    創建 API 憑據並設置籤名
  </Step>

  <Step title="下單">
    創建並提交您的第一筆訂單
  </Step>

  <Step title="管理訂單">
    監控和管理您的活躍訂單
  </Step>
</Steps>

## 下一步

<CardGroup cols={2}>
  <Card title="CLOB 快速開始" icon="rocket" href="/api-tutorial/clob/quickstart">
    快速開始使用 CLOB API
  </Card>

  <Card title="認證" icon="key" href="/api-tutorial/clob/authentication">
    學習如何認證 API 請求
  </Card>

  <Card title="訂單管理" icon="list-check" href="/api-tutorial/clob/order-management">
    深入了解訂單管理
  </Card>

  <Card title="REST API" icon="code" href="/api-tutorial/clob/rest-api">
    探索完整的 REST API
  </Card>
</CardGroup>
