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.