grimoire-polymarket

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Grimoire Polymarket Skill

Use this skill for Polymarket market discovery, CLOB market data, and order-management operations through the

polymarket

venue adapter.

Preferred invocations:

```
grimoire venue polymarket ...
```

npx -y @grimoirelabs/cli venue polymarket ...

(no-install)

bun run packages/cli/src/index.ts venue polymarket ...

(repo-local)

grimoire-polymarket ...

(direct binary from

@grimoirelabs/venues

)

Recommended preflight:

grimoire venue doctor --adapter polymarket --json

grimoire venue polymarket info --format json

通过

polymarket

场地适配器，可使用该Skill进行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

Commands

命令

Canonical agent commands:

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>]

Allowed passthrough groups (official CLI surface, restricted by wrapper policy):

```
markets
```
(
```
list|get|search|tags
```
)
```
events
```
(
```
list|get|tags
```
)
```
tags
```
(
```
list|get|related|related-tags
```
)
```
series
```
(
```
list|get
```
)
```
sports
```
(
```
list|market-types|teams
```
)
```
clob
```
(book/prices/markets/orders/trades/etc.)
```
data
```
(positions/value/leaderboards/etc.)
```
status
```

Blocked groups in this wrapper (intentionally not exposed for agents):

```
wallet
```
```
bridge
```
```
approve
```
```
ctf
```
```
setup
```
```
upgrade
```
```
shell
```

Legacy compatibility aliases are still supported (

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

) but should not be used for new agent flows.

标准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
```
）
```
events
```
（
```
list|get|tags
```
）
```
tags
```
（
```
list|get|related|related-tags
```
）
```
series
```
（
```
list|get
```
）
```
sports
```
（
```
list|market-types|teams
```
）
```
clob
```
（book/prices/markets/orders/trades/etc.）
```
data
```
（positions/value/leaderboards/etc.）
```
status
```

本包装器中禁用的命令组（有意不对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流程。

Examples

示例

bash

undefined

bash

undefined

Wrapper/health

Wrapper/健康检查

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 events list --limit 25 --format json grimoire venue polymarket clob book <token_id> --format json grimoire venue polymarket clob midpoint <token_id> --format json grimoire venue polymarket clob price <token_id> --side buy --format json

Authenticated order-management reads

已认证的订单管理查询

grimoire venue polymarket clob order <order_id> --format json grimoire venue polymarket clob trades --market <condition_id> --format json grimoire venue polymarket clob orders --market <condition_id> --format json grimoire venue polymarket clob balance --asset-type conditional --token <token_id> --format json

undefined

undefined

Runtime Configuration

运行时配置

Adapter/runtime auth (for spell execution and authenticated CLOB operations):

required:
```
POLYMARKET_PRIVATE_KEY
```

optional API creds:

POLYMARKET_API_KEY

POLYMARKET_API_SECRET

POLYMARKET_API_PASSPHRASE

optional derive toggle (default true):
```
POLYMARKET_DERIVE_API_KEY=true|false
```
optional signature routing:
```
POLYMARKET_SIGNATURE_TYPE
```
(
```
0
```
EOA,
```
1
```
POLY_PROXY,
```
2
```
GNOSIS_SAFE),
```
POLYMARKET_FUNDER
```

Venue CLI backend:

Official binary required:
```
polymarket
```

Install:

brew tap Polymarket/polymarket-cli && brew install polymarket

Optional path override:

POLYMARKET_OFFICIAL_CLI=/custom/path/polymarket

适配器/运行时认证（用于咒语执行和已认证的CLOB操作）：

必填：
```
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
```

场地CLI后端：

需官方二进制文件：
```
polymarket
```

安装方式：

brew tap Polymarket/polymarket-cli && brew install polymarket

可选路径覆盖：

POLYMARKET_OFFICIAL_CLI=/custom/path/polymarket

Adapter Notes

适配器说明

Adapter name:
```
polymarket
```
Execution type:
```
offchain
```
Supported chain metadata:
```
137
```
(Polygon)
Action type:
```
custom
```

Supported custom ops:

order

cancel_order

cancel_orders

cancel_all

heartbeat

Order argument aliases accepted:

token:
```
token_id
```
or
```
tokenID
```
or
```
tokenId
```
or
```
coin
```
amount:
```
size
```
or
```
amount
```
side:
```
BUY
```
/
```
SELL
```
order type:
```
GTC
```
/
```
GTD
```
/
```
FOK
```
/
```
FAK
```
extra compatibility aliases:
```
arg0..arg5
```
,
```
reduce_only
```

Order type routing:

```
GTC
```
/
```
GTD
```
-> limit order path (
```
createAndPostOrder
```
)
```
FOK
```
/
```
FAK
```
-> market order path (
```
createAndPostMarketOrder
```
)

适配器名称：
```
polymarket
```
执行类型：
```
offchain
```
支持的链元数据：
```
137
```
（Polygon）
操作类型：
```
custom
```

支持的自定义操作：

order

cancel_order

cancel_orders

cancel_all

heartbeat

订单参数别名：

token：
```
token_id
```
或
```
tokenID
```
或
```
tokenId
```
或
```
coin
```
amount：
```
size
```
或
```
amount
```
side：
```
BUY
```
/
```
SELL
```
订单类型：
```
GTC
```
/
```
GTD
```
/
```
FOK
```
/
```
FAK
```
额外兼容别名：
```
arg0..arg5
```
,
```
reduce_only
```

订单类型路由：

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

Notes

注意事项

Prefer
```
--format json
```
for agent and automation workflows.
```
search-markets
```
is the agent-oriented normalized discovery command; passthrough
```
markets search
```
is thinner and closer to official behavior.
Keep prompts/tooling on this CLI surface; do not call Polymarket HTTP APIs directly from advisory tools.

对于Agent和自动化工作流，优先使用
```
--format json
```
。
```
search-markets
```
是面向Agent的标准化市场发现命令；透传的
```
markets search
```
功能更简洁，更贴近官方行为。
请仅通过该CLI界面进行操作；请勿从咨询工具中直接调用Polymarket HTTP API。