polymarket

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

Updated Jun 7, 2026
One-click install
npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill polymarket-chensihakniroth
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/Chensihakniroth/ANAKOT-AGENT/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/Chensihakniroth/ANAKOT-AGENT --skill polymarket-chensihakniroth

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding current prediction market odds and event probabilities requires manually browsing Polymarket, and there is no straightforward way to programmatically pull market prices, orderbook depth, or historical trends without authentication. ## Core Features & Use Cases - Market Discovery & Search: Search events and markets through the Gamma API, list trending events by volume, and filter by tags, slugs, or active status. - Real-Time Pricing & Orderbooks: Retrieve current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History & Trade Data: Fetch historical price series by conditionId and recent trades or open interest from the Data API. - Use Case: A user asks "what are the odds of a Bitcoin ETF approval this year?" — the Skill searches Polymarket, parses the double-encoded outcomePrices field, and returns "Yes: 65.2%, No: 34.8%" with trading volume. ## Quick Start Ask the agent to search Polymarket for current odds on a topic, for example: "What are the current Polymarket odds on the next US presidential election winner?"

Frequently Asked Questions about polymarket

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

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

Search the Gamma API public-search endpoint with your query to find events and their nested markets. The outcomePrices field contains probabilities as JSON-encoded strings, where 0.65 means the market prices a 65% likelihood.

How to fetch Polymarket orderbook and price history data?▼

Use the CLOB API with the market's clobTokenIds for orderbook, midpoint, and spread queries, and the conditionId for the prices-history endpoint. Both identifiers come from the Gamma API market object and require parsing double-encoded JSON strings.

Does the Polymarket API require authentication or API keys?▼

No authentication is needed for read-only data. All Gamma, CLOB, and Data API endpoints are public GET requests returning JSON, with generous rate limits of thousands of requests per 10 seconds.

Can I place trades on Polymarket through this API?▼

No, this Skill is read-only and does not support placing trades. Trading requires wallet-based crypto authentication with EIP-712 signatures, which is outside the scope of these public data endpoints.

Why does Polymarket price history return empty for some markets?▼

Very new markets may have no recorded price history yet, so the prices-history endpoint returns an empty array. Check the market's creation date and fall back to current price and orderbook data instead.