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 检查事件详情（包含 tokens）：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。按以下顺序解析（Agent 无关，不依赖任何运行时）：

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）。