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 Commands Canonical agent commands: grimoire venue polymarket info [--format ] grimoire venue polymarket search-markets [--query ] [--slug ] [--question ] [--event ] [--tag ] [--category ] [--league ] [--sport ] [--open-only ] [--active-only ] [--ignore-end-date ] [--tradable-only ] [--all-pages ] [--max-pages ] [--stop-after-empty-pages ] [--limit ] [--format ] 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. Examples

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 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 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 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 ) 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.