polymarket

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

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill polymarket-vivekgoquest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/vivekgoquest/hermes-agent-stable/tree/main/optional-skills/finance/polymarket
Command: npx skills add https://github.com/vivekgoquest/hermes-agent-stable --skill polymarket-vivekgoquest

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, which slows down research and monitoring tasks. ## 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 Pricing: Fetch current prices, midpoints, spreads, and full orderbooks for any market token via the CLOB API. - Historical Analysis: Retrieve price history charts and recent trade data to track how market sentiment has moved over time. - Use Case: A user asks "what are the odds of a Bitcoin ETF approval?" — the Skill searches Polymarket, parses the matching market, and returns the current Yes/No probabilities 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 Polymarket using the Gamma API public-search endpoint with your query, then read the outcomePrices field from matching 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 the number of data points. The response returns Unix timestamps paired with price values.

Does the Polymarket API require authentication?▼

No, all read-only endpoints across the Gamma, CLOB, and Data APIs are public and require no authentication or API keys. Only trading operations require wallet-based EIP-712 signatures, which this Skill does not support.

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

Why is Polymarket price history empty for some markets?▼

Very new markets may return empty price history because insufficient trading time has passed to generate data points. This is a known limitation of the prices-history endpoint rather than an error in the query.