polymarket

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

5|2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/AjayRajan05/VoiceOS --skill polymarket-ajayrajan05
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/AjayRajan05/VoiceOS/tree/main/skills/bundled/community/research/polymarket
Command: npx skills add https://github.com/AjayRajan05/VoiceOS --skill polymarket-ajayrajan05

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Finding current prediction market odds and event probabilities requires manually browsing Polymarket or writing custom API integration code. This Skill provides direct read-only access to Polymarket's public REST APIs so you can search markets, check prices, and review orderbooks without authentication or setup. ## Core Features & Use Cases - Market Search and Discovery: Search events and markets by keyword, or list trending events sorted by volume using the Gamma API. - Real-Time Pricing and Orderbooks: Retrieve current prices, midpoints, spreads, and full orderbook depth from the CLOB API using market token IDs. - Price History and Trade Data: Fetch historical price charts by condition ID and recent trade activity from the Data API. - Use Case: A user asks "What are the odds of a recession in 2025?" The Skill searches Polymarket, finds the relevant market, and returns the current Yes/No probabilities with trading volume. ## Quick Start Ask the assistant to search Polymarket for current odds on a topic, for example: "What are the current prediction market odds on 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 prediction market odds for an event?▼

Search Polymarket using the Gamma API public-search endpoint with your query, then read the outcomePrices field from matching markets. Prices represent probabilities directly, so a price of 0.65 means the market assigns a 65% likelihood.

How to get Polymarket orderbook and price history data?▼

Use the CLOB API with the market's clobTokenIds for orderbook, price, midpoint, and spread endpoints. For price history, call the prices-history endpoint with the market's conditionId and a time interval like 1d, 1w, or all.

Does the Polymarket API require authentication or API keys?▼

No authentication is needed for read-only data. All three public APIs (Gamma, CLOB, and Data) accept unauthenticated GET requests and return JSON, with generous rate limits of thousands of requests per 10 seconds.

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

Very new markets may have no recorded price history yet, so the prices-history endpoint returns an empty array. Check that you are using the correct conditionId with the 0x prefix and try a shorter interval.