CLOB 快速開始

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

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

本指南將幫助您快速開始使用 Polymarket 的中央限價訂單簿（CLOB）API。

安裝

Python

pip install py-clob-client

TypeScript/JavaScript

npm install @polymarket/clob-client ethers

基本設置

Python 設置

from py_clob_client.client import ClobClient
from py_clob_client.clob_types import OrderArgs, OrderType
from py_clob_client.order_builder.constants import BUY, SELL

# CLOB API 主機
host = "https://clob.polymarket.com"

# 您的私鑰
private_key = "YOUR_PRIVATE_KEY"

# Polygon 主網
chain_id = 137

# 您的代理錢包地址
proxy_address = "YOUR_PROXY_ADDRESS"

# 創建客戶端
# signature_type=1: Magic/Email 登錄
# signature_type=2: 瀏覽器錢包（MetaMask 等）
# 不指定 funder: EOA（外部擁有帳戶）
client = ClobClient(
    host,
    key=private_key,
    chain_id=chain_id,
    signature_type=1,  # 根據您的登錄方式調整
    funder=proxy_address
)

# 設置 API 憑據
client.set_api_creds(client.create_or_derive_api_creds())

TypeScript 設置

import { ClobClient } from '@polymarket/clob-client';
import { ethers } from 'ethers';

// CLOB API 主機
const host = 'https://clob.polymarket.com';

// 您的私鑰
const privateKey = 'YOUR_PRIVATE_KEY';

// Polygon 主網
const chainId = 137;

// 您的代理錢包地址
const proxyAddress = 'YOUR_PROXY_ADDRESS';

// 創建錢包
const wallet = new ethers.Wallet(privateKey);

// 創建客戶端
// signatureType=1: Magic/Email 登錄
// signatureType=2: 瀏覽器錢包（MetaMask 等）
// 不指定 funder: EOA（外部擁有帳戶）
const client = new ClobClient(
  host,
  chainId,
  wallet,
  1, // 根據您的登錄方式調整
  proxyAddress
);

// 設置 API 憑據
await client.setApiCreds(client.createOrDeriveApiCreds());

獲取市場數據

列出所有市場

# Python
markets = client.get_markets()
for market in markets[:5]:  # 顯示前5個市場
    print(f"問題: {market['question']}")
    print(f"Token ID (Yes): {market['tokens'][0]['token_id']}")
    print(f"Token ID (No): {market['tokens'][1]['token_id']}")
    print("---")

// TypeScript
const markets = await client.getMarkets();
markets.slice(0, 5).forEach(market => {
  console.log(`問題: ${market.question}`);
  console.log(`Token ID (Yes): ${market.tokens[0].token_id}`);
  console.log(`Token ID (No): ${market.tokens[1].token_id}`);
  console.log('---');
});

獲取訂單簿

# Python
token_id = "YOUR_TOKEN_ID"
book = client.get_order_book(token_id)

print("買單 (Bids):")
for bid in book['bids'][:5]:
    print(f"價格: {bid['price']}, 數量: {bid['size']}")

print("\n賣單 (Asks):")
for ask in book['asks'][:5]:
    print(f"價格: {ask['price']}, 數量: {ask['size']}")

// TypeScript
const tokenId = 'YOUR_TOKEN_ID';
const book = await client.getOrderBook(tokenId);

console.log('買單 (Bids):');
book.bids.slice(0, 5).forEach(bid => {
  console.log(`價格: ${bid.price}, 數量: ${bid.size}`);
});

console.log('\n賣單 (Asks):');
book.asks.slice(0, 5).forEach(ask => {
  console.log(`價格: ${ask.price}, 數量: ${ask.size}`);
});

獲取當前價格

# Python
token_id = "YOUR_TOKEN_ID"

# 中間價
midpoint = client.get_midpoint(token_id)
print(f"中間價: {midpoint}")

# 最佳買賣價
book = client.get_order_book(token_id)
best_bid = book['bids'][0]['price'] if book['bids'] else None
best_ask = book['asks'][0]['price'] if book['asks'] else None
spread = float(best_ask) - float(best_bid) if best_ask and best_bid else None

print(f"最佳買價: {best_bid}")
print(f"最佳賣價: {best_ask}")
print(f"價差: {spread}")

// TypeScript
const tokenId = 'YOUR_TOKEN_ID';

// 中間價
const midpoint = await client.getMidpoint(tokenId);
console.log(`中間價: ${midpoint}`);

// 最佳買賣價
const book = await client.getOrderBook(tokenId);
const bestBid = book.bids.length > 0 ? book.bids[0].price : null;
const bestAsk = book.asks.length > 0 ? book.asks[0].price : null;
const spread = bestAsk && bestBid ? parseFloat(bestAsk) - parseFloat(bestBid) : null;

console.log(`最佳買價: ${bestBid}`);
console.log(`最佳賣價: ${bestAsk}`);
console.log(`價差: ${spread}`);

創建和提交訂單

買入訂單

# Python
from py_clob_client.order_builder.constants import BUY

