polymarket

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

1|Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Chia1104/agent-air --skill polymarket-chia1104
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/Chia1104/agent-air/tree/main/skills/hermes/research/polymarket
Command: npx skills add https://github.com/Chia1104/agent-air --skill polymarket-chia1104

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 calls. This Skill gives an AI agent direct read-only access to Polymarket's public REST APIs so users can ask natural-language questions about market odds, prices, and trading activity. ## Core Features & Use Cases - Market Discovery and Search: Search events and markets via the Gamma API, list trending events by volume, and filter by tags, slugs, or active status. - Real-Time Pricing and Orderbooks: Fetch current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History and Trade Data: Retrieve historical price charts by conditionId and recent trades or open interest from the Data API. - Use Case: A user asks "What are the odds of a Bitcoin ETF approval this year?" The agent searches Polymarket, parses the double-encoded outcomePrices fields, and replies with "Yes: 65.2%, No: 34.8%" alongside 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 Polymarket using the Gamma API public-search endpoint with your query, then read the outcomePrices field from the returned markets. 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 1d, 1w, or all, and a fidelity value for data point count. The response returns Unix timestamps paired with price values.

Does the Polymarket API require authentication?▼

No authentication is needed for read-only data. All Gamma, CLOB, and Data API endpoints used here are public GET requests. Only placing trades requires wallet-based EIP-712 signature authentication, which this Skill does not support.

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, and geographic restrictions apply to trading even though market data is globally accessible.

Why does Polymarket price history return empty results?▼

Empty price history typically occurs for very new markets that have not accumulated trading data yet. Verify the conditionId is correct and try a shorter interval; if the market is recently created, history may simply not exist.