Communitygithub.com

mvanhorn/clawdbot-skill-polymarket

指尖上的 Polymarket 預測市場 – 查看賠率、追蹤投資組合、透過 AI 分析研究市場、比較市場及進行交易。涵蓋全部 4 個 Polymarket API:Gamma、CLOB、資料 API、RTDS WebSocket 和 Bridge。唯讀模式即刻可用(無需設定)。ClawHub 上最全面的預測市場技能。

clawdbot-skill-polymarket 是什麼?

這個 AI 代理技能將 Polymarket 預測市場的完整功能直接整合到終端機中,讓開發者和交易者可以透過自然語言查詢賠率、研究事件、比較市場、追蹤投資組合、串流即時資料、跨鏈橋接資金以及執行交易。它涵蓋 Polymarket 公開的所有五個 API(Gamma、CLOB、資料、RTDS WebSocket、Bridge),其中唯讀操作(瀏覽、搜尋、趨勢、分類)不需要任何設定即可立即使用,而進階功能(交易、訂單簿、價格歷史)則需要安裝 Polymarket CLI。該技能包含預先編寫的 Python 腳本,用於執行常見查詢(例如趨勢市場、搜尋、事件詳細資訊、價格歷史、訂單簿、投資組合和交易),所有交易在執行前都會顯示成本與費用明細,確保透明安全。此外,該技能支援「市場研究模式」(結合賠率分析與背景脈絡)、「市場比較模式」(並排顯示賠率與流動性),以及完整的投資組合儀表板(包含倉位、損益、未成交訂單和 USDC 餘額),使這成為一個功能強大的全方位 Polymarket 互動工具。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add mvanhorn/clawdbot-skill-polymarket

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Polymarket

從終端機查詢 Polymarket 預測市場並進行交易。瀏覽賠率、研究事件、比較市場、追蹤您的投資組合、串流即時資料、橋接資金以及執行交易 - 全都透過自然語言完成。

Polymarket 公開了 4 個獨立的 API 以及 Gamma 便利層。此技能涵蓋所有這些 API。

設定

唯讀指令可立即執行(無需安裝)。瀏覽、搜尋、趨勢、分類、市場研究和比較模式都使用公開的 Gamma API。

若要進行交易、查看訂單簿、價格歷史以及進階功能,請安裝 Polymarket CLI(Rust 二進位檔,v0.1.5 以上):

brew install polymarket/tap/polymarket-cli

若要交易,請設定錢包:

polymarket wallet create
polymarket approve set

或者手動設定 ~/.config/polymarket/config.json,加入您的私鑰。詳情請參閱 CLI 文件。

CLI 也提供互動式 REPL:

polymarket shell

在任何 CLI 指令中使用 --output json 可以輸出機器可讀的 JSON 格式,適用於腳本和管線處理。

指令

瀏覽市場(無需 CLI)

# 熱門/活躍市場(依 24 小時交易量排序)
python3 {baseDir}/scripts/polymarket.py trending

# 顯示更多熱門結果
python3 {baseDir}/scripts/polymarket.py trending --limit 20

# 依關鍵字搜尋市場
python3 {baseDir}/scripts/polymarket.py search "trump"

# 依 slug 取得特定事件
python3 {baseDir}/scripts/polymarket.py event "fed-decision-in-october"

# 依分類取得市場
python3 {baseDir}/scripts/polymarket.py category politics
python3 {baseDir}/scripts/polymarket.py category crypto
python3 {baseDir}/scripts/polymarket.py category sports
python3 {baseDir}/scripts/polymarket.py category tech
python3 {baseDir}/scripts/polymarket.py category entertainment
python3 {baseDir}/scripts/polymarket.py category science
python3 {baseDir}/scripts/polymarket.py category business

熱門市場儀表板(無需 CLI)

顯示一個分類儀表板,列出 Polymarket 上最熱門的市場。結合趨勢與分類篩選條件,建立完整的概覽。

# 完整熱門儀表板 - 依序執行這些指令以建立全貌:
python3 {baseDir}/scripts/polymarket.py trending --limit 10
python3 {baseDir}/scripts/polymarket.py category politics --limit 5
python3 {baseDir}/scripts/polymarket.py category crypto --limit 5
python3 {baseDir}/scripts/polymarket.py category sports --limit 5
python3 {baseDir}/scripts/polymarket.py category tech --limit 5

當使用者要求「儀表板」或「概覽」時,執行所有分類查詢,並以清晰的標題按區塊分組顯示結果。每個市場都要包含交易量和當前賠率。

