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 賠率與情境分析。當使用者要求「研究」某個市場或希望進行超越單純賠率的深入分析時:
- 取得市場資料 - 使用搜尋或事件指令
- 分析賠率 - 市場隱含了什麼?是否存在優勢?
- 提供脈絡 - 運用您的知識解釋驅動賠率的因素
- 顯示歷史走勢 - 如果 CLI 可用,拉取價格歷史
- 與共識比較 - 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"
當使用者要求「比較市場」或「並排比較賠率」時:
- 搜尋使用者提到的每個市場
- 以比較表格格式呈現賠率
- 註記交易量差異(交易量越高 = 賠率越可靠)
- 標記任何明顯的不一致之處(例如,機率加總應接近 100% 但實際上卻不是)
- 突顯相關結果之間的價差
將比較結果格式化為表格:
市場比較: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。