skills.rest
i-bebsi
i-bebsiCOMMUNITY
Explore all skills by this author →
GitHub

polymarket

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

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

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 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: Search events and markets via the Gamma API, list trending events by volume, and filter by tags, slugs, or active status. - 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 Bitcoin ETF approval 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 read the outcomePrices field from the returned markets. Prices map directly to probabilities, so 0.65 means the market prices 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. Very new markets may return empty history.

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

No. All three public APIs (Gamma, CLOB, and Data) are read-only REST endpoints that return JSON without any authentication. Rate limits are generous, around 1,000 to 9,000 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 its scope.

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.

Related Skills

Explore More Data & Analytics Skills→
exiaoexiao
37

polymarket

Query Polymarket prediction markets via command-line interface for prices and events.

Community
Intermediate
pmcdowallpmcdowall

polymarket

Retrieve Polymarket market data and convert prices into readable probabilities.

Community
Intermediate
sergiocoding96sergiocoding96
13

market-intelligence-researcher

Aggregate Polymarket prediction data and cross-reference news sources into structured intelligence reports.

Community
Intermediate
michaelschechtmichaelschecht
1

edge-radar

Automate sports betting and prediction market analysis with Python scripts and API integration.

Community
Advanced