helebest/holo-polymarket

Polymarket 查詢

一個用於研究 Polymarket 預測市場的唯讀技能（絕不下單）。它涵蓋兩個需求：

• 市場研究：熱門事件、搜尋、事件細節、歷史價格與機率/交易量趨勢。
• 持倉與鯨魚追蹤：排行榜、任意地址的持倉與盈虧，以及交易歷史。

若要實際買入/賣出（下單、取消、餘額、訂單管理），請使用 polymarket-trade 技能。

快速入門

1. 檢查環境：bash、curl、jq，以及對 gamma-api.polymarket.com / data-api.polymarket.com / clob.polymarket.com 的存取權。
2. 選擇任務類型：市場資訊 / 鯨魚與持倉 / 歷史趨勢。
3. 執行對應的命令：bash <skill-dir>/scripts/polymarket.sh <command> [args...]。

完整命令列表：references/commands.md。疑難排解：references/troubleshooting.md。

選擇命令

• 快速市場熱度：hot [limit]
• 透過關鍵字尋找市場：search <keyword> [limit]
• 透過 slug 檢視事件細節（含代幣）：detail <event-slug>
• 追蹤頂級交易者 / 檢視持倉：leaderboard（別名 lb） → positions（別名 pos） → trades
  • 僅開放持倉：positions <address> [limit] --active
  • 自己的錢包：設定 POLYMARKET_FUNDER（或 FUNDER）後，當未提供地址時 positions / trades 將預設使用該地址。請使用您的代理錢包位址（持有資金/持倉的那個），而非簽署者/EOA。
• 時間序列檢視：
  • 機率表格：history
  • 開始/結束變化摘要：trend
  • 交易量變化：volume-trend
• 檔案匯出：在 history/trend/volume-trend 後加上 --format csv|json 及選擇性的 --out <file>。

基本範例

# 1) 熱門市場
bash <skill-dir>/scripts/polymarket.sh hot 5

# 2) 搜尋 + 細節
bash <skill-dir>/scripts/polymarket.sh search bitcoin 5
bash <skill-dir>/scripts/polymarket.sh detail fed-decision-in-march-885

# 3) 鯨魚與持倉追蹤
bash <skill-dir>/scripts/polymarket.sh lb 10 pnl week
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10
bash <skill-dir>/scripts/polymarket.sh pos 0xc257ea... 10 --active   # 僅開放持倉
bash <skill-dir>/scripts/polymarket.sh trades 0xc257ea... 10

# 4) 歷史趨勢 + 匯出
bash <skill-dir>/scripts/polymarket.sh history fed-decision-in-march-885 2025-01-01 2025-01-31 1d
bash <skill-dir>/scripts/polymarket.sh trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format csv
bash <skill-dir>/scripts/polymarket.sh volume-trend fed-decision-in-march-885 2025-01-01 2025-01-31 --format json --out /tmp/volume.json

參數規則：from/to 為 YYYY-MM-DD；interval 為 1h / 4h / 1d。

常見失敗

• 缺少相依套件：請安裝 curl / jq。
• 網路失敗：檢查 API 可達性與超時設定；必要時調高 CURL_TIMEOUT。在代理環境中，會自動偵測 HTTPS_PROXY。
• 歷史價格失敗：請檢查 POLYMARKET_BEARER_TOKEN 或憑證檔案（見下文）。
• 參數錯誤：重新確認命令用法與日期格式（YYYY-MM-DD）。

憑證（僅歷史價格端點需要）

歷史價格端點可能需要 bearer token。解析順序如下（與代理人無關，不限於特定執行環境）：

1. POLYMARKET_BEARER_TOKEN 環境變數
2. POLYMARKET_CREDENTIALS_FILE 指定的檔案
3. 專案目錄下的 ./.credentials（應加入 gitignore）
4. ~/.config/holo-polymarket/credentials
5. ~/.openclaw/credentials/polymarket_credentials（舊版備援）

憑證檔案格式為 KEY=VALUE，支援 BEARER_TOKEN / TOKEN 欄位。

同一個檔案（或環境變數）也可以提供 POLYMARKET_FUNDER / FUNDER — 您的代理錢包位址。設定後，若未在命令列提供地址，positions / trades 將預設使用該地址。這是查詢技能唯一會讀取的身分資訊；此處其他所有資料均為唯讀且公開。

交易邊界

此技能為唯讀，絕不下單。若要進行買入/賣出、取消、餘額及訂單管理，請使用 polymarket-trade 技能（基於官方 CLOB API）。