grimoire-polymarket

Query Polymarket markets and CLOB orderbook data via the Grimoire venue adapter.

6|2|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/franalgaba/grimoire --skill grimoire-polymarket
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grimoire-polymarket
Source: https://github.com/franalgaba/grimoire/tree/main/skills/grimoire-polymarket
Command: npx skills add https://github.com/franalgaba/grimoire --skill grimoire-polymarket

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a consistent, agent-friendly interface to discover Polymarket markets, inspect CLOB orderbook state, and perform order management without directly calling multiple HTTP APIs or juggling official CLI variations.

Core Features & Use Cases

  • Market discovery: normalized search-markets and passthrough markets list/search for finding tradable events and tokens.
  • CLOB data & metrics: retrieve mid_price and token-level orderbook metrics for comparisons and strategy inputs.
  • Order management: place, cancel, and bulk-cancel orders using the adapter's custom order op with support for GTC/GTD/FOK/FAK routing.
  • Use Case: automate scanning active Polygon Polymarket events, compute mid_price against USDC, and route limit or market orders through the Grimoire adapter in preview then commit flows.

Quick Start

Use the grimoire-polymarket skill to search active Polymarket markets for "bitcoin" and return results in JSON format.

Frequently Asked Questions about grimoire-polymarket

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Polymarket order management and market discovery on Polygon?

You can automate Polymarket order management by querying markets and routing CLOB orders through the Grimoire venue adapter. It supports order placement, cancellation, and bulk-cancel operations for offchain Polygon markets. Return data is available in JSON format.

What do I need to place CLOB orders on Polymarket through an automation workflow?

To place CLOB orders on Polymarket, you need the official polymarket CLI binary installed and environment credentials configured. You must set the POLYMARKET_PRIVATE_KEY variable and optional API keys to authenticate order routing.

Can I retrieve mid_price and orderbook metrics for Polymarket tokens?

Yes, you can retrieve mid_price and token-level CLOB orderbook metrics. The Skill queries Polymarket CLOB data to provide midpoint metrics against USDC, which are useful for strategy inputs and price comparisons.

What order types are supported when routing trades through the Polymarket adapter?

The adapter supports GTC, GTD, FOK, and FAK order routing through its custom order op. You can preview and commit limit or market orders via the adapter order and market order paths.

How do I search for active Polymarket events and tradable tokens in JSON format?

You can search for active Polymarket events using the normalized search-markets function or passthrough markets list. This market discovery process returns tradable events and tokens, and supports JSON output for automation workflows.

Are there limitations to using the Grimoire adapter for Polymarket trading?

The Grimoire adapter is limited to offchain Polygon (chain 137) Polymarket markets. It relies on the official polymarket CLI binary and appropriate environment credentials, meaning it cannot interact with markets on other chains.