用途
Grimoire Polymarket 技能用于通过 polymarket 场所适配器进行 Polymarket 的市场发现、CLOB 市场数据查询以及订单管理操作。
主要能力
- 市场发现：使用规范命令 search-markets 按查询词、slug、问题、事件、标签、分类、联赛、体育项目等条件筛选市场，并支持只显示开放、只显示活跃、忽略结束日期、只显示可交易市场、分页等选项。
- 市场数据：通过受限的透传分组获取市场列表、单个市场、市场搜索、标签，以及仓位、交易、排行榜等数据。
- 订单管理：通过自定义动作类型 op="order" 下单，支持取消订单、批量取消、全部取消和心跳（heartbeat）等操作。
- 指标比较：在 spell 中通过 metric("mid_price", ...) 获取 CLOB 代币中间价用于比较。
使用方式
推荐调用形式：
- grimoire venue polymarket ...
- npx -y @grimoirelabs/cli venue polymarket ...（免安装）
- bun run packages/cli/src/index.ts venue polymarket ...（仓库本地）
- grimoire-polymarket ...（来自 @grimoirelabs/venues 的直接二进制）
建议的预检命令：
- grimoire venue doctor --adapter polymarket --json
- grimoire venue polymarket info --format json
规范 agent 命令包括 info 与 search-markets。允许的透传分组为 markets（list|get|search|tags）与 data（positions/value/leaderboards 等）。被屏蔽的分组包括 wallet、bridge、approve、ctf、setup、upgrade、shell。仍支持旧版兼容别名（如 market、book、midpoint、spread、price、order、trades、open-orders 等），但不建议在新流程中使用。
运行配置方面：适配器/运行时鉴权默认需要 POLYMARKET_PRIVATE_KEY；可选 API 凭证为 POLYMARKET_API_KEY、POLYMARKET_API_SECRET、POLYMARKET_API_PASSPHRASE；可选派生开关 POLYMARKET_DERIVE_API_KEY（默认 true）；可选签名路由 POLYMARKET_SIGNATURE_TYPE（0 EOA、1 POLY_PROXY、2 GNOSIS_SAFE）与 POLYMARKET_FUNDER。场所 CLI 后端需要官方 polymarket 二进制，安装方式为 brew tap Polymarket/polymarket-cli && brew install polymarket，可通过 POLYMARKET_OFFICIAL_CLI 指定自定义路径。
下单通过 polymarket.custom(op="order", token_id=..., price=..., size=..., side="BUY", order_type="GTC") 完成。订单类型路由：GTC/GTD 走限价单路径，FOK/FAK 走市价单路径。
适用场景
适用于需要以编程或 agent 自动化方式访问 Polymarket 市场数据、发现市场并管理 CLOB 订单的流程，如行情查询、市场筛选、仓位与交易数据获取、排行榜查看以及下单与撤单等。
限制
- 适配器不支持运行时约束（如 max_slippage 等）。
- 封装有意屏蔽 wallet、bridge、approve、ctf、setup、upgrade、shell 等分组，不对 agent 暴露。
- 执行类型为 offchain，支持的链元数据为 137（Polygon）。
- 建议使用 --format json 以适配 agent 与自动化流程。
- 提示与工具应保持在此 CLI 表面，不要从咨询工具直接调用 Polymarket HTTP API。