市場研究模式(無需 CLI)

市場研究結合 Polymarket 賠率與情境分析。當使用者要求「研究」某個市場或希望進行超越單純賠率的深入分析時:

  1. 取得市場資料 - 使用搜尋或事件指令
  2. 分析賠率 - 市場隱含了什麼?是否存在優勢?
  3. 提供脈絡 - 運用您的知識解釋驅動賠率的因素
  4. 顯示歷史走勢 - 如果 CLI 可用,拉取價格歷史
  5. 與共識比較 - Polymarket 賠率與民調、專家意見或其他預測市場相比如何?
# 步驟 1:尋找市場
python3 {baseDir}/scripts/polymarket.py search "fed rate cut"

# 步驟 2:取得詳細事件資料
python3 {baseDir}/scripts/polymarket.py event "fed-rate-decision-march-2026"

# 步驟 3:如果 CLI 可用,取得價格歷史以顯示趨勢
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 步驟 4:檢查訂單簿深度以評估流動性
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

收集資料後,將研究結果綜合成結構化報告:

  • 目前賠率:支持/反對百分比及其含義
  • 交易量與流動性:這個市場有多少資金,流動性是否足夠進行交易?
  • 趨勢:賠率是上升還是下降?最近是否有任何異常波動?
  • 脈絡:哪些現實世界的事件或數據點正在驅動賠率?
  • 關鍵日期:市場何時會結算?即將到來的催化劑是什麼?
  • 風險因素:什麼可能導致突然的價格波動?

市場比較模式(無需 CLI)

並排比較相關市場。有助於發現套利機會、了解條件機率,或只是看看不同結果之間的關聯。

# 比較兩個或多個相關市場 - 分別搜尋每個市場
python3 {baseDir}/scripts/polymarket.py search "trump 2028"
python3 {baseDir}/scripts/polymarket.py search "desantis 2028"
python3 {baseDir}/scripts/polymarket.py search "newsom 2028"

當使用者要求「比較市場」或「並排比較賠率」時:

  1. 搜尋使用者提到的每個市場
  2. 以比較表格格式呈現賠率
  3. 註記交易量差異(交易量越高 = 賠率越可靠)
  4. 標記任何明顯的不一致之處(例如,機率加總應接近 100% 但實際上卻不是)
  5. 突顯相關結果之間的價差

將比較結果格式化為表格:

市場比較:2028 年總統大選

| 候選人    | 支持率   | 交易量  | 流動性  |
|-----------|----------|---------|---------|
| Trump     | 32.5%    | $4.2M   | 高      |
| DeSantis  | 18.1%    | $1.8M   | 中      |
| Newsom    | 12.4%    | $890K   | 中      |
| Harris    | 8.7%     | $2.1M   | 中      |

投資組合儀表板(需要 CLI + 錢包)

在一個畫面中查看您的完整投資組合,包含倉位、損益和未成交訂單。

# 檢視所有未平倉倉位
python3 {baseDir}/scripts/polymarket.py positions

# 檢視特定錢包的倉位
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

# 檢查 USDC 餘額
python3 {baseDir}/scripts/polymarket.py wallet-balance

# 檢查特定代幣的餘額
python3 {baseDir}/scripts/polymarket.py wallet-balance --token TOKEN_ID

# 列出所有未成交訂單
python3 {baseDir}/scripts/polymarket.py orders

當使用者要求「投資組合儀表板」或「我目前的狀況如何」時,執行所有三個指令(positions, wallet-balance, orders)並呈現統一的檢視:

  • 倉位:每個倉位顯示當前市場價格、您的進場價格(如果可用)以及未實現損益
  • USDC 餘額:可用於新交易的現金
  • 未成交訂單:待處理的限價訂單,包含價格和數量
  • 投資組合總價值:倉位價值 + USDC 餘額

訂單簿與價格(需要 CLI,無需錢包)

# 某個代幣的訂單簿
python3 {baseDir}/scripts/polymarket.py book TOKEN_ID

# 價格歷史(間隔:1m, 1h, 6h, 1d, 1w, max)
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1d

# 具有特定數據點數量的價格歷史
python3 {baseDir}/scripts/polymarket.py price-history TOKEN_ID --interval 1h --fidelity 48

錢包(需要 CLI)

polymarket wallet create
polymarket wallet show
polymarket wallet balance
polymarket wallet balance --token TOKEN_ID

交易(需要 CLI + 錢包)

所有交易都需要 --confirm 才能執行。沒有它,訂單只會預覽。這是一項安全功能 - 您總是可以在實際發生前看到會發生什麼事。

