🗒️#0151 Polymarket CLI 完整功能参考
type
Post
status
Published
date
Jan 5, 2025
slug
polymarketcli
summary
tags
钱包
区块链
category
加密货币
icon
password
Polymarket CLI 完整功能参考
CLI 路径:
~/.local/bin/polymarket全局选项:
-o json (JSON输出) / -o table (表格输出)📋 功能总览
模块 | 功能 | 是否需要认证 | 当前项目是否使用 |
markets | 市场数据（列表/搜索/详情） | ❌ | ✅ 使用中 |
events | 事件数据（列表/详情/按标签筛选） | ❌ | ❌ |
tags | 标签管理（分类体系） | ❌ | ❌ |
series | 系列数据 | ❌ | ❌ |
comments | 评论数据 | ❌ | ❌ |
profiles | 用户公开资料 | ❌ | ❌ |
clob | 订单簿/实时价格/交易 | 查询❌ 交易✅ | ❌ |
data | 链上数据（持仓/交易/排行榜） | ❌ | ❌ |
sports | 体育元数据 | ❌ | ❌ |
1️⃣ markets — 市场数据 (当前使用)
markets list — 列表市场
参数 | 说明 | 默认值 |
--active <true/false> | 按活跃状态过滤 | - |
--closed <true/false> | 按关闭状态过滤 | - |
--limit <N> | 最大结果数 | 25 |
--offset <N> | 分页偏移 | 0 |
--order <FIELD> | 排序字段 (如 volume_num, liquidity_num) | - |
--ascending | 升序排列 | 默认降序 |
markets get <ID> — 获取单个市场
markets search <QUERY> — 搜索市场
markets tags <ID> — 获取市场的标签
📦 Market 返回字段（实际 JSON 样本）
2️⃣ events — 事件数据
💡 Events = 上层概念，一个 Event 可以包含多个 Markets
events list — 列表事件
参数 | 说明 |
--active <true/false> | 按活跃状态过滤 |
--closed <true/false> | 按关闭状态过滤 |
--limit <N> | 最大结果数 (默认25) |
--offset <N> | 分页偏移 |
--order <FIELD> | 排序 (如 volume, liquidity, created_at) |
--ascending | 升序排列 |
--tag <SLUG> | 按标签筛选 (如 politics, crypto) |
events get <ID> — 获取单个事件
events tags <ID> — 获取事件标签
3️⃣ tags — 标签/分类
tags list — 列出所有标签
返回所有分类标签，如: Health and Human Services, Madrid Open, Crypto Summit 等
tags get <ID> — 获取标签详情
tags related <ID> — 获取关联标签关系
tags related-tags <ID> — 获取关联标签对象
4️⃣ series — 系列数据
series list — 列出系列
series get <ID> — 获取系列详情
5️⃣ comments — 评论数据
comments list — 列出评论
可按 event/market/series 过滤
comments get <ID> — 获取评论详情
comments by-user <ADDRESS> — 按钱包地址查用户评论
6️⃣ profiles — 用户资料
profiles get <ADDRESS> — 获取公开资料
按钱包地址查询用户公开信息
7️⃣ clob — 订单簿 & 实时交易数据 ⭐
最丰富的实时数据模块，可获取价格、订单簿、历史价格等
价格查询（无需认证）
命令 | 说明 | 参数 |
clob price <TOKEN_ID> --side buy/sell | 获取买/卖价格 | token_id + side |
clob batch-prices | 批量价格查询 | 多个token_id |
clob midpoint <TOKEN_ID> | 获取中间价 | token_id |
clob midpoints | 批量中间价 | 多个token_id |
clob spread <TOKEN_ID> | 买卖价差 | token_id |
clob spreads | 批量价差 | 多个token_id |
clob last-trade <TOKEN_ID> | 最后成交价 | token_id |
clob last-trades | 批量最后成交价 | 多个token_id |
订单簿（无需认证）
命令 | 说明 |
clob book <TOKEN_ID> | 获取某 token 的完整订单簿 |
clob books | 批量订单簿 |
价格历史（无需认证）⭐
参数 | 可选值 |
--interval | 1m, 1h, 6h, 1d, 1w, max |
--fidelity | 数据点数量 |
市场信息（无需认证）
命令 | 说明 |
clob market <CONDITION_ID> | 获取 CLOB 市场信息 |
clob markets | 列出 CLOB 市场 |
clob sampling-markets | 奖励资格市场列表 |
clob simplified-markets | 简化市场列表 |
clob tick-size <TOKEN_ID> | 获取 tick size |
clob fee-rate <TOKEN_ID> | 获取费率 |
clob neg-risk <TOKEN_ID> | 检查 neg-risk 状态 |
交易操作（需要认证 🔒）
命令 | 说明 |
clob create-order | 创建限价单 |
clob market-order | 创建市价单 |
clob post-orders | 批量下单 |
clob cancel | 取消订单 |
clob cancel-all | 取消所有订单 |
clob orders | 查看挂单 |
clob trades | 查看成交 |
clob balance | 查看余额 |
奖励系统（需要认证 🔒）
命令 | 说明 |
clob rewards | 奖励收益列表 |
clob earnings | 某日总收益 |
clob current-rewards | 当前奖励计划 |
clob market-reward | 市场奖励详情 |
clob order-scoring | 订单是否在获取奖励 |
8️⃣ data — 链上数据 & 排行榜 ⭐
钱包级数据
命令 | 说明 | 参数 |
data positions <ADDRESS> | 持仓列表 | 钱包地址 |
data closed-positions <ADDRESS> | 已关闭持仓 | 钱包地址 |
data value <ADDRESS> | 总持仓价值 | 钱包地址 |
data traded <ADDRESS> | 交易市场数量 | 钱包地址 |
data trades <ADDRESS> | 交易历史 | 钱包地址 + limit/offset |
data activity <ADDRESS> | 链上活动 | 钱包地址 + limit/offset |
市场级数据
命令 | 说明 | 参数 |
data holders <CONDITION_ID> | 持仓大户排名 | 市场condition ID + limit |
data open-interest <CONDITION_ID> | 未平仓合约量 | 市场condition ID |
data volume <EVENT_ID> | 实时交易量 | 事件ID |
排行榜
命令 | 说明 | 参数 |
data leaderboard | 交易者排行榜 | period: day/week/month/all, order-by: pnl/vol |
data builder-leaderboard | 做市商排行榜 | period: day/week/month/all |
data builder-volume | 做市商交易量时间序列 | - |
9️⃣ sports — 体育元数据
命令 | 说明 |
sports list | 支持的体育项目 |
sports market-types | 体育市场类型 |
sports teams | 球队列表 |
🔑 当前项目 vs CLI 能力对比
能力 | CLI 支持 | 项目当前使用 | 潜力 |
市场列表 (按交易量排序) | ✅ | ✅ | - |
价格/赔率 | ✅ | ✅ (outcomePrices) | CLOB 实时价格更精确 |
搜索市场 | ✅ | ❌ | 可做关键词监控 |
按标签/分类筛选 | ✅ (events --tag) | ❌ | 可做分类热榜 |
价格历史 | ✅ (clob price-history) | ❌ | 可做趋势分析/K线 |
订单簿深度 | ✅ (clob book) | ❌ | 可分析市场深度 |
买卖价差 | ✅ (clob spread) | ❌ | 可识别流动性差的市场 |
持仓大户 | ✅ (data holders) | ❌ | 可做鲸鱼监控 |
交易者排行榜 | ✅ (data leaderboard) | ❌ | 可跟踪聪明钱 |
链上交易历史 | ✅ (data trades) | ❌ | 可跟踪特定钱包 |
未平仓合约 | ✅ (data open-interest) | ❌ | 可分析市场情绪 |
实时交易量 | ✅ (data volume) | ❌ | 可做异常量监控 |
用户资料 | ✅ (profiles get) | ❌ | 可丰富鲸鱼信息 |
事件层级数据 | ✅ (events list) | ❌ | 去重更精确 |
下单/交易 | ✅ (clob create-order) | ❌ | 可做自动交易 |
Loading...