polymarket

Query Polymarket public REST APIs for markets, prices, and history.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill polymarket-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/skills/research/polymarket
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill polymarket-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Quickly access Polymarket data (markets, prices, and history) from public APIs without authentication, enabling quick analysis and monitoring.

Core Features & Use Cases

  • Read-only market data: fetch markets, current prices, volumes, and price history across Gamma, CLOB, and Data APIs.
  • Market discovery & details: inspect event and market metadata, including conditionId and token mappings for related data endpoints.
  • Quick analysis workflow: wire up to downstream analytics by parsing double-encoded fields like outcomePrices and clobTokenIds.
  • Use Case: A trader or researcher wants to glance at odds trends for a specific event and pull recent trades for validation.

Quick Start

Run the polymarket.py script with a query, for example python3 polymarket.py search "bitcoin".

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I query Polymarket market prices and history without authentication?

You can query Polymarket market prices and history without authentication by using a CLI script that calls public REST APIs. It fetches read-only market data, current prices, and price history across Gamma, CLOB, and Data endpoints.

Can I retrieve Polymarket orderbook data and recent trades for analysis?

Yes, you can retrieve Polymarket orderbook data and recent trades. The CLI exposes commands for book and trades, allowing you to pull orderbook insights and validate recent trade activity for analysis workflows.

How do I search for specific Polymarket events and inspect their metadata?

To search for specific Polymarket events, run the CLI search command with a query string. It returns event and market metadata, including conditionId and token mappings for related data endpoints.

How does the tool handle double-encoded JSON fields like outcomePrices from Polymarket APIs?

The tool handles double-encoded JSON fields by parsing values like outcomePrices and clobTokenIds automatically. This decoding step formats nested JSON strings into usable data structures for downstream analytics.

Do I need an API key to fetch Polymarket volumes and current odds?

No, you do not need an API key to fetch Polymarket volumes and current odds. The tool accesses public REST APIs without authentication to retrieve read-only market data, prices, and volumes.

What's the best way to monitor Polymarket odds trends for a specific event?

The best way to monitor Polymarket odds trends is using the CLI history command. It fetches price history from public APIs, enabling you to glance at odds trends and pull recent trades for validation.