🎯 2026 完全指南

Polymarket
跟單機器人 建構指南

從零開始打造一套自動監控聰明錢、即時鏡像交易的跟單系統。涵蓋 CLOB V2 API、鏈上事件偵測、風控機制與 2026 最佳實踐。

Python / TypeScript Polygon 鏈 CLOB V2 API USDC 結算 非托管
01

什麼是跟單機器人?

Polymarket 跟單機器人(Copy Trading Bot)會即時監控您指定的目標錢包,並在偵測到新交易時,自動在您自己的錢包按比例鏡像下單。

🔍

監控目標錢包

持續掃描鏈上活動,偵測「聰明錢」地址的開倉、加倉、減倉與平倉行為。

⚖️

比例計算倉位

根據您設定的資金比例或固定風險參數,計算對應的下單規模,而非盲目複製原始金額。

即時執行交易

透過 CLOB API 自動簽署 EIP-712 訂單並送出,盡可能降低滑點與延遲。

🛡️

持倉同步管理

持續追蹤目標的倉位變化,持續同步您的部位以保持一致,並套用停損/停利邏輯。

ℹ️

2026 重要更新:CLOB V2

Polymarket 已於 2026 年 4 月完成重大基礎設施升級,推出 CTF Exchange V2 與重建後的 CLOB V2,並支援 TypeScript、Python、Go 三種語言的新版 SDK。若您沿用舊版機器人,必須更新 SDK 並以新的訂單結構重新簽署。舊版訂單已在維護視窗期間全數取消。

02

系統架構總覽

一套生產級跟單機器人由五大核心模組組成,各模組分工明確、可獨立測試與替換。

目標偵測
Monitor
比例計算
Sizer
風控檢查
Risk Mgr
鏈上下單
Executor
模組 主要職責 技術方式 建議語言
Monitor(監控) 偵測目標錢包的新交易 Data API 輪詢 + WebSocket TypeScript
Sizer(計算倉位) 換算比例下單金額 投資組合比例或固定風險 Python
Risk Manager(風控) 執行前安全檢查 上限規則、黑名單市場 任意
Executor(執行) 簽署並送出訂單 CLOB SDK + EIP-712 TypeScript
Logger(記錄) 持倉追蹤與績效分析 MongoDB / PostgreSQL 任意
03

Polymarket API 完整指南

Polymarket 提供三個不同層次的 API,機器人會同時使用全部三個。

API Base URL 認證 主要用途
Gamma API gamma-api.polymarket.com 免認證 市場列表、事件、搜尋、交易者公開資料
Data API data-api.polymarket.com 免認證 錢包活動歷史(跟單偵測核心)
CLOB API clob.polymarket.com 需 L1/L2 認證 掛單、撤單、查詢持倉、訂單簿
⚠️

雙層認證機制(L1 / L2)

  • L1(EIP-712 私鑰簽名):用於一次性建立或衍生 API 憑證
  • L2(HMAC-SHA256):用於所有後續下單、撤單、查詢操作
  • 即使使用 L2,每筆訂單的 payload 仍須用私鑰進行 EIP-712 簽名
Python L2 認證標頭範例
# 必要的 HTTP 標頭(下單時)
headers = {
    "POLY_ADDRESS":    wallet_address,
    "POLY_SIGNATURE":  hmac_sha256_signature,
    "POLY_TIMESTAMP":  str(int(time.time())),
    "POLY_API_KEY":    api_key,
    "POLY_PASSPHRASE": api_passphrase,
}

跟單核心 API 端點

端點用途輪詢頻率建議
GET /activity?user=0x... 取得目標錢包的交易歷史(偵測新單) 每 2 秒(REST),或改用 WebSocket
GET /book?token_id=... 取得特定市場訂單簿 下單前即時查詢
POST /order 送出新訂單(需 L2 + EIP-712) 觸發型
DELETE /order/{id} 撤銷特定訂單 觸發型
GET /positions 查詢目前持倉 啟動時 + 定期同步

