polymarket

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

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill polymarket-kaminocorp
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/kaminocorp/hermes-alpha-hunter/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/kaminocorp/hermes-alpha-hunter --skill polymarket-kaminocorp

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 integration code. This Skill provides direct read-only access to Polymarket's public REST APIs so you can search markets, check prices, and review orderbooks without authentication or API keys. ## Core Features & Use Cases - Market Search and Discovery: Search events and markets by keyword, list trending events by volume, and filter by tags using the Gamma API. - Real-Time Pricing and Orderbooks: Retrieve current prices, midpoints, spreads, and full orderbook depth from the CLOB API using clobTokenIds. - Price History and Trade Data: Fetch historical price charts by conditionId and recent trades 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 fields, and returns formatted probabilities like "Yes: 65.2%" 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 Bitcoin reaching $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 search Polymarket prediction markets from the command line?▼

Run the included script with python3 polymarket.py search followed by your query, such as python3 polymarket.py search "bitcoin". It calls the Gamma API public-search endpoint and prints matching events with market questions, prices as percentages, and volume.

How do I get Polymarket odds without an API key?▼

All three Polymarket APIs used here (Gamma, CLOB, and Data) are public read-only REST endpoints requiring no authentication. You can query market prices, orderbooks, and price history directly with plain HTTP GET requests.

Can I place trades on Polymarket with this tool?▼

No, this Skill is strictly read-only and does not support placing trades. Trading on Polymarket requires wallet-based crypto authentication using EIP-712 signatures, which is outside the scope of these public data endpoints.

Why does the Polymarket API return outcomePrices as a string?▼

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 array of values before formatting prices as percentages.

Why is price history empty for some Polymarket markets?▼

Very new markets may return empty price history from the CLOB prices-history endpoint because insufficient trading data has accumulated. Try querying again later or use the current price and orderbook endpoints instead.