polymarket

Retrieve Polymarket prediction market odds and Yes/No probabilities via Gamma and CLOB APIs.

Updated May 5, 2026
One-click install
npx skills add https://github.com/Z43L/zeus-agent --skill polymarket-z43l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/Z43L/zeus-agent/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/Z43L/zeus-agent --skill polymarket-z43l

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

It helps users quickly retrieve readable prediction-market odds, market questions, and supporting market data from Polymarket public APIs without needing authentication.

Core Features & Use Cases

  • Searches prediction markets (read-only): Finds relevant Polymarket events and nested binary markets by user query, then summarizes key results.
  • Explains and formats prices as probabilities: Converts Polymarket outcomePrices into human-friendly percentages and ties them to Yes/No outcomes.
  • Provides deep-dive market details on demand: Uses Gamma for discovery and CLOB/Data for orderbook and price history using clobTokenIds and conditionId.
  • Use Case: When a user asks, "What are the odds that X happens on Polymarket?" the skill can return the event title, the Yes/No probability split, and available volume, and then follow up with orderbook or price history if requested.

Quick Start

Ask: "What are the odds and current prices for the Polymarket question about [your event], and show the Yes/No probabilities 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 prediction market probabilities?

To get current Polymarket odds, you can query the Gamma API for market discovery and retrieve probability-formatted prices from outcomePrices. The results provide human-friendly percentages tied to Yes/No outcomes for prediction market events.

Can I retrieve Polymarket orderbook data and price history without authentication?

Yes, you can retrieve Polymarket orderbook data and price history without authentication by using the public CLOB and Data endpoints. These endpoints allow you to query token_id and conditionId-based history for deep dives into market levels.

What is the best way to search Polymarket events and find specific prediction market questions?

The best way to search Polymarket events is by using the Gamma API for event and market discovery. It finds relevant prediction market events by user query and summarizes key results including nested binary markets.

How does parsing double-encoded JSON fields like outcomePrices work when fetching Polymarket data?

Parsing double-encoded JSON fields like outcomePrices and clobTokenIds involves decoding the nested JSON strings returned by Polymarket APIs to correctly extract token IDs and probability prices for readable market data.

Does the Polymarket Skill support placing trades or only read-only market data retrieval?

The Polymarket Skill strictly supports read-only prediction market information retrieval. It cannot place trades; it only fetches current odds, market questions, volumes, orderbook levels, and conditionId-based price history.

Why are my Polymarket prices showing as decimals instead of percentages?

Polymarket prices often appear as decimals because the outcomePrices field contains raw probability values. The Skill converts these outcomePrices into human-friendly percentages tied to Yes/No outcomes for readable market context.