polymarket

Convert prediction market questions into odds and orderbook snapshots via Polymarket APIs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Polymarket answers uncertainty by turning prediction market data into clear odds and readable market context without requiring authentication or manual crawling.

Core Features & Use Cases

  • Market search for events and odds: Find relevant markets from user questions (e.g., “Will X happen?”) using Polymarket’s public Gamma API.
  • Real-time price and orderbook insights: Retrieve current probabilities and market depth using the CLOB API.
  • History and trading signals context: Pull price history and recent trades (read-only) to explain how probabilities are moving over time.

Quick Start

Ask the AI: Query Polymarket for the odds and current orderbook of the event “Will Bitcoin hit a new all-time high in 2026?”.

Frequently Asked Questions about polymarket

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get current prediction market odds for a specific event?

To get prediction market odds, query Polymarket's public Gamma API using a natural language question about an event. The system retrieves current probabilities and formats them as percentages, requiring no authentication or manual API crawling.

Can I view the orderbook and market depth for active prediction markets?

You can view the orderbook and market depth for active prediction markets by using the CLOB API with the market's conditionId and clobTokenIds. This retrieves real-time orderbook snapshots and liquidity data for read-only trading insights.

How does price history retrieval work for Polymarket prediction markets?

Price history retrieval works by parsing double-encoded JSON fields for outcome prices and token IDs from the Gamma API, then using conditionId and clobTokenIds to query the CLOB API for historical probability movements and recent trades.

Do I need an API key or authentication to access Polymarket public APIs?

No API key or authentication is needed to access Polymarket public APIs for prediction market data. The system converts user questions into actionable odds, orderbook snapshots, and probability history using entirely public endpoints.

What are the limitations of using read-only trading insights for prediction markets?

The limitation of read-only trading insights is that you cannot execute trades or place orders. The system is restricted to market discovery, current price explanation, and analyzing liquidity and price movement history for active or newly created markets.