polymarket

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill polymarket-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/research/polymarket
Command: npx skills add https://github.com/perasyudha/Nyxora --skill polymarket-perasyudha

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 integrations. This Skill lets you query markets, prices, orderbooks, and trade history directly through Polymarket's public REST APIs with zero authentication. ## Core Features & Use Cases - Market Discovery: Search events and markets by keyword, list trending events by volume, and filter by tags using the Gamma API. - Real-Time Pricing: Fetch current prices, midpoints, spreads, and full orderbooks for any market token via the CLOB API. - Historical Analysis: Retrieve price history charts and recent trade data using condition IDs through the CLOB and Data APIs. - Use Case: A user asks "What are the odds of a rate cut this year?" The Skill searches Polymarket, finds the relevant market, and returns "Yes: 65.2%, No: 34.8%" along with trading volume. ## Quick Start Ask the agent to search Polymarket for current odds on a topic, for example: "What are the current Polymarket odds on Bitcoin reaching $150k this year?"

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 to find matching events and markets. The outcomePrices field contains probabilities, where a price of 0.65 means the market estimates 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, all three public APIs (Gamma, CLOB, and Data) are read-only REST endpoints requiring zero authentication. Rate limits are generous, around 4,000 to 9,000 requests per 10 seconds depending on the API.

Can I place trades on Polymarket with this API?

No, this Skill is read-only and does not support placing trades. Trading requires wallet-based cryptographic 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 passing the correct conditionId hex string with the 0x prefix.