Polymarket CLI

直接使用 polymarket 二进制文件。默认优先使用只读命令，使用 -o json 获取结构化输出，并将任何交易或链上操作视为敏感操作。

安全规则

切勿读取 ~/.config/polymarket/config.json 或任何可能包含私钥的文件。

切勿自行运行钱包管理命令。用户必须直接运行以下命令：

• - polymarket wallet create
• polymarket wallet import
• polymarket wallet show
• polymarket wallet reset
• polymarket wallet address
• polymarket setup

在运行任何可能执行以下操作的命令前需征得同意：

• - 下单、修改或取消订单
• 批准合约
• 拆分、合并、赎回或桥接资产
• 创建/删除 API 密钥或通知
• 写入私钥或配置

无需额外确认即可安全运行：

• - markets、events、tags、series、comments、profiles、sports
• 只读 clob 命令，如 book、price、midpoint、spread、price-history、market
• 用于钱包、市场、持有者、交易量、排行榜的公共 data 命令
• 健康检查/版本/帮助命令

只读认证命令仅在不会泄露秘密且不修改状态时才允许使用。

快速开始

首先检查可用性：

bash
polymarket --help
polymarket --version

为代理工作使用 JSON：

bash
polymarket -o json markets list --limit 5
polymarket -o json markets search bitcoin --limit 5
polymarket -o json clob midpoint TOKEN_ID

个性化工作流程

研究市场

当用户希望快速了解市场但不进行交易时使用此流程。

1. 1. 搜索可能的候选市场：

bash
polymarket -o json markets search QUERY --limit 10

1. 2. 选择最相关的 slug 或代币化市场。
2. 如有需要，查看详细信息：

bash
polymarket -o json markets get MARKETIDOR_SLUG

1. 4. 如果代币 ID 可用，查看价格/动态：

bash
polymarket -o json clob midpoint TOKEN_ID
polymarket -o json clob spread TOKEN_ID
polymarket -o json clob book TOKEN_ID
polymarket -o json clob price-history TOKEN_ID --interval 1d --fidelity 30

总结内容包括：问题、当前赔率、价差/流动性提示、近期价格背景以及任何明显的注意事项。

安全查看钱包

当用户希望查看敞口、盈亏状态或活动但不做任何更改时使用此流程。

bash
polymarket -o json data positions 0xWALLET
polymarket -o json data value 0xWALLET
polymarket -o json data trades 0xWALLET --limit 50

如果本地配置的钱包相关且用户需要账户状态，使用不会泄露秘密的只读认证检查：

bash
polymarket -o json clob balance --asset-type collateral
polymarket -o json clob orders
polymarket -o json clob trades
polymarket approve check

不要运行 wallet show；告知用户自行运行钱包管理命令。

安全下达限价单

在用户确认以下所有信息前不要运行：

• - 市场或代币
• 方向（buy/sell）
• 价格
• 数量或金额
• 是否仅做挂单

推荐顺序：

bash

1) 首先验证市场背景

polymarket -o json clob midpoint TOKEN_ID
polymarket -o json clob spread TOKEN_ID
polymarket -o json clob book TOKEN_ID

2) 确认后再下单

polymarket clob create-order --token TOKEN_ID --side buy --price 0.50 --size 10

在执行前向用户复述完整订单信息。

常见任务

浏览市场和事件

bash
polymarket markets list --limit 10
polymarket markets search election --limit 5
polymarket markets get MARKETIDOR_SLUG
polymarket events list --limit 10
polymarket events get EVENT_ID

查看 CLOB 价格/动态

bash
polymarket clob ok
polymarket clob book TOKEN_ID
polymarket clob midpoint TOKEN_ID
polymarket clob spread TOKEN_ID
polymarket clob price-history TOKEN_ID --interval 1d --fidelity 30

查看公共钱包/市场数据

bash
polymarket data positions 0xWALLET
polymarket data value 0xWALLET
polymarket data trades 0xWALLET --limit 50
polymarket data holders 0xCONDITION_ID
polymarket data open-interest 0xCONDITION_ID
polymarket data leaderboard --period month --order-by pnl --limit 10

钱包和设置

钱包管理命令仅限用户操作。请勿自行运行。如果用户需要设置帮助，告知他们应在本地运行哪个命令。

bash

仅限用户操作

polymarket setup
polymarket wallet create
polymarket wallet import 0xPRIVATE_KEY
polymarket wallet show

代理可运行只读审批检查

polymarket approve check

代理在进行任何链上审批写入前必须征得同意

polymarket approve set

交易

仅在确认后运行。

bash
polymarket clob create-order --token TOKEN_ID --side buy --price 0.50 --size 10
polymarket clob market-order --token TOKEN_ID --side buy --amount 5
polymarket clob orders
polymarket clob cancel ORDER_ID
polymarket clob cancel-all

工作风格

1. 1. 优先进行只读探索。
2. 如果用户想要交易，在运行任何操作前验证确切的代币/市场、方向、数量/金额和价格。
3. 对于脚本和摘要，使用 -o json 并解析结果。
4. 如果命令失败，在相关子命令上使用 --help 重新运行以查看参数。
5. 如果 CLI 缺失，告知用户如何安装：

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

参考

当需要更完整的命令清单或提醒哪些区域是只读 vs 敏感时，请阅读 references/command-map.md。