polymarket

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill polymarket-jamsdoescode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/polymarket
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill polymarket-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? It gives you direct read-only access to Polymarket prediction market data—odds, prices, orderbooks, and history—without needing authentication, API keys, or a crypto wallet. ## Core Features & Use Cases - Market Discovery & Search: Search events and markets through the Gamma API and parse nested market data including double-encoded fields like outcomePrices and clobTokenIds. - Real-Time Prices & Orderbooks: Query the CLOB API for live Yes/No prices, orderbook depth, and price history using clobTokenIds and conditionId. - Use Case: Ask "What are the current odds on the next US presidential election?" and get back market questions with probabilities formatted as percentages plus trading volume in USDC. ## Quick Start Ask the assistant to search Polymarket for current odds on a specific event and show the Yes/No probabilities with volume.

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 events and nested markets. Present each market's outcomePrices as percentages, for example "Yes: 65.2%, No: 34.8%", along with volume in USDC.

How do I get Polymarket orderbook and price history data?

Use the CLOB API with the market's clobTokenIds for real-time prices and orderbook depth, and the conditionId hex string for price history queries. Both fields come from the Gamma API market objects as JSON-encoded strings.

Does the Polymarket API require authentication or an API key?

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

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 using EIP-712 signatures, which is outside the scope of these public data endpoints.

Why do Polymarket outcomePrices fields fail to parse?

The Gamma API returns outcomePrices, outcomes, and clobTokenIds as JSON strings inside JSON responses, meaning they are double-encoded. Parse them with json.loads(market['outcomePrices']) in Python to get the actual array.