WebSocket 訂閱(推薦)

JavaScript 訂閱市場頻道
const ws = new WebSocket('wss://ws-subscriptions-clob.polymarket.com/ws/market');

ws.onopen = () => {
  ws.send(JSON.stringify({
    type: "market",
    assets_ids: [tokenId_1, tokenId_2]  // 訂閱多個市場
  }));
};

ws.onmessage = (event) => {
  const data = JSON.parse(event.data);
  // data.event_type === "trade" 時觸發跟單邏輯
  if (data.event_type === "trade") {
    handleNewTrade(data);
  }
};
04

分步驟實作

從環境設定到第一筆跟單成功,完整的建構流程。

1

環境準備與錢包設定

建立一個專用的 EOA 錢包(不要用主錢包),在 Polygon 主網充值 USDC(用於交易)與 POL(用於 gas)。錢包地址即為機器人的 funder address。新用戶使用 signatureType=3(deposit wallet),現有 Proxy/Safe 用戶可維持原有類型。

2

安裝 CLOB SDK

官方提供 TypeScript、Python、Go 三版 SDK(已支援 CLOB V2)。強烈建議使用 SDK 而非自行處理 EIP-712 簽名,可避免大量繁瑣的加密操作。

Shell 安裝指令
# TypeScript(推薦)
npm install @polymarket/clob-client ethers@5

# Python
pip install py-clob-client
3

初始化 CLOB 客戶端並衍生 API 金鑰

第一次執行時,SDK 會用私鑰衍生(或建立)L2 API 憑證(key, secret, passphrase),後續所有交易請求都用這組憑證的 HMAC 簽名認證。

TypeScript 客戶端初始化
import { ClobClient } from "@polymarket/clob-client";
import { ethers } from "ethers";

const wallet = new ethers.Wallet(process.env.PRIVATE_KEY!);
const client = new ClobClient(
  "https://clob.polymarket.com",
  137,  // Polygon Mainnet chainId
  wallet,
  undefined,
  0,       // signatureType: 0=EOA, 1=Proxy, 2=Safe, 3=Deposit
  funderAddress
);

// 衍生或建立 L2 API 憑證
let creds = await client.deriveApiKey().catch(() => null);
if (!creds) creds = await client.createApiKey();
4

監控目標錢包活動

透過 Data API 輪詢或 WebSocket 偵測目標錢包的新交易。建議同時採用:WebSocket 提供最低延遲(毫秒級),REST 輪詢作為備援以確保不漏單。

Python REST 輪詢偵測新單
import requests, time

TARGET = "0xTARGET_WALLET"
last_seen = int(time.time()) - 60

while True:
    resp = requests.get(
        "https://data-api.polymarket.com/activity",
        params={"user": TARGET, "type": "TRADE",
                "limit": 50, "start": last_seen}
    )
    trades = resp.json()
    for t in trades:
        handle_new_trade(t)
    last_seen = int(time.time())
    time.sleep(2)  # 每 2 秒輪詢一次
5

計算比例倉位並送出訂單

偵測到目標交易後,根據您的資金規模換算下單金額,查詢即時訂單簿確認流動性,再送出 FOK(Fill or Kill)或 GTC 訂單。

TypeScript 下單核心邏輯
async function executeCopyTrade(trade: Trade) {
  // 1. 計算比例金額(POSITION_MULTIPLIER = 0.1 代表跟 10%)
  const copySize = trade.size * POSITION_MULTIPLIER;
  if (copySize < MIN_TRADE_SIZE || copySize > MAX_TRADE_SIZE) return;

  // 2. 風控檢查
  const check = riskManager.checkTrade(trade, copySize);
  if (!check.allowed) { console.warn(check.reason); return; }

  // 3. 取得當前市場價格
  const { price } = await clobClient.getPrice(trade.tokenId, "buy");
  const priceWithSlippage = price * (1 + SLIPPAGE_TOLERANCE);

  // 4. 建立並簽署訂單
  const order = await clobClient.createOrder({
    tokenID: trade.tokenId,
    price: priceWithSlippage,
    side: "BUY",
    size: copySize / priceWithSlippage,  // 換算股數
  });

  // 5. 送出訂單(FOK 模式)
  return await clobClient.postOrder(order, OrderType.FOK);
}
6

