polymarket

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

Updated May 28, 2026
One-click install
npx skills add https://github.com/patty-chow/the-stable --skill polymarket-patty-chow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/patty-chow/the-stable/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/patty-chow/the-stable --skill polymarket-patty-chow

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding current prediction market odds and market data requires manually browsing Polymarket or writing custom API calls. This Skill provides direct read-only access to Polymarket's public REST APIs so you can search markets, check probabilities, inspect orderbooks, and review price history without authentication. ## Core Features & Use Cases - Market Search and Discovery: Search events and markets via the Gamma API, or list trending events sorted by volume. - Real-Time Pricing and Orderbooks: Fetch current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History and Trades: Retrieve historical price series by conditionId and recent trade data 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 the answer as "Yes: 65.2% ($1.2M volume)" with an option to drill into orderbook depth or price history. ## Quick Start Ask the agent to search Polymarket for current odds on a topic, for example by running the polymarket.py script with the search command followed by your query.

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 implies 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 1w or 1m, and a fidelity value for data point count. The response returns timestamped price points you can chart or analyze.

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

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 does Polymarket price history return empty for some markets?▼

Very new markets may have no recorded price history yet, so the prices-history endpoint returns an empty array. Check the market's creation date and try again after trading activity has accumulated.