polymarket

Query Polymarket prediction markets for prices, orderbooks, and price history via public REST APIs.

Updated May 29, 2026
One-click install
npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill polymarket-reimonsk8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/Reimonsk8/hermes-9router-model-balancing/tree/main/scripts/skills/research/polymarket
Command: npx skills add https://github.com/Reimonsk8/hermes-9router-model-balancing --skill polymarket-reimonsk8

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Finding current prediction market odds and event probabilities requires navigating Polymarket's three separate public APIs, each with different endpoints and double-encoded JSON fields that are easy to mishandle. ## Core Features & Use Cases - Market Discovery: Search and browse events and markets through the Gamma API with filters for activity, volume, and tags. - Real-Time Pricing: Fetch current prices, midpoints, spreads, and orderbooks from the CLOB API using clobTokenIds. - Price History & Trades: Retrieve historical price series via conditionId and recent trades or open interest from the Data API. - Use Case: A user asks "what are the odds of a candidate winning the election?" — the Skill searches Gamma for matching markets, parses outcomePrices into readable percentages, and can pull orderbook depth or price history on request. ## Quick Start Ask the assistant to look up the current Polymarket odds for any event, such as "What are the current Polymarket odds on the next Fed rate decision?"

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I check Polymarket odds for an event?▼

Search the Gamma API public-search endpoint with your query, then parse the returned markets' outcomePrices field. Prices map directly to probabilities, so a price of 0.65 means the market implies a 65% chance.

How do I get Polymarket price history for a market?▼

Use the CLOB API prices-history endpoint with the market's conditionId, an interval such as 1w or 1m, and a fidelity value for data point count. The response returns Unix timestamps paired with price values.

Does the Polymarket API require authentication or an API key?▼

No authentication is needed for read-only data. All Gamma, CLOB, and Data API endpoints used here are public GET requests, though placing trades requires wallet-based EIP-712 signatures which this Skill does not support.

Why does parsing Polymarket outcomePrices fail in Python?▼

The Gamma API returns outcomePrices, outcomes, and clobTokenIds as JSON strings inside JSON responses, so they are double-encoded. Parse them with json.loads() before accessing the underlying arrays.

Can I place trades on Polymarket through this API access?▼

No, this Skill is read-only and only retrieves market data, prices, orderbooks, and history. Trading requires crypto wallet authentication with EIP-712 signatures, which is outside its scope.