skills.rest
superfhp
superfhpCOMMUNITY
Explore all skills by this author →
GitHub

polymarket

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

Updated May 13, 2026
Search Tags:#rest api#market data#orderbook#polymarket#odds#price history#prediction markets
One-click install
npx skills add https://github.com/superfhp/lumi-agent-body --skill polymarket-superfhp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/superfhp/lumi-agent-body/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/superfhp/lumi-agent-body --skill polymarket-superfhp

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 navigating Polymarket's three separate public APIs, each with different endpoints and double-encoded JSON fields. This Skill provides a unified workflow and CLI helper to search markets, read prices, inspect orderbooks, and retrieve price history without authentication. ## Core Features & Use Cases - Market Search & Discovery: Search events and markets via the Gamma API, list trending events by volume, and filter by tags or slugs. - Real-Time Pricing & Orderbooks: Fetch current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History & Trades: Retrieve historical price charts 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 "Yes: 65.2%, No: 34.8%" 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 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 Polymarket odds for an event?▼

Search the Gamma API public-search endpoint with your query, then parse the returned markets' outcomePrices field. Prices map directly to probabilities, so a price of 0.65 means the market implies a 65% chance.

How to get Polymarket price history for a market?▼

Use 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 contains Unix timestamps paired with price values.

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. Only placing trades requires wallet-based EIP-712 signatures, which this Skill does not support.

Why does Polymarket outcomePrices parsing fail in Python?▼

The Gamma API returns outcomePrices, outcomes, and clobTokenIds as JSON strings inside JSON responses, known as double-encoding. Parse them with json.loads() before accessing the array values.

Can I place trades on Polymarket through this API?▼

No, this Skill is read-only and only retrieves market data, prices, orderbooks, and history. Trading requires wallet-based crypto authentication with EIP-712 signatures, which is outside its scope.

Related Skills

Explore More Data & Analytics Skills→
shreed27shreed27

news

Monitor Twitter and RSS news to correlate with prediction market movements.

Community
Intermediate
PuckAPIPuckAPI
2

edge-detection

Compare model probabilities against market odds to identify positive expected value bets.

Official
Advanced
jasonkneenjasonkneen
471

polymarket

Query real-time Polymarket prediction market prices, orderbooks, and historical data.

Community
Intermediate
FlexasaurusrexFlexasaurusrex
16

polytracker

Monitor prediction markets and alert on odds, sentiment, and price movements.

Community
Advanced