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.