Polymarket CLI

Operate Polymarket from terminal with the `polymarket` Rust CLI (v0.1.5). Covers market/event/tag/series discovery, CLOB order book queries (single & batch), wallet & approval management, order placement/cancelation (GTC/FOK/GTD/FAK), portfolio & on-chain data, CTF operations, rewards/earnings, bridge deposits, sports metadata, API key management, and JSON output for automation.

使用本技能时，按用户目标直接执行对应命令；默认先收集必要参数并返回可复现结果。

快速决策

1. 先判断请求类型：
   • 只读：市场浏览、价格、盘口、持仓查询、历史数据、tags/series/comments、sports、rewards 查询。
   • 写操作：下单、撤单、approve、split/merge/redeem、API key 管理、bridge deposit、wallet reset。
2. 只读请求可直接执行。
3. 写操作先做预检（余额/参数/网络），然后执行并回读结果。

环境检查与安装

按顺序执行：

bash

polymarket --version

若未安装，优先一键脚本：

bash

curl -sSL https://raw.githubusercontent.com/Polymarket/polymarket-cli/main/install.sh | sh

或 Homebrew：

bash

brew tap Polymarket/polymarket-cli https://github.com/Polymarket/polymarket-cli
brew install polymarket

无法使用以上方式时，回退源码安装：

bash

git clone https://github.com/Polymarket/polymarket-cli
cd polymarket-cli
cargo install --path .

标准执行流程

1) 读取需求并标准化参数

最少明确：

• 市场标识（slug / market id / condition id / token id）
• 方向与数量（buy/sell, amount/size）
• 价格类型（limit/market）
• 输出格式（table/json）

如要脚本集成，统一使用：-o json。

2) 只读查询模式（默认）

常用命令：

bash

polymarket markets search "bitcoin" --limit 5
polymarket markets get <slug-or-id>
polymarket clob book <TOKEN_ID>
polymarket clob midpoint <TOKEN_ID>
polymarket clob spread <TOKEN_ID>
polymarket -o json clob price-history <TOKEN_ID> --interval 1d

# 批量查询
polymarket clob batch-prices <TOKEN_ID1>,<TOKEN_ID2>
polymarket clob books <TOKEN_ID1>,<TOKEN_ID2>

# 元数据
polymarket tags list
polymarket series list
polymarket comments list --event <EVENT_ID>

3) 交易前预检

全局选项（所有子命令均可用）：

• --private-key <KEY> — 覆盖环境变量/配置文件中的私钥
• --signature-type <TYPE> — 签名类型：eoa（默认）、proxy、gnosis-safe

执行：

bash

polymarket wallet show
polymarket approve check
polymarket clob balance --asset-type collateral
polymarket clob account-status

核对点：

• 钱包地址是否符合预期
• 是否完成 approvals
• 是否有足够 USDC / MATIC（链上写操作 gas）
• 签名类型是否匹配（proxy 钱包需要 --signature-type proxy）

4) 写操作执行

示例：

bash

# 限价单
polymarket clob create-order --token <TOKEN_ID> --side buy --price 0.50 --size 10
# 指定 order type
polymarket clob create-order --token <TOKEN_ID> --side buy --price 0.50 --size 10 --order-type FOK
# 仅挂单
polymarket clob create-order --token <TOKEN_ID> --side sell --price 0.60 --size 5 --post-only

# 市价单
polymarket clob market-order --token <TOKEN_ID> --side buy --amount 5

# 批量下单
polymarket clob post-orders <JSON_FILE>

# 撤单
polymarket clob cancel <ORDER_ID>
polymarket clob cancel-orders <ORDER_ID1>,<ORDER_ID2>

# 授权
polymarket approve set

# Bridge 充值
polymarket bridge deposit

执行后立即回读验证：

bash

polymarket clob orders
polymarket clob order <ORDER_ID>
polymarket clob trades

输出约定

• 给人看：table（默认）
• 给程序：json（-o json）
• 失败时：记录命令、stderr、退出码；不要静默吞错。

参考资料

• 命令速查：references/commands.md
• 故障排查：references/troubleshooting.md