成本與費用透明化

在執行任何交易之前,技能會顯示:

  • 訂單類型:限價或市價
  • 方向:買入或賣出
  • 價格:您的限價(或市價單顯示「market」)
  • 數量:合約數量
  • 預估成本:限價單為價格 x 數量,市價單為美元金額
  • Polymarket 費用:Polymarket 對 CLOB(中央限價訂單簿)不收取任何交易費用
  • Gas 費用:鏈上操作(授權、拆分、贖回)需要在 Polygon 上使用 MATIC 作為 Gas。典型 Gas 費用:$0.01-0.05
# 預覽限價單(無 --confirm = 僅預覽)
python3 {baseDir}/scripts/polymarket.py trade buy --token TOKEN_ID --price 0.50 --size 10

# 執行限價單
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.50 --size 10

# 賣出限價單
python3 {baseDir}/scripts/polymarket.py --confirm trade sell --token TOKEN_ID --price 0.70 --size 10

# 市價單:以當前價格買入價值 $5 的合約
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --market-order --amount 5

# 僅掛單限價單(僅停留在訂單簿上,絕不吃單 - 2026 年 1 月後)
python3 {baseDir}/scripts/polymarket.py --confirm trade buy --token TOKEN_ID --price 0.45 --size 20 --post-only

訂單與倉位(需要 CLI + 錢包)

# 列出未成交訂單
python3 {baseDir}/scripts/polymarket.py orders

# 取消特定訂單
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel ORDER_ID

# 取消所有訂單
python3 {baseDir}/scripts/polymarket.py --confirm orders --cancel all

# 檢視倉位
python3 {baseDir}/scripts/polymarket.py positions
python3 {baseDir}/scripts/polymarket.py positions --address 0xYOUR_WALLET

API 參考

Polymarket 公開了 4 個不同的 API 以及 Gamma 便利層。每個都有不同的用途。

1. Gamma API (gamma-api.polymarket.com) - 公開,無需驗證

用於瀏覽和搜尋市場的高階便利 API。所有唯讀指令都使用此 API。

  • Base URL:https://gamma-api.polymarket.com
  • GET /events - 列出事件(參數:order, ascending, closed, limit, tag_slug)
  • GET /search - 搜尋市場(參數:query, limit)
  • GET /events/slug/{slug} - 依 slug 取得事件
  • GET /comments - 列出並篩選市場上的評論
  • GET /profiles/{address} - 公開使用者個人資料
  • GET /series - 分組的事件集合(例如「2028 年選舉」系列)
  • GET /sports - 體育賽事元資料,包括隊伍、比賽和結算標準
  • GraphQL:POST /query - 完整的 GraphQL 端點,支援訂閱

2. CLOB API (clob.polymarket.com) - 交易

中央限價訂單簿 API,用於所有交易操作。由 Polymarket CLI 封裝。

  • Base URL:https://clob.polymarket.com
  • GET /prices-history - 歷史價格(間隔:1m, 1h, 6h, 1d, 1w, max)
  • GET /spread - 某個代幣的買賣價差
  • GET /fee-rate - 費用結構詳情
  • GET /rewards - 每日掛單方/吃單方收益
  • POST /order - 下單
  • POST /orders - 批量訂單(每次請求最多 15 筆)
  • DELETE /order/{id} - 取消訂單
  • 訂單評分 - 在下單前檢查掛單方返傭資格
  • 僅掛單訂單(2026 年 1 月) - 僅停留在訂單簿上,絕不穿過價差
  • 心跳 API(2026 年 1 月):
    • POST /heartbeat - 必須在 10 秒內發送,否則所有未成交訂單會自動取消
    • 由做市商用來維持訂單存在
    • 如果心跳中斷,該 API 金鑰的所有掛單將被取消

3. 資料 API (data-api.polymarket.com) - 投資組合與分析

專用於投資組合追蹤、交易歷史和市場分析的 API。公開端點無需驗證。

  • Base URL:https://data-api.polymarket.com
  • GET /positions?user={address} - 當前未平倉倉位
    • 排序依據:TOKENS, CURRENT, INITIAL, CASHPNL, PERCENTPNL
  • GET /closed-positions?user={address} - 歷史已平倉倉位
  • GET /activity?user={address} - 活動動態
    • 類型:TRADE, SPLIT, MERGE, REDEEM, REWARD
  • GET /value?user={address} - 以美元計價的投資組合估值
  • GET /trades - 交易歷史
    • 篩選依據:user, market, side
    • 每頁最多 500 筆結果
  • GET /holders?market={conditionId} - 某個市場的前幾大代幣持有者
  • GET /oi - 市場間的未平倉量
  • GET /volume - 市場間的交易量
  • GET /leaderboard - 交易者排名(可配置時間週期)

