polymarket

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

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill polymarket-maopujie10-sys
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/research/polymarket
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill polymarket-maopujie10-sys

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—market odds, orderbooks, trade history, and volume—without needing an account, API key, or crypto wallet. ## Core Features & Use Cases - Market Discovery & Search: Search events and markets through the Gamma API public-search endpoint and parse nested market data. - Real-Time Prices & Orderbooks: Fetch live Yes/No prices, orderbook depth, and price history using the CLOB API with clobTokenIds and conditionId. - Trade & Open Interest Data: Pull trades and open interest from the Data API for deeper market analysis. - Use Case: A user asks "What are the odds of a candidate winning the election?" The skill searches Polymarket, parses the double-encoded outcomePrices field, and returns "Yes: 65.2%, No: 34.8% ($1.2M volume)". ## Quick Start Ask the agent to search Polymarket for the current odds on a specific event and show the market prices as percentages with volume.

Frequently Asked Questions about polymarket

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

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

Search the Gamma API public-search endpoint with your query, then parse the returned events and nested markets. The outcomePrices field contains Yes/No prices between 0 and 1, which represent probabilities you can format as percentages.

How to fetch Polymarket orderbook and price history data?▼

Use the CLOB API at clob.polymarket.com with the market's clobTokenIds for orderbook data and its conditionId for price history. Both identifiers come from the Gamma API market objects as JSON-encoded strings.

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

No authentication is needed for read-only data. The Gamma, CLOB, and Data APIs are publicly accessible for querying markets, prices, orderbooks, and trades. Only placing trades requires wallet-based EIP-712 signatures.

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 outcomePrices parsing 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(market['outcomePrices']) to get the actual array before use.

What are the Polymarket API rate limits?▼

Rate limits are generous: Gamma allows 4,000 requests per 10 seconds, CLOB allows 9,000, and Data allows 1,000. Normal usage is unlikely to hit these limits.