polymarket

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

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill polymarket-luckybbjason1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/research/polymarket
Command: npx skills add https://github.com/luckybbjason1/trading --skill polymarket-luckybbjason1

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 search markets, read live prices, inspect orderbooks, and pull price history directly through Polymarket's public REST APIs with zero authentication. ## Core Features & Use Cases - Market Search & Discovery: Search events and markets via the Gamma API, browse 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 series 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 read the outcomePrices field from the returned markets. 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 data point count. The response returns timestamp-price pairs you can chart or analyze.

Does the Polymarket API require authentication or an API key?

No. All endpoints used by this Skill across the Gamma, CLOB, and Data APIs are public 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 return a string instead of an array?

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

Can I place trades on Polymarket with this Skill?

No. This Skill is strictly read-only and cannot place trades. Trading requires wallet-based crypto authentication with EIP-712 signatures, which is outside the scope of these public data endpoints.