polymarket

Query Polymarket market search, prices, orderbooks, and price history via REST APIs.

Updated Apr 23, 2026
One-click install
npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill polymarket-chris-chai-minjae
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/Chris-Chai-Minjae/hermes-agent-r1-bridge --skill polymarket-chris-chai-minjae

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Polymarket data is publicly accessible but requires multiple endpoint calls to gather market search, price, and history information. This skill centralizes read-only Polymarket data access for quick insights.

Core Features & Use Cases

  • Search and discover markets: use Gamma API to find events and markets by query.
  • View prices and orderbooks: use CLOB API to fetch current prices and orderbooks per market token.
  • Access price history and trades: use Data API for recent trades and open interest; fetch historical price data via CLOB history endpoint.
  • Use Case: Imagine you want to compare odds across events and monitor price movements over time to inform decisions.

Quick Start

Use Polymarket data queries via the CLI to retrieve current prices, orderbooks, and price history for a market.

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I get current prices and orderbooks from Polymarket prediction markets?

To get Polymarket prediction market prices and orderbooks, you query the CLOB API using a specific market token. This approach fetches real-time orderbook depth and current pricing data for individual market tokens.

What's the best way to search for events and markets on Polymarket?

The best way to search for Polymarket events and markets is using the Gamma API. It provides market discovery functionality, allowing you to find specific events and markets by querying against the public REST API.

How do I retrieve historical price data and recent trades for prediction markets?

You retrieve historical price data and recent prediction market trades by using the CLOB history endpoint and Data API. These public REST APIs provide recent trade records, open interest data, and historical price movements.

Why does the JSON response from Polymarket API require double parsing with json.loads?

Polymarket API JSON responses require double parsing with json.loads because some fields are double-encoded as strings. Parsing these string fields ensures the nested data is correctly extracted into usable JSON objects.

Do I need an API key or authentication to access Polymarket market data?

No API key or authentication is needed to access Polymarket market data because the Skill uses public REST APIs. It provides read-only data access for market search, prices, orderbooks, and price history without authentication requirements.

What limitations should I be aware of when querying Polymarket data via REST APIs?

Key limitations when querying Polymarket data include rate-limit awareness and the need for robust error handling. The public REST APIs are read-only, meaning you cannot execute trades or place orders through this data retrieval method.