polymarket

Query Polymarket prediction markets for probabilities, prices, orderbooks, and trade history.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/afel6/scal-ai-pipeline --skill polymarket-afel6
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/afel6/scal-ai-pipeline/tree/main/hermes_skills_library/research/polymarket
Command: npx skills add https://github.com/afel6/scal-ai-pipeline --skill polymarket-afel6

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Makes it easy to discover and interpret read-only prediction market data from Polymarket by querying public REST endpoints, decoding double-encoded fields, and presenting probabilities and volumes in human-friendly formats.

Core Features & Use Cases

  • Search & Discovery: Query Gamma API public-search to find events and nested markets by keyword or tag.
  • Market Summaries: Read outcomePrices, convert prices to percentages, and show market questions, status, and volume.
  • Orderbook & History: Use clobTokenIds and conditionId to fetch current prices, orderbooks, spreads, and historical price series for monitoring and analysis.
  • Use Case: Monitor the probability of a political outcome or the odds of a crypto price event by summarizing top markets, recent trades, and price history.

Quick Start

Search Polymarket for bitcoin and summarize the top markets with current probabilities and volume.

Frequently Asked Questions about polymarket

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

FAQPage Schema
How do I get Polymarket prediction probabilities and token prices?

Retrieve Polymarket prediction probabilities by querying public Gamma, CLOB, and Data APIs. The Skill fetches outcomePrices and clobTokenIds, decodes double-encoded fields, and formats token prices as percentages for read-only market analysis.

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

Yes, fetch Polymarket orderbook data and price history without authentication. Use clobTokenIds and conditionId to query current spreads, historical price series, and trade history through public CLOB and Data API endpoints.

What's the best way to search Polymarket events by keyword?

Search Polymarket events by keyword using the Gamma API public-search endpoint. Query event tags or keywords to discover nested markets, retrieve market questions, status, and volume, and summarize top matching prediction markets.

Why does Polymarket API return double-encoded fields like outcomePrices?

Polymarket API returns double-encoded fields like outcomePrices and clobTokenIds as nested JSON strings within REST responses. The Skill parses these encoded fields automatically to extract readable token prices and market outcome probabilities.

Do I need an API key to query Polymarket market data?

No API key is needed to query Polymarket market data. The Skill supports token-based price, orderbook, and historical queries entirely through public REST endpoints without authentication for read-only discovery and monitoring tasks.

How do I monitor crypto price event odds on Polymarket?

Monitor crypto price event odds by searching Polymarket for bitcoin or other keywords, summarizing top markets with current probabilities and volume, and fetching recent trades and historical price series for ongoing analysis.