使用資料 API 建立投資組合儀表板和分析。它提供比 CLOB API 更豐富的倉位資料,包括損益計算和活動歷史。

4. RTDS WebSocket (wss://ws-live-data.polymarket.com) - 即時串流

透過 WebSocket 即時串流資料。訂閱主題以獲取即時更新,無需輪詢。

  • URL:wss://ws-live-data.polymarket.com
  • 協定:透過 WebSocket 傳輸的 JSON 訊息
  • 主題:
    • comments - 即時評論活動
      • 事件:comment_created, comment_removed, reaction_created, reaction_removed
    • crypto_prices - 即時加密貨幣價格
      • 資產:BTC, ETH, SOL, XRP
      • 來源:Binance + Chainlink 預言機
  • 動態訂閱管理 - 在單一連線內即時訂閱和取消訂閱主題
  • 適合用於建立即時儀表板、監控評論情緒或追蹤輸入 5 分鐘加密貨幣市場的加密貨幣價格

5. 跨鏈橋 API (bridge.polymarket.com) - 跨鏈存款與提款

在多個鏈之間將資金橋接進出 Polymarket。

  • Base URL:https://bridge.polymarket.com
  • POST /deposit - 產生存款地址
    • 支援的鏈:EVM(以太坊、Polygon、Arbitrum 等)、Solana、Bitcoin
    • 返回所選鏈的專屬存款地址
  • POST /withdraw(2026 年 1 月) - 將 USDC.e 橋接到任何支援的鏈
  • GET /supported-assets - 列出所有支援的資產和鏈
  • GET /quote - 取得跨鏈橋接報價(費用、預計時間)

當使用者需要在不離開終端機的情況下將資金移入或移出 Polymarket 時,請使用跨鏈橋 API。


新市場類型

  • 5 分鐘加密貨幣市場(2026 年 2 月) - 關於 BTC/ETH/SOL 價格變動的超短期市場。由 RTDS crypto_prices 資料提供。
  • 體育賽事市場 - 透過 Gamma /sports 端點提供的專用體育賽事元資料,包含隊伍資訊、比賽時間表和結算標準。

錯誤復原

API 錯誤(Gamma API)

如果 Gamma API 返回錯誤或無法連線:

  • HTTP 429(速率限制) - 等待幾秒鐘後重試。避免在短時間內發送大量請求。
  • HTTP 500(伺服器錯誤) - Polymarket 伺服器可能暫時關閉。等待並重試。
  • 連線逾時 - 檢查您的網路連線。如果持續失敗,請稍後再試。

CLI 錯誤

如果 CLI 無法運作:

  • 未找到指令:確認已安裝 Polymarket CLI(which polymarket)。如果未安裝,請執行 brew install polymarket/tap/polymarket-cli。
  • 錢包錯誤:確認 ~/.config/polymarket/config.json 存在且包含有效的私鑰。如果沒有,請執行 polymarket wallet create。
  • 餘額不足:檢查 USDC 餘額。在 Polygon 上可能需要 MATIC 作為 Gas。
  • 訂單失敗:檢查代幣 ID 是否正確,以及市場是否仍在交易中。有些市場可能會已結算或關閉。

資料不一致

  • 不同 API 之間的價格差異:Gamma API 價格可能會有短暫延遲。CLOB API 始終顯示最新價格。
  • 投資組合價值:資料 API 的投資組合估值可能延遲幾分鐘。對於即時損益,請使用 CLOB API 的價格。

一般提示

  • 大量使用 --limit 以避免要求過多資料
  • 比較市場時,先檢查交易量 - 低交易量市場的價格可能不可靠
  • 在執行大額交易前,請務必預覽(不使用 --confirm)
  • 5 分鐘加密貨幣市場波動極大 - 下單前請檢查倒數計時
  • WebSocket 連線應包含錯誤處理以處理重新連線

隱私與安全性

此技能透過 Polymarket 公開 API 運作。不會儲存或分享您的錢包資訊。當您使用 CLI 進行錢包操作或交易時,所有動作都在您自己的機器上發生。您的私鑰永遠不會離開您的組態檔案。

支援

如需幫助,請在 ClawHub 上提交問題或加入 Polymarket Discord。

相關技能