部署到低延遲 VPS(24/7 運行)

本地電腦運行不可靠且延遲高。推薦部署到靠近 Polymarket API 伺服器的 VPS(愛爾蘭 Dublin 或美國東岸),可實現 0.4–0.8ms 延遲。使用 PM2 或 systemd 確保機器人持續運行並自動重啟。

Shell PM2 部署指令
# 使用 PM2 持久化運行(Node.js)
npm install -g pm2
pm2 start dist/index.js --name polymarket-bot
pm2 save
pm2 startup  # 設定開機自動啟動

# 查看日誌
pm2 logs polymarket-bot --lines 100
05

風險控管

自動化交易會放大錯誤,完善的風控機制是保本的關鍵。

高風險

私鑰洩漏

永遠不要把私鑰寫入程式碼或提交到 Git。使用 .env 環境變數,並為機器人建立專用錢包,與主錢包完全隔離。

高風險

策略漂移

您跟隨的交易者可能改變策略、提高風險偏好或停止交易。需定期重新評估目標錢包的績效,設定自動停止跟隨條件。

中風險

市場流動性不足

小市場可能因跟單下單導致嚴重滑點。下單前查詢訂單簿深度,設定最大可接受滑點(建議 ≤2%)。

中風險

智能合約風險

Polymarket 雖已經過審計,CLOB V2 仍是相對新的基礎設施。只存入可以承受全損的資金

低風險

API 限流

REST 輪詢過於頻繁會觸發限流。建議 REST 間隔 ≥2 秒,並實作指數退避重試機制(502/503/504)。

低風險

程式碼錯誤

務必在測試環境與小額資金下充分驗證。自動化會將程式錯誤的後果放大數十倍,上線前需完整審計。

風控參數建議設定

  • POSITION_MULTIPLIER:0.05–0.1(每筆跟隨目標交易金額的 5–10%)
  • MAX_TRADE_SIZE:單筆最高 $50–100 USDC(初期測試用)
  • MAX_SESSION_NOTIONAL:每日最高累計下單金額(e.g. $500 USDC)
  • MAX_PER_MARKET_NOTIONAL:單一市場最高曝險(e.g. $200 USDC)
  • SLIPPAGE_TOLERANCE:最大接受滑點 0.02(2%)
06

2026 生態工具推薦

善用現有工具,可大幅縮短開發時間並提升跟單品質。

工具 類型 功能亮點 適合對象
Stand.trade 鯨魚監控 追蹤聰明錢地址、即時推播加減倉通知 選擇跟單目標
Betmoar 資訊整合 全市場儀表板、Telegram/Discord 下單、即時新聞 重度交易者
Polytrader AI 自動化 LLM 運算合理機率、AI Agent 自主執行策略 AI 輔助交易
OpenClaw 無代碼 免寫程式建立跟單機器人、視覺化儀表板 非技術背景用戶
QuickNode RPC 節點 Polygon 高速 RPC 端點(含 HTTP + WSS) 開發者基礎設施
GitHub 開源 Bot 開源框架 可審計程式碼、Supabase + Python 實作 開發者自建
07

2026 最佳實踐清單

上線前請逐項確認,每一項都是血淚經驗的總結。

🔐 安全性

📡 技術基礎設施

📊 策略與風控

📝 監控與記錄

⚠️

法律免責聲明

預測市場交易在部分地區受到監管限制。Polymarket 對美國及其他特定地區的用戶設有地理封鎖。在建構並使用跟單機器人之前,請自行確認您所在地區的法律合規性。本指南僅供技術教育目的,不構成任何投資建議。