# 創建買入訂單
order_args = OrderArgs(
    price=0.55,                # 願意支付的價格
    size=100.0,                # 購買數量
    side=BUY,                  # 買入
    token_id="YOUR_TOKEN_ID"   # 代幣 ID
)

# 籤署訂單
signed_order = client.create_order(order_args)

# 提交 GTC 訂單
response = client.post_order(signed_order, OrderType.GTC)
print(f"訂單已創建，ID: {response['orderID']}")

// TypeScript
import { Side, OrderType } from '@polymarket/clob-client';

// 創建買入訂單
const orderArgs = {
  tokenID: 'YOUR_TOKEN_ID',  // 代幣 ID
  price: 0.55,               // 願意支付的價格
  size: 100,                 // 購買數量
  side: Side.BUY,            // 買入
};

// 籤署訂單
const signedOrder = await client.createOrder(orderArgs);

// 提交 GTC 訂單
const response = await client.postOrder(signedOrder, OrderType.GTC);
console.log(`訂單已創建，ID: ${response.orderID}`);

賣出訂單

# Python
from py_clob_client.order_builder.constants import SELL

# 創建賣出訂單
order_args = OrderArgs(
    price=0.60,                # 願意接受的價格
    size=50.0,                 # 出售數量
    side=SELL,                 # 賣出
    token_id="YOUR_TOKEN_ID"   # 代幣 ID
)

# 籤署並提交
signed_order = client.create_order(order_args)
response = client.post_order(signed_order, OrderType.GTC)
print(f"訂單已創建，ID: {response['orderID']}")

// TypeScript
// 創建賣出訂單
const orderArgs = {
  tokenID: 'YOUR_TOKEN_ID',
  price: 0.60,
  size: 50,
  side: Side.SELL,
};

// 籤署並提交
const signedOrder = await client.createOrder(orderArgs);
const response = await client.postOrder(signedOrder, OrderType.GTC);
console.log(`訂單已創建，ID: ${response.orderID}`);

管理訂單

查詢訂單

# Python
# 獲取所有活躍訂單
orders = client.get_orders()
for order in orders:
    print(f"訂單 ID: {order['id']}")
    print(f"價格: {order['price']}, 數量: {order['size']}")
    print(f"狀態: {order['status']}")
    print("---")

# 獲取特定訂單
order_id = "YOUR_ORDER_ID"
order = client.get_order(order_id)
print(f"訂單詳情: {order}")

// TypeScript
// 獲取所有活躍訂單
const orders = await client.getOrders();
orders.forEach(order => {
  console.log(`訂單 ID: ${order.id}`);
  console.log(`價格: ${order.price}, 數量: ${order.size}`);
  console.log(`狀態: ${order.status}`);
  console.log('---');
});

// 獲取特定訂單
const orderId = 'YOUR_ORDER_ID';
const order = await client.getOrder(orderId);
console.log(`訂單詳情:`, order);

取消訂單

# Python
# 取消單個訂單
order_id = "YOUR_ORDER_ID"
response = client.cancel_order(order_id)
print(f"訂單已取消: {response}")

# 取消多個訂單
order_ids = ["ORDER_ID_1", "ORDER_ID_2"]
response = client.cancel_orders(order_ids)
print(f"已取消 {len(response)} 個訂單")

# 取消特定市場的所有訂單
token_id = "YOUR_TOKEN_ID"
response = client.cancel_market_orders(token_id)
print(f"已取消市場的所有訂單")

# 取消所有訂單
response = client.cancel_all()
print("已取消所有訂單")

// TypeScript
// 取消單個訂單
const orderId = 'YOUR_ORDER_ID';
const response = await client.cancelOrder(orderId);
console.log('訂單已取消:', response);

// 取消多個訂單
const orderIds = ['ORDER_ID_1', 'ORDER_ID_2'];
const cancelResponse = await client.cancelOrders(orderIds);
console.log(`已取消 ${cancelResponse.length} 個訂單`);

// 取消特定市場的所有訂單
const tokenId = 'YOUR_TOKEN_ID';
await client.cancelMarketOrders(tokenId);
console.log('已取消市場的所有訂單');

// 取消所有訂單
await client.cancelAll();
console.log('已取消所有訂單');

查詢帳戶信息

檢查餘額

# Python
# 獲取帳戶餘額
balance = client.get_balance()
print(f"可用餘額: {balance['available']} USDC")
print(f"總餘額: {balance['total']} USDC")

# 獲取持倉
positions = client.get_positions()
for position in positions:
    print(f"市場: {position['market']}")
    print(f"數量: {position['size']}")
    print(f"價值: {position['value']} USDC")
    print("---")

// TypeScript
// 獲取帳戶餘額
const balance = await client.getBalance();
console.log(`可用餘額: ${balance.available} USDC`);
console.log(`總餘額: ${balance.total} USDC`);

// 獲取持倉
const positions = await client.getPositions();
positions.forEach(position => {
  console.log(`市場: ${position.market}`);
  console.log(`數量: ${position.size}`);
  console.log(`價值: ${position.value} USDC`);
  console.log('---');
});

查詢交易歷史

