skills.rest
ruiyangruiyi
ruiyangruiyiCOMMUNITY
Explore all skills by this author →
GitHub

polymarket

Retrieves Polymarket events and converts outcome prices to percentages.

Updated May 26, 2026
Search Tags:#market data#orderbook#polymarket#odds#price history#prediction markets#api querying
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill polymarket-ruiyangruiyi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: polymarket
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/skills/research/polymarket
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill polymarket-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill helps users quickly understand prediction market odds by retrieving events, markets, prices, orderbooks, and price history from Polymarket’s public APIs.

Core Features & Use Cases

  • Discover and search markets using Polymarket’s Gamma public-search API to find relevant events by a natural-language query.
  • Present readable probabilities by converting Polymarket outcome prices into percentage odds (e.g., 0.652 → 65.2%).
  • Deep-dive for orderbooks and history by using clobTokenIds for book/price queries and conditionId for price history.
  • Use cases: “What are the odds of X happening?”, market tracking requests, and comparisons of prediction-market movements over time.

Quick Start

Ask for Polymarket odds by saying: "What are the current odds on Polymarket for {your question} and show the event 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 prediction market odds from Polymarket?▼

You can retrieve live prediction market odds by searching Polymarket events via the Gamma public-search API and converting the returned outcomePrices into human-readable probability percentages. This Skill handles the API querying and price-to-percentage conversion automatically.

Can I look up orderbook data and price history for specific Polymarket markets?▼

Yes, you can look up orderbook data and price history for specific Polymarket markets by using clobTokenIds for book and price queries and conditionId for retrieving historical price trends. This Skill queries the public REST endpoints on clob.polymarket.com to fetch this data.

How do I convert Polymarket outcome prices to probability percentages?▼

Converting Polymarket outcome prices to probability percentages involves parsing the double-encoded JSON outcomePrices field and multiplying the value by 100, such as turning 0.652 into 65.2%. This Skill performs the data retrieval and conversion to present readable probabilities.

Does the Polymarket API require double-encoded JSON handling for outcomePrices and clobTokenIds?▼

Yes, the Polymarket API requires correct handling of double-encoded JSON fields such as outcomePrices and clobTokenIds to successfully retrieve prediction market data. This Skill manages the decoding process when querying gamma-api.polymarket.com and clob.polymarket.com.

What are the limitations of using public REST endpoints for prediction market data?▼

Limitations of using public REST endpoints for prediction market data include dependency on the availability and rate limits of gamma-api.polymarket.com and clob.polymarket.com. This Skill is restricted to retrieving publicly exposed events, markets, orderbooks, and price history.

Related Skills

Explore More Data & Analytics Skills→
peteromalletpeteromallet
97

polymarket

Fetch Polymarket market data, prices, and orderbooks from public REST APIs.

Community
Intermediate
automatedigitalautomatedigital
1

polymarket

Query Polymarket prediction market data via public REST APIs.

Official
Intermediate
ashiqcodeleafashiqcodeleaf

polymarket

Fetch real-time Polymarket prediction market data with search, price, volume, orderbook, and history queries.

Community
Intermediate
davpatel605-beepdavpatel605-beep

polymarket

Retrieve and analyze Polymarket prediction market data from Gamma, CLOB, and Data APIs.

Community
Intermediate