polymarket

Retrieve Polymarket prediction market data via public REST endpoints.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill polymarket-zardli1115
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill polymarket-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps you quickly retrieve and interpret read-only prediction market data from Polymarket so you can answer questions about probabilities, odds, and market movement without manual browsing.

Core Features & Use Cases

  • Market discovery & odds lookup: Search and list events/markets and present outcome probabilities as percentages.
  • Deep-dive data views: Fetch orderbook snapshots, current/midpoint/spread pricing, and price history for a specific condition.
  • Trades & open interest context: Pull recent trades and open interest to understand activity and liquidity.
  • Double-encoded field handling: Correctly parse Gamma API fields like outcomePrices, outcomes, and clobTokenIds that arrive as JSON strings.
  • Read-only safety: Uses public REST endpoints and does not support trading or authentication.

Quick Start

Ask for the current Polymarket odds for a specific market question and return the Yes/No percentages plus volume.

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I get current Polymarket odds and prices for a specific prediction market?

To get Polymarket odds, you can search for specific prediction market events and retrieve current prices, presenting Yes/No outcome probabilities as human-friendly percentages alongside their trading volume context.

Can I fetch the orderbook and price history for a Polymarket prediction market?

You can fetch prediction market orderbook snapshots, midpoint/spread pricing, and price history by translating conditionId and clobTokenIds across the Gamma API to retrieve detailed market activity and liquidity data.

Why does Polymarket API data show misaligned or double-encoded JSON fields?

Polymarket API data requires parsing double-encoded JSON fields because Gamma API responses return values like outcomePrices, outcomes, and clobTokenIds as JSON strings that must be properly decoded to structure market summaries.

Does this method support placing trades or require authentication for Polymarket data?

This method uses read-only public REST endpoints over HTTPS to retrieve Polymarket prediction market data, meaning it does not support trading, placing orders, or requiring any authentication credentials.

What is the best way to analyze prediction market probabilities and open interest?

The best way to analyze prediction market probabilities is to pull recent trades and open interest data to understand market activity and liquidity, returning structured market summaries suitable for downstream decision making.

How do I discover prediction market events using the Gamma API?

You can discover prediction market events by searching via the Gamma API, which allows listing available markets and translating clobTokenIds and conditionId across APIs to retrieve current prices and formatted probability odds.