# Python
# 獲取交易歷史
trades = client.get_trades()
for trade in trades[:10]:  # 顯示最近10筆交易
    print(f"時間: {trade['timestamp']}")
    print(f"價格: {trade['price']}, 數量: {trade['size']}")
    print(f"方向: {trade['side']}")
    print("---")

// TypeScript
// 獲取交易歷史
const trades = await client.getTrades();
trades.slice(0, 10).forEach(trade => {
  console.log(`時間: ${trade.timestamp}`);
  console.log(`價格: ${trade.price}, 數量: ${trade.size}`);
  console.log(`方向: ${trade.side}`);
  console.log('---');
});

完整示例：自動交易策略

# Python: 簡單的做市策略
import time
from py_clob_client.order_builder.constants import BUY, SELL

def market_making_strategy(client, token_id, spread=0.02):
    """
    簡單的做市策略：在中間價上下掛買賣單
    """
    while True:
        try:
            # 獲取當前中間價
            midpoint = float(client.get_midpoint(token_id))
            
            # 取消所有現有訂單
            client.cancel_market_orders(token_id)
            
            # 計算買賣價格
            buy_price = round(midpoint - spread / 2, 2)
            sell_price = round(midpoint + spread / 2, 2)
            
            # 下買單
            buy_order = OrderArgs(
                price=buy_price,
                size=10.0,
                side=BUY,
                token_id=token_id
            )
            signed_buy = client.create_order(buy_order)
            client.post_order(signed_buy, OrderType.GTC)
            print(f"買單已下: {buy_price}")
            
            # 下賣單
            sell_order = OrderArgs(
                price=sell_price,
                size=10.0,
                side=SELL,
                token_id=token_id
            )
            signed_sell = client.create_order(sell_order)
            client.post_order(signed_sell, OrderType.GTC)
            print(f"賣單已下: {sell_price}")
            
            # 等待30秒後重新調整
            time.sleep(30)
            
        except Exception as e:
            print(f"錯誤: {e}")
            time.sleep(10)

# 使用策略
# market_making_strategy(client, "YOUR_TOKEN_ID")

錯誤處理

# Python
from py_clob_client.exceptions import PolyApiException

try:
    order_args = OrderArgs(
        price=0.55,
        size=100.0,
        side=BUY,
        token_id="YOUR_TOKEN_ID"
    )
    signed_order = client.create_order(order_args)
    response = client.post_order(signed_order, OrderType.GTC)
except PolyApiException as e:
    print(f"API 錯誤: {e}")
    # 處理特定錯誤
    if "insufficient balance" in str(e).lower():
        print("餘額不足")
    elif "invalid signature" in str(e).lower():
        print("籤名錯誤，檢查私鑰和代理地址")
except Exception as e:
    print(f"未知錯誤: {e}")

// TypeScript
try {
  const orderArgs = {
    tokenID: 'YOUR_TOKEN_ID',
    price: 0.55,
    size: 100,
    side: Side.BUY,
  };
  const signedOrder = await client.createOrder(orderArgs);
  const response = await client.postOrder(signedOrder, OrderType.GTC);
} catch (error: any) {
  console.error('錯誤:', error.message);
  
  // 處理特定錯誤
  if (error.message.includes('insufficient balance')) {
    console.log('餘額不足');
  } else if (error.message.includes('invalid signature')) {
    console.log('籤名錯誤，檢查私鑰和代理地址');
  }
}

下一步

認證

深入了解 CLOB 認證機制

訂單管理

學習高級訂單管理技巧

REST API

探索完整的 REST API 參考

WebSocket

使用 WebSocket 獲取實時數據

開始使用

入金和出金

交易

案例分析

其他

安裝

Python

TypeScript/JavaScript

基本設置

Python 設置

TypeScript 設置

獲取市場數據

列出所有市場

獲取訂單簿

獲取當前價格

創建和提交訂單

買入訂單

賣出訂單

管理訂單

查詢訂單

取消訂單

查詢帳戶信息

檢查餘額

查詢交易歷史

完整示例：自動交易策略

錯誤處理

下一步

認證

訂單管理

REST API

WebSocket

開始使用

入金和出金

交易

案例分析

其他

​安裝

​Python

​TypeScript/JavaScript

​基本設置

​Python 設置

​TypeScript 設置

​獲取市場數據

​列出所有市場

​獲取訂單簿

​獲取當前價格

​創建和提交訂單

​買入訂單

​賣出訂單

​管理訂單

​查詢訂單

​取消訂單

​查詢帳戶信息

​檢查餘額

​查詢交易歷史

​完整示例：自動交易策略

​錯誤處理

​下一步

認證

訂單管理

REST API

WebSocket

安裝

Python

TypeScript/JavaScript

基本設置

Python 設置

TypeScript 設置

獲取市場數據

列出所有市場

獲取訂單簿

獲取當前價格

創建和提交訂單

買入訂單

賣出訂單

管理訂單

查詢訂單

取消訂單

查詢帳戶信息

檢查餘額

查詢交易歷史

完整示例：自動交易策略

錯誤處理

下一步