Grimoire Polymarket 技能

使用此技能进行 Polymarket 市场发现、CLOB 市场数据以及通过 polymarket 场所适配器进行订单管理操作。

推荐调用方式：

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

命令

标准代理命令：

grimoire venue polymarket info [--format <auto|json|table>]
grimoire venue polymarket search-markets [--query <text>] [--slug <slug|url>] [--question <text>] [--event <text>] [--tag <text>] [--category <text>] [--league <text>] [--sport <text>] [--open-only <true|false>] [--active-only <true|false>] [--ignore-end-date <true|false>] [--tradable-only <true|false>] [--all-pages <true|false>] [--max-pages <n>] [--stop-after-empty-pages <n>] [--limit <n>] [--format <auto|json|table>]

允许的透传组（官方 CLI 表面，受包装器策略限制）：

markets（list|get|search|tags）
data（持仓/价值/排行榜等）

此包装器中阻止的组（有意不向代理暴露）：

wallet
bridge
approve
ctf
setup
upgrade
shell

旧版兼容别名仍然支持（market、book、midpoint、spread、price、last-trade-price、tick-size、neg-risk、fee-rate、price-history、order、trades、open-orders、balance-allowance、closed-only-mode、server-time），但不应在新代理流程中使用。

示例

# 包装器/健康检查
grimoire venue polymarket info --format json
grimoire venue polymarket status --format json

# 标准发现
grimoire venue polymarket search-markets --query bitcoin --active-only true --open-only true --format json
grimoire venue polymarket search-markets --category sports --league "la liga" --active-only true --open-only true --format json

# 官方透传发现/数据
grimoire venue polymarket markets list --limit 25 --format json
grimoire venue polymarket markets search "atleti" --limit 25 --format json
grimoire venue polymarket data positions <address> --limit 25 --format json
grimoire venue polymarket data trades <address> --limit 25 --format json
grimoire venue polymarket data leaderboard --period week --order-by vol --limit 25 --format json

# 旧版兼容别名（仍然支持）
grimoire venue polymarket book --token-id <token_id> --format json
grimoire venue polymarket price --token-id <token_id> --side buy --format json
grimoire venue polymarket order --order-id <order_id> --format json
grimoire venue polymarket open-orders --market <condition_id> --format json

运行时配置

适配器/运行时认证（用于咒语执行）：

默认必需：POLYMARKET_PRIVATE_KEY
可选 API 凭据：POLYMARKET_API_KEY、POLYMARKET_API_SECRET、POLYMARKET_API_PASSPHRASE
可选派生开关（默认为 true）：POLYMARKET_DERIVE_API_KEY=true|false
可选签名路由：POLYMARKET_SIGNATURE_TYPE（0 EOA，1 POLY_PROXY，2 GNOSIS_SAFE），POLYMARKET_FUNDER
grimoire cast / grimoire resume 基于密钥的流程将相同的钱包管理器密钥注入 Polymarket 适配器，因此那里不需要单独的 POLYMARKET_PRIVATE_KEY 环境变量。

场所 CLI 后端：

需要官方二进制文件：polymarket
安装：brew tap Polymarket/polymarket-cli && brew install polymarket
可选路径覆盖：POLYMARKET_OFFICIAL_CLI=/custom/path/polymarket

咒语动作

Polymarket 使用 custom 动作类型，并带有 op: "order" 进行订单下达：

polymarket.custom(
  op="order",
  token_id="TOKEN_ID",
  price="0.55",
  size="100",
  side="BUY",
  order_type="GTC",
)

适配器不支持运行时约束（max_slippage 等）。订单路由：

GTC/GTD → 限价单（createAndPostOrder）
FOK/FAK → 市价单（createAndPostMarketOrder）

指标表面（咒语比较）

Polymarket 暴露 mid_price 用于 CLOB 代币中点比较：

poly_mid = metric("mid_price", polymarket, USDC, "token_id=<clobTokenId>")

接受的筛选键：token_id、tokenid、market_id、id。
如果省略筛选器，指标将回退到第三个参数值。

适配器说明

适配器名称：polymarket
执行类型：offchain
支持的链元数据：137（Polygon）
动作类型：custom
支持的自定义操作：order、cancel_order、cancel_orders、cancel_all、heartbeat

接受的订单参数别名：

代币：token_id 或 tokenID 或 tokenId 或 coin
数量：size 或 amount
方向：BUY/SELL
订单类型：GTC/GTD/FOK/FAK
额外兼容别名：arg0..arg5、reduce_only

订单类型路由：

GTC/GTD -> 限价单路径（createAndPostOrder）
FOK/FAK -> 市价单路径（createAndPostMarketOrder）

备注

对于代理和自动化工作流，优先使用 --format json。
search-markets 是面向代理的标准化发现命令；透传的 markets search 更精简，更接近官方行为。
保持提示/工具在此 CLI 表面上；不要从咨询工具直接调用 Polymarket HTTP API。

grimoire-polymarket

相关 Skills