polymarket

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

Updated Sep 10, 2026
One-click install
npx skills add https://github.com/loteiron/ZeusAgent --skill polymarket-loteiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/loteiron/ZeusAgent/tree/main/optional-skills/finance/polymarket
Command: npx skills add https://github.com/loteiron/ZeusAgent --skill polymarket-loteiron

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It gives you direct read-only access to Polymarket prediction market data—current odds, orderbooks, trade history, and price trends—without needing authentication, API keys, or a crypto wallet. ## Core Features & Use Cases - Market Discovery & Search: Search events and markets through the Gamma API, browse trending events by volume, and filter by tags, slugs, or active status. - Real-Time Pricing & Orderbooks: Fetch current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History & Trades: Retrieve historical price charts by conditionId and recent trade activity from the Data API. - Use Case: A user asks "What are the odds of a rate cut 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 Bitcoin reaching $150k this year?"

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 read the outcomePrices field from the returned markets. Prices map directly to probabilities, so 0.65 means the market prices a 65% chance.

How to get Polymarket price history for a market?▼

Call the CLOB API prices-history endpoint with the market's conditionId, an interval such as 1d, 1w, or all, and a fidelity value for data point count. Very new markets may return empty history.

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

No. All three public APIs—Gamma, CLOB, and Data—are read-only REST endpoints that return JSON with zero authentication. Rate limits are generous, around 4,000 to 9,000 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 is Polymarket outcomePrices a string instead of an array?▼

The Gamma API double-encodes outcomePrices, outcomes, and clobTokenIds as JSON strings inside JSON responses. Parse them with json.loads() in Python to get the actual arrays before use.