polymarket

Query Polymarket prediction markets and parse outcomePrices from public APIs.

Updated Sep 1, 2021
One-click install
npx skills add https://github.com/unclehowell/unclehowell --skill polymarket-unclehowell
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/unclehowell/unclehowell/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/unclehowell/unclehowell --skill polymarket-unclehowell

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Provides fast, read-only access to Polymarket prediction market data so users can discover markets, view current probabilities, and inspect orderbooks and price history without needing authentication.

Core Features & Use Cases

  • Market Discovery: Search Polymarket by query, list trending events, and inspect event-level market groupings.
  • Price & Orderbook Access: Retrieve current prices, midpoint, spreads, and top-of-book bids/asks for Yes/No outcomes using token IDs.
  • Historical & Trade Data: Fetch price history and recent trades for monitoring and time-series analysis.
  • Use Case: An analyst asks "what are the current odds for X?" and the skill searches Gamma API, parses outcomePrices, shows Yes/No percentages and volume, and provides token IDs for deeper book or history queries.

Quick Start

Use the polymarket skill to search for markets about Bitcoin and show each market's Yes/No prices 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 current Polymarket prediction market odds and prices?▼

To get Polymarket prediction market odds, you can query the Gamma API to search for specific markets and retrieve current Yes/No outcome prices. The skill parses double-encoded JSON fields like outcomePrices to display current probabilities and summary volumes without requiring authentication keys.

Can I retrieve Polymarket orderbook data and top-of-book bids/asks without an API key?▼

Yes, you can retrieve Polymarket orderbook data without an API key by making read-only public REST API calls to the CLOB endpoints. The skill fetches midpoint, spreads, and top-of-book bids/asks for Yes/No outcomes using the specific clobTokenIds parsed from the market data.

How do I fetch Polymarket price history and recent trades for time-series analysis?▼

You fetch Polymarket price history and recent trades by calling the Data API endpoints using the market's token IDs. This read-only process retrieves historical price time-series and recent trade records, allowing you to monitor market movement over time without authentication.

Why does parsing Polymarket outcomePrices return double-encoded JSON strings?▼

Parsing Polymarket outcomePrices returns double-encoded JSON strings because the Gamma API formats these specific fields with nested JSON encoding. The skill automatically handles parsing these double-encoded JSON fields, along with clobTokenIds, to properly extract Yes/No prices and volume data.

What is the best way to search Polymarket events and list trending prediction markets?▼

The best way to search Polymarket events and list trending prediction markets is to query the Gamma API using specific search terms. This read-only method inspects event-level market groupings, returning market listings, current outcome prices, and summary volumes directly from public endpoints.

Do I need authentication keys to access Polymarket CLOB and Gamma API endpoints?▼

No, you do not need authentication keys to access Polymarket CLOB, Gamma, and Data API endpoints for reading public market data. The skill exclusively uses read-only public REST API calls to search markets, retrieve orderbooks, and fetch price history without requiring any authentication setup.