mcpField
G
grimoire-polymarket

grimoire-polymarket

github.com/franalgaba其他611.9k 次安装25 周前更新
代码仓库

关于 grimoire-polymarket

grimoire-polymarket 是通过 Grimoire 的 Polymarket venue adapter 搜索市场、查看 CLOB 数据和管理订单的技能。其封装提供面向 Agent 的命令，并限制可访问的操作组。

主要功能

  1. 01搜索和查看市场
  2. 02读取 CLOB 市场数据
  3. 03下单与取消订单
  4. 04限制开放的操作组
  5. 05提供适用于自动化的 JSON 输出

适用场景

  1. 01按主题或类别查找活跃市场
  2. 02比较代币中间价
  3. 03下达或取消 Polymarket 订单

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/franalgaba/grimoire --skill grimoire-polymarket

安装后在 Claude Code 中输入/grimoire-polymarket确认已加载。

详细介绍

Grimoire Polymarket 技能

通过 polymarket venue adapter 使用此技能进行 Polymarket 市场发现、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 命令：

  • 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（持仓/价值/排行榜等）

此包装器中屏蔽的命令组（有意不向 Agent 开放）：

  • 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），但新 Agent 工作流不应使用这些别名。

示例

# Wrapper/health
grimoire venue polymarket info --format json
grimoire venue polymarket status --format json

# Canonical discovery
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

# Official passthrough discovery/data
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

# Legacy compatibility aliases (still supported)
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 环境变量。

Venue 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。 如果省略选择器，指标会回退到第 3 个参数的值。

适配器说明

  • 适配器名称：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）

备注

  • 在 Agent 和自动化工作流中，优先使用 --format json。
  • search-markets 是面向 Agent 的标准化发现命令；透传命令 markets search 功能较精简，行为也更接近官方实现。
  • 提示词和工具应使用此 CLI 接口；请勿让咨询类工具直接调用 Polymarket HTTP API。

评论

支持 Markdown