在 Polymarket 建構 AI 交易代理。 從環境設定到部署，涵蓋技術架構、提示工程與風險控管。

Polymarket：預測市場的運作機制

預測市場把「未來事件的機率」轉換成可交易資產。以下先釐清核心術語，再說明它與一般賭博平台的結構差異。

Polymarket 是建構在 Polygon 區塊鏈上、以 USDC 結算的去中心化預測市場。每一個「市場」是一個是非題：「BTC 會在 2026 年 6 月前突破 15 萬美元嗎？」「川普會贏 2024 大選嗎？」「2026 年 6 月歐冠決賽誰會贏？」每一題產生兩個獨立的 ERC-1155 代幣，一個代表「Yes」結果，一個代表「No」結果。價格介於 0 到 1 美元之間，可解讀為市場對該事件發生機率的估計。

當你買入「Yes」代幣，本質上是付錢給願意在事件不發生時收下這筆錢的對手方。如果事件真的發生，每一張代幣的最終結算價是 $1，差額就是你的利潤。價格 $0.65 意味著市場認定 65% 的機率，你買進就是在賭實際機率 高於 65%。

交易者下注的對象是市場標出的機率是否偏離真實機率，而非事件本身的結果。混淆這兩者是散戶虧損最常見的原因。 — Lookonchain，分析 35 天虧 200 萬美元的交易者

三個必須記住的概念

進場前需要了解的市場現況數據

以下數字來自 Bloomberg、Dune Analytics 及多份學術論文的交叉驗證。在寫第一行程式碼前，請先消化這些資訊。

2025 年初至今，超過 10 萬個錢包在 Polymarket 上虧損達 $1,000 以上，幾乎是同期獲利 $1,000 以上錢包數量的兩倍。在獲利帳號中，利潤高度集中於行為類似自動化機器人的少數帳號。其餘帳號合計虧損約 1.31 億美元。

多倫多大學的 Charles Martineau 教授分析了 2022 年以來的資料，發現約 69% 的交易者在 Polymarket 上是虧損的，而頂端 1% 的帳號賺走了 75% 的利潤。這與散戶交易的一般研究結論一致。

機器人的優勢在於下單速度，而非預測準確率。散戶即使猜對結果，也因入場延遲、成交價格不佳而產生虧損。 — Joshua Della Vedova 教授，San Diego 大學

這直接影響架構決策：跑在筆電上、透過 REST API 呼叫 Claude 進行機率推理的代理，無法在 sub-100ms 套利場景中競爭（該場景由連接 Chainstack 私有 RPC 的機器人主導）。有效的替代方向是選擇需要語意判斷、對延遲容忍度較高的市場類型。

哪些是「人類 + AI」還有勝算的角落？

• 長尾市場：流動性低、機器人懶得寫專門邏輯的小型市場（例如冷門體育、文化事件）。
• 需要語意理解的市場：題目寫得模糊、需要讀 ToS 細則才能判斷如何結算的市場。
• 新聞驅動但延遲容忍的市場：解析時間以小時或天計，不是毫秒。
• 跨市場邏輯套利：「川普贏」和「共和黨贏」之間的數學關係出現破綻時。
• Endgame Sweep（終局清掃）：當市場價格 > 0.97 但結果幾乎確定，小資傳統散戶會搶著賣，留下 0.997 到 1.00 的小利潤給有耐心的人。

環境設定：依賴項目與初始化

以下以 Python 為例（SDK 最為成熟）。TypeScript 或 Rust 的流程邏輯相同，替換 SDK 名稱即可。

你需要的東西清單

• Python 3.9+ 與 venv / poetry / uv 擇一
• 一個有 USDC（在 Polygon 網路上）的 Polymarket 帳號
• 該帳號的私鑰（從 Polymarket 設定 → Private Key → Export 取得）
• Anthropic API key（如果你要用 Claude Opus / Sonnet 做推理）
• 一個你打死都不會把它 push 到 GitHub 的 .env 檔案

專案初始化

# 建立專案
mkdir polymarket-agent && cd polymarket-agent
python3 -m venv .venv
source .venv/bin/activate

# 安裝套件
pip install py-clob-client-v2 python-dotenv requests anthropic

# 建立 .env 檔案
cat > .env <<EOF
POLYMARKET_PRIVATE_KEY=0x...
POLYMARKET_FUNDER_ADDRESS=0x...
POLYMARKET_SIGNATURE_TYPE=1
ANTHROPIC_API_KEY=sk-ant-...
EOF

# 別忘了
echo ".env" >> .gitignore
echo "__pycache__/" >> .gitignore
echo "*.db" >> .gitignore

第一次握手：確認你能跟 CLOB 講話

import os
from dotenv import load_dotenv
from py_clob_client_v2 import ClobClient, ApiCreds

load_dotenv()

# Level 0：無驗證，只是 ping
client = ClobClient(host="https://clob.polymarket.com", chain_id=137)
print(client.get_ok(), client.get_server_time())

# Level 1：用私鑰，第一次會 derive API credentials
auth_client = ClobClient(
    host="https://clob.polymarket.com",
    chain_id=137,
    key=os.environ["POLYMARKET_PRIVATE_KEY"],
    signature_type=int(os.environ["POLYMARKET_SIGNATURE_TYPE"]),
    funder=os.environ["POLYMARKET_FUNDER_ADDRESS"],
)
creds = auth_client.create_or_derive_api_key()

# Level 2：完整驗證，可以下單
auth_client.set_api_creds(creds)
print("API credentials derived. You can now place orders.")

執行後應看到 ok 及伺服器時間。若出錯，最常見原因是 signature_type 設定不正確。Magic 帳號設為 1，MetaMask 設為 0。

從查詢市場到送出第一筆委託

每一個 token ID 後面都是真實資金。建議先以 $1–$5 的小單跑通完整流程，確認路徑正確後再討論策略。

步驟 1 — 用 Gamma 找市場

import requests, json

GAMMA = "https://gamma-api.polymarket.com"

resp = requests.get(f"{GAMMA}/markets", params={
    "closed": False,
    "active": True,
    "limit": 20,
    "order": "volume24hr",
    "ascending": False,
})
markets = resp.json()

for m in markets[:5]:
    print(m["question"])
    print(f"  24h vol: ${m.get('volume24hr', 0):,.0f}")
    print(f"  prices: {m.get('outcomePrices')}")
    print(f"  token_ids: {m.get('clobTokenIds')}")

步驟 2 — 讀真實訂單簿（不要相信 Gamma 的價格）

target = markets[1]
yes_token_id = json.loads(target["clobTokenIds"])[0]

book = auth_client.get_order_book(yes_token_id)
best_bid = float(book.bids[0].price) if book.bids else None
best_ask = float(book.asks[0].price) if book.asks else None
spread = (best_ask - best_bid) if (best_bid and best_ask) else None

print(f"Best bid: {best_bid} | Best ask: {best_ask} | Spread: {spread}")

步驟 3 — 掛一張小小的 maker 限價單

from py_clob_client_v2 import (
    OrderArgs, OrderType, PartialCreateOrderOptions, Side
)

# 在 best_ask 之下 2 cent 掛買單。如果有人 cross 到我們，就成交。
# 否則就被動等著，賺 maker rebate。
my_price = round(best_ask - 0.02, 2)
my_size = 5.0  # 5 股，$0.XX 一股，總金額很小

resp = auth_client.create_and_post_order(
    order_args=OrderArgs(
        token_id=yes_token_id,
        price=my_price,
        side=Side.BUY,
        size=my_size,
    ),
    options=PartialCreateOrderOptions(tick_size="0.01"),
    order_type=OrderType.GTC,
)

print(f"Order ID: {resp['orderID']}")
print(f"Status: {resp['status']}")

跑通了，你已經把一張單放上 Polymarket 的訂單簿。接下來的所有 AI 邏輯，最終都會走到這個 create_and_post_order 呼叫。

AI Agent 的五層架構拆解

將 Claude 直接接到 CLOB API 是一個腳本，不是代理。代理需要五個可獨立替換的功能層。

多個公開 Polymarket bot 的事後分析指向同一個結論：「導致虧損的原因通常不是推理能力不足，而是缺乏 event log。」以下架構表是這些案例收斂出的最小可行設計。

「Production discipline usually matters more than squeezing a bit more model accuracy.」
升級模型版本的效益有限。完善日誌系統的效益更為顯著。 — 多份 2026 Polymarket bot 後驗報告的共同結論

關鍵原則：分離「找機會」和「下單」

常見錯誤是把整個流程串成一個函式：get_markets → ask_claude → place_order。這會產生兩個問題：

• 無法回溯：當你某天虧了一筆，你不知道是 LLM 估錯機率、還是 prompt 拿到過期新聞、還是訂單簿在你下單前已經跑掉。
• 無法測試：你沒辦法把過去兩週的「假設我這樣做會怎樣」跑出來。沒有 backtest 就沒有迭代。

正確的做法：讓推理層只輸出結構化的「機率估計 + 推理」，把「要不要下單」交給一個獨立、純規則、可重現的決策函式。這樣你能用同一份 LLM 輸出在不同的決策參數下重跑歷史，找出最適合的閾值。

五種已有公開驗證記錄的交易策略

以下策略已有公開實作與回測記錄。建議先透徹理解現有策略，再考慮開發原創方法。

策略 A — Endgame Sweep（終局清掃）

當一個市場接近結算、結果幾乎確定（例如比賽進入第 90 分鐘且 5 比 0 領先），市場價格會逼近 $0.99。但很多小散戶會因為害怕「萬一」或想趕快了結，掛單在 $0.997、$0.998 賣出。有耐心的買家可以把這些單吃光，幾天後拿到 $1.00 結算，賺 0.2–0.5% 的無風險（在合理估計下）利潤。

實作要點：

• 只在剩餘時間 < 24 小時且結果幾乎確定的市場操作。
• 設定一個「Yes 機率 > 99%」的門檻，這是你的 LLM 要過的關卡。
• 下 GTD 單，到期時間設在結算前。
• 小心：少數結算會出意外（裁判更改判決、Oracle 爭議）。永遠保留風險預算。

策略 B — Logical Arbitrage（邏輯套利）

相關市場之間的數學關係有時會出現破綻。例如「川普贏」的價格低於「共和黨贏」的價格，在數學上不成立（除非存在非川普的共和黨候選人）。同時做空高估方、做多低估方，即可鎖定價差。

另一個常見組合：「Trump wins AZ」 + 「Trump wins NV」 + ... 的加總應該約等於「Trump wins 270+」。差異就是套利空間。

策略 C — Latency Arbitrage（延遲套利）

對加密相關市場（「BTC 月底前破 X 美元」），CEX 上的 BTC 現貨價格通常領先 Polymarket 上的隱含機率幾秒鐘到幾分鐘。建一個 log-normal 定價模型，把 BTC 即時價格轉換成預測市場的隱含機率，價差出現時下單。

缺點：這個賽道已經非常擁擠。sub-100ms 機器人吃掉了 73% 的套利利潤。你需要私有 RPC（Chainstack、QuickNode）才有勝算。不適合剛入門。

策略 D — Copy Trading Whales（鯨魚跟單）

因為 Polymarket 所有交易都鏈上公開，你可以挑出歷史 PnL 高的錢包，每當他們開新倉，你跟一小部分。工具像 PolyTrack、Stand.trade、Polymarket Analytics 都提供 whale alerts。

缺點：頂尖鯨魚（例如 Fredi9999 / Theo）會用多個錢包混淆軌跡，你可能在跟錯人。而且當鯨魚自己也在用機器人時，等你的腳本看到鏈上事件，價格已經被另一群跟單機器人推高了。

策略 E — Nothing Ever Happens（NO 基準策略）

因為 Polymarket 上 73.3% 的市場最終以 NO 結算，理論上盲買所有 NO 應有正期望值。Sterling Crispin 的開源 bot 測試了這個假設，結果仍虧損，原因是 NO 的開盤價已把這個基準率定價進去了。

此策略的教學意義在於：迫使開發者明確定義一個簡單盲策略需要什麼條件才能獲利。Crispin 後來的修正版本是「只買 $0.65 以下的 NO」，在統計上具備正期望的可能性。

風險控管：kill switch 與部位限制

Lookonchain 分析的案例：35 天虧損 200 萬美元的交易者勝率為 51%，預測能力並非問題所在。根本原因是單筆部位過大，且缺乏自動停損機制。

四個你必須寫進程式的硬限制

Kill Switch — 一個檔案就能殺死整個 agent

import os, sys, time

KILL_FILE = "/tmp/polymarket_agent.kill"
DAILY_LOSS_LIMIT = 0.10  # 10% of bankroll

def should_continue(state):
    # 1. 檔案 kill switch（人類緊急停止）
    if os.path.exists(KILL_FILE):
        print("Kill file detected. Shutting down.")
        return False
    
    # 2. 當日虧損
    today_pnl_pct = state.today_pnl / state.starting_balance
    if today_pnl_pct < -DAILY_LOSS_LIMIT:
        print(f"Daily loss limit hit: {today_pnl_pct:.1%}. Halting.")
        return False
    
    # 3. API 連線健康度
    if state.consecutive_api_errors > 5:
        print("Too many API errors. Halting.")
        return False
    
    return True

# 在主迴圈裡每次決策前呼叫
while True:
    if not should_continue(agent_state):
        sys.exit(0)
    run_decision_cycle()
    time.sleep(60)

代理在運行中必然遇到異常狀況。此時需要的不是更複雜的程式邏輯，而是一個執行 touch /tmp/polymarket_agent.kill 即可讓系統優雅停止的機制。

社群回饋：r/polymarket 高品質建議彙整

r/polymarket（5 萬會員）、X 上的預測市場討論及 Crypto Twitter 是官方文件之外的重要資訊來源，但也包含大量未經驗證的說法。以下為過濾後的實用建議。

社群普遍的真實建議（過濾後）

社群一致警告：別碰這些

• 付費「signal」群組：99% 是賣鏟子的，1% 真的會贏的人不會收你一個月 $50。
• 「copy trade everything Theo does」的傻瓜 bot：頂尖鯨魚使用多錢包混淆軌跡，你跟到的可能只是煙幕。
• 沒有 paper trade 期的「上線就賺」承諾：見過太多 GitHub 上幾百顆星的 bot 跑兩週就虧光。
• 把私鑰餵給雲端 IDE 或 ChatGPT：直接破產、永無翻身餘地。

Reddit 上品質較高的分析多半出現在重大事件結束後數日。事件期間的熱門貼文情緒成分高，應視為噪音處理。 — PolyTrack Reddit Guide 2026

執行前必須確認的法律與合規事項

技術可行性與法律合規性是兩個獨立問題。本節列出需要向法律顧問確認的具體事項，不構成法律意見。

• 美國公民被明確禁止：使用 VPN 繞過 geofence 違反 ToS，且可能讓你的資金被凍結。
• 許多其他司法管轄區也限制：包括法國、新加坡、比利時等。請先確認你的所在地。
• 稅務責任：在你所在地，預測市場利潤通常被視為一般所得或資本利得。鏈上記錄是公開的，假裝它不存在不是策略。
• 市場操縱風險：如果你的 bot 同時下大量單造成價格大幅變動，可能觸法。即使在加密市場，這類行為的法律灰色地帶正在快速縮小。
• 內線資訊：如果你在某個事件中擁有非公開資訊（例如體育場內人員、政治幕僚），用它來下注在許多司法管轄區可能構成詐欺。

從環境設定到部署的六週里程碑

以下是壓縮版時程表，每週有明確的可交付物。第四週的「paper trade」階段是最常被跳過的步驟，也是最能避免資金損失的環節。