polymarket

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

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill polymarket-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill polymarket-mlt-oss

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, each with different endpoints and double-encoded JSON fields. This Skill provides a ready-made CLI and endpoint reference so you can search markets, read prices, and pull history without writing API integration code from scratch. ## Core Features & Use Cases - Market Search & Discovery: Search events and markets by keyword or browse trending events sorted by volume through the Gamma API. - Real-Time Pricing & Orderbooks: Fetch current prices, midpoints, spreads, and full orderbook depth for any market using CLOB token IDs. - Price History & Trades: Retrieve historical price charts by condition ID and recent trade feeds 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 by running the polymarket.py script with the search command followed by your query.

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 polymarket.py script with the search command 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 prices and volumes.

How do I get current odds for a Polymarket event?

Use the search or trending commands to find the market, then read its outcomePrices field, where prices directly represent probabilities. A price of 0.65 means the market implies a 65% chance of that outcome.

Does the Polymarket API require an API key or authentication?

No authentication is needed for read-only data. All three public APIs (Gamma, CLOB, and Data) accept unauthenticated GET requests, and rate limits are generous at thousands of requests per 10 seconds.

Can I place trades on Polymarket with this skill?

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 the scope of the public REST endpoints used here.

Why does Polymarket price history return empty for some markets?

Very new markets may have no recorded price history yet, so the prices-history endpoint returns an empty result. This is a known limitation; try again after the market has accumulated trading activity.