polymarket

Query Polymarket REST endpoints for market prices, orderbooks, and history.

Updated May 1, 2026
One-click install
npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill polymarket-xiaoquqi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/xiaoquqi/hermes-agent-skills/tree/main/research/polymarket
Command: npx skills add https://github.com/xiaoquqi/hermes-agent-skills --skill polymarket-xiaoquqi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Polymarket data access is simplified by providing read-only access to events, markets, prices, and trades via public REST APIs without requiring authentication.

Core Features & Use Cases

  • Read-only access to Polymarket's Gamma, CLOB, and Data APIs to fetch events, markets, prices, and trades.
  • Parse double-encoded fields and present human-friendly output including Yes/No prices, volumes, and token IDs.
  • Use the CLI to search markets, fetch price/book/history, and view recent trades for monitoring and analysis.

Quick Start

Run python3 polymarket.py search 'Bitcoin' to find relevant Polymarket markets.

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I query Polymarket data and prices without authentication?

You can query Polymarket data without authentication by using read-only public REST endpoints to fetch events, markets, prices, and trades. This approach delivers human-friendly output including Yes/No prices and volumes directly.

How do I fetch Polymarket orderbook and price history for prediction markets?

Fetch Polymarket orderbook and price history by querying the CLOB and Data APIs. The tool parses double-encoded fields like clobTokenIds and outcomes to display formatted price history and orderbook depth for prediction markets.

Can I retrieve recent trades and volumes from Polymarket REST APIs?

Yes, you can retrieve recent trades and volumes from Polymarket REST APIs. The tool queries public Data API endpoints to fetch executed trades and parses the response to present volumes and human-friendly output.

Do I need an API key to search Polymarket markets and events?

No, you do not need an API key to search Polymarket markets and events. The tool provides read-only access to the Gamma API to search and retrieve market data without requiring any authentication.

What is the best way to parse double-encoded fields like outcomePrices in Polymarket data?

The best way to parse double-encoded fields like outcomePrices in Polymarket data is using a tool that automatically decodes them. This script natively parses double-encoded fields and formats results for display including token IDs and outcomes.

How do I find specific prediction markets on Polymarket using a CLI?

Find specific prediction markets on Polymarket using a CLI by running a search command with your target keyword. The tool queries the Gamma API to return relevant markets, events, and associated metadata for monitoring.