polymarket

Query Polymarket public REST APIs for prices, volumes, and market metadata.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill polymarket-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill polymarket-alexiosbluffmara

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Quickly access Polymarket market data (prices, volumes, and history) without writing bespoke API clients.

Core Features & Use Cases

  • Read-only access to three Polymarket public APIs (Gamma for markets and events, CLOB for prices and orderbooks, Data API for trades and open interest).
  • Retrieve current prices, market odds, and historical price data to inform decision-making or dashboards.
  • Compare markets, monitor movements, and answer questions like "What are the current odds of X?"

Quick Start

Query Polymarket for the latest price and odds for a specific market.

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I get current prices and odds from Polymarket prediction markets?

To get current Polymarket prices and odds, query the public CLOB and Gamma REST APIs. This Skill parses JSON responses to retrieve real-time market prices, volumes, and event metadata without requiring authentication.

Can I retrieve historical price history and trade data from Polymarket?

Yes, you can retrieve Polymarket historical price history by querying the Data API. It provides read-only access to past trades and open interest data, allowing you to track market movements and inform decision-making dashboards.

Do I need an API key or authentication to access Polymarket market data?

No, you do not need an API key or authentication to access Polymarket market data. This Skill uses read-only public REST APIs to retrieve event outcomes, volumes, and current odds without any authentication requirements.

What is the best way to compare Polymarket event outcomes and market movements?

The best way to compare Polymarket event outcomes is by querying the Gamma API for market metadata alongside the CLOB API for prices. This approach aggregates market odds and price history for easy interpretation and comparison.

What are the limitations of using public REST APIs for Polymarket prediction market data?

Limitations of using public Polymarket REST APIs include read-only access, meaning you cannot place trades. You must also parse JSON-encoded fields from Gamma, CLOB, and Data API responses manually to format outputs correctly.