polymarket

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill polymarket-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill polymarket-tylersimons1127

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 manual browsing of the Polymarket website. ## Core Features & Use Cases - Market Discovery & Search: Search events and markets via the Gamma API, list 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 data 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 fields, and returns "Yes: 65.2%, No: 34.8%" with volume, then can drill into orderbook depth or 6-month price history on request. ## Quick Start Ask the agent to search Polymarket for current odds on a topic, for example: "What do prediction markets say about 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 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 a price of 0.65 means the market implies a 65% chance.

How to get Polymarket price history for a market?▼

Use 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 API keys?▼

No, all three public APIs (Gamma, CLOB, and Data) are read-only REST endpoints requiring zero authentication. Rate limits are generous, around 1,000 to 9,000 requests per 10 seconds depending on the API.

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 are Polymarket outcomePrices fields not parsing correctly?▼

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