skills.rest
Araara7
Araara7COMMUNITY
Explore all skills by this author →
GitHub

polymarket

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

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

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 and parsing double-encoded JSON fields, which is tedious to do manually. ## 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 Market Data: Fetch current prices, midpoints, spreads, and full orderbooks from the CLOB API using clobTokenIds. - History & Trades: Retrieve price history by conditionId and recent trades or open interest 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 matching market, and returns "Yes: 65.2%, No: 34.8%" with trading volume. ## Quick Start Ask the agent to search Polymarket for the current odds of a specific event, such as "what are the odds that Bitcoin hits $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, then read the outcomePrices field of the matching market. Prices map directly to probabilities, so 0.65 means the market implies a 65% chance.

How do I 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 the number of data points. 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. Trading, however, requires wallet-based EIP-712 signatures and is not supported here.

Why is outcomePrices a string instead of an array in Polymarket API responses?▼

The Gamma API double-encodes fields like outcomePrices, outcomes, and clobTokenIds as JSON strings inside the JSON response. Parse them with json.loads() in Python to get the actual arrays.

Can I place trades on Polymarket with this API?▼

No. This Skill is read-only and only supports querying market data, prices, orderbooks, and history. Placing trades requires crypto wallet authentication with EIP-712 signatures, which is out of scope.

Related Skills

Explore More Data & Analytics Skills→
vTajaevTajae

web-search

Searches the web and synthesizes cited answers from sources.

Community
Intermediate
zli5460zli5460
2

polymarket

Fetch real-time and historical Polymarket prediction market data.

Community
Intermediate
sergiocoding96sergiocoding96
13

market-intelligence-researcher

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

Community
Intermediate
orthogonal-shorthogonal-sh
12

prediction-market-odds

Aggregate current odds and market data from Polymarket and Kalshi via the Dome API.

Official
Intermediate