Skip to main content
skill CX Codex

polymarket · nousresearch — Claude Code skill: what it does, how to install

Pulls Polymarket data through its public REST APIs: markets, prices, orderbooks and history. Use it when you want the odds the market gives some event.

MIT 282 installs ★ 265,216 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NousResearch/hermes-agent --skill polymarket -a claude-code
Open on GitHub

What polymarket does

This skill lets the agent look up what Polymarket traders expect to happen. It uses three public APIs and needs no key. Gamma (gamma-api.polymarket.com) handles search and browsing. CLOB (clob.polymarket.com) serves live prices, orderbooks and price history. Data (data-api.polymarket.com) returns trades and open interest.

A market price is a probability, so 0.65 reads as 65%. The agent searches Gamma, unpacks events and their markets, then reports the question, Yes/No percentages and volume in USDC. Orderbook lookups use clobTokenIds, and history uses conditionId. Watch outcomePrices, outcomes and clobTokenIds: they arrive as JSON strings nested inside JSON, so Python code has to run json.loads on them.

It cannot place trades. Orders need wallet signatures (EIP-712), and the skill only reads. New markets sometimes return empty price history. Rate limits are generous: 4,000 requests per 10 seconds for Gamma, 9,000 for CLOB, 1,000 for Data.

What it helps with

  • look up the probability of an event from a market price
  • search Polymarket for markets on a topic
  • read the Yes/No orderbook for a market
  • pull price history for a market by its conditionId
  • track how a prediction market moves over time

Example prompts for the agent

  • Find Polymarket markets about the election and show the odds as percentages
  • Pull the orderbook and price history for this Polymarket market
  • How much trading volume does this Polymarket market have?

How to install polymarket

1Skills CLI (Vercel)

npx skills add NousResearch/hermes-agent --skill polymarket -a claude-code

2Manually: put the files in place

~/.claude/skills/polymarket/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/polymarket/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about polymarket

How do I install polymarket in Claude Code?

Run npx skills add NousResearch/hermes-agent --skill polymarket -a claude-code. The skill file lives at ~/.claude/skills/polymarket/SKILL.md.

What does polymarket do?

It searches Polymarket markets and shows Yes/No odds as percentages, volume, orderbooks and price history. All data comes from public APIs with no authentication.

Can polymarket place bets?

No, it only reads data. Trading requires a wallet signature (EIP-712), and the skill does not support placing orders.

Source text

SKILL.md · MIT
---
name: polymarket
description: "Query Polymarket: markets, prices, orderbooks, history."
version: 1.0.0
author: Hermes Agent + Teknium
license: MIT
tags: [polymarket, prediction-markets, market-data, trading]
platforms: [linux, macos, windows]
---

# Polymarket — Prediction Market Data

Query prediction market data from Polymarket using their public REST APIs.
All endpoints are read-only and require zero authentication.

See `references/api-endpoints.md` for the full endpoint reference with curl examples.

## When to Use

- User asks about prediction markets, betting odds, or event probabilities
- User wants to know "what are the odds of X happening?"
- User asks about Polymarket specifically
- User wants market prices, orderbook data, or price history
- User asks to monitor or track prediction market movements

## Key Concepts

- **Events** contain one or more **Markets** (1:many relationship)
- **Markets** are binary outcomes with Yes/No prices between 0.00 and 1.00
- Prices ARE probabilities: price 0.65 means the market thinks 65% likely
- `outcomePrices` field: JSON-encoded array like `["0.80", "0.20"]`
- `clobTokenIds` field: JSON-encoded array of two token IDs [Yes, No] for price/book queries
- `conditionId` field: hex string used for price history queries
- Volume is in USDC (US dollars)

## Three Public APIs

1. **Gamma API** at `gamma-api.polymarket.com` — Discovery, search, browsing
2. **CLOB API** at `clob.polymarket.com` — Real-time prices, orderbooks, history
3. **Data API** at `data-api.polymarket.com` — Trades, open interest

## Typical Workflow

When a user asks about prediction market odds:

1. **Search** using the Gamma API public-search endpoint with their query
2. **Parse** the response — extract events and their nested markets
3. **Present** market question, current prices as percentages, and volume
4. **Deep dive** if asked — use clobTokenIds for orderbook, conditionId for history

## Presenting Results

Format prices as percentages for readability:
- outcomePrices `["0.652", "0.348"]` becomes "Yes: 65.2%, No: 34.8%"
- Always show the market question and probability
- Include volume when available

Example: `"Will X happen?" — 65.2% Yes ($1.2M volume)`

## Parsing Double-Encoded Fields

The Gamma API returns `outcomePrices`, `outcomes`, and `clobTokenIds` as JSON strings
inside JSON responses (double-encoded). When processing with Python, parse them with
`json.loads(market['outcomePrices'])` to get the actual array.

## Rate Limits

Generous — unlikely to hit for normal usage:
- Gamma: 4,000 requests per 10 seconds (general)
- CLOB: 9,000 requests per 10 seconds (general)
- Data: 1,000 requests per 10 seconds (general)

## Limitations

- This skill is read-only — it does not support placing trades
- Trading requires wallet-based crypto authentication (EIP-712 signatures)
- Some new markets may have empty price history
- Geographic restrictions apply to trading but read-only data is globally accessible

© Hermes Agent + Teknium · MIT · NousResearch/hermes-agent

Similar skills

All skills for Finance and business →

polymarket by other authors comes first.

polymarket machina-sports Read sports markets on Polymarket, including outcome prices, events, and order books. Useful for checking which side market prices favor. CX Codex +1 1,400installs polymarket starchild This skill searches Polymarket markets, checks positions, and helps place or cancel CLOB V2 orders from a Privy EOA wallet. CX Codex +1 237installs polymarket-scanner polymarket-skills polymarket-scanner searches Polymarket markets and returns prices, volume, liquidity, and order books. Use it when an agent needs current prediction-market data. CX Codex +1 236installs Polymarket Data by PolymarketScan jordan-s648 The Polymarket Data by PolymarketScan MCP server feeds an agent live Polymarket data: whale trades, market prices, trader profiles and leaderboards. CX Codex +1 39,483installs grimoire-polymarket franalgaba grimoire-polymarket discovers Polymarket prediction markets and manages CLOB orderbook trades through the Grimoire venue CLI wrapper. CX Codex +1 11,900installs polymarket-analyzer mjunaidca polymarket-analyzer scans Polymarket prediction markets for arbitrage, order book imbalances, and volume spikes. Useful for traders evaluating price inefficiencies without API keys. CX Codex +1 494installs PredictionMarketsPicks — NFL Props, Kalshi & Polymarket predictionmarketspicks PredictionMarketsPicks — NFL Props, Kalshi & Polymarket is an MCP server for Claude Code that reads Kalshi and Polymarket data, including NFL prices, probabilities, and cross-market gaps. CX Codex +1 1,794installs monitor-polymarket aeonfun monitor-polymarket is a Claude Code skill that tracks price moves, volume shifts, and comments on Polymarket and Kalshi. It compares fresh readings with earlier ones and flags notable changes. CX Codex +1 ★ 797repo stars

From the same set61

The whole set →
docx A skill for creating, reading, editing, and templating Word .docx files via Python CLI scripts. Helpful when automating reports, comments, and tracked changes. CX Codex +1 310installs grounded-citations grounded-citations grounds LLM responses in verifiable sources using Perplexity-style bracketed citations and strict quotation checks via an external ledger. CX Codex +1 307installs openhue Controls Philips Hue lights, rooms, and scenes via OpenHue CLI. Useful for adjusting lighting and triggering presets directly from the terminal. CX Codex +1 288installs pdf A skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode that handles PDF files end to end: build from specs, extract tables, fill forms, merge pages, encrypt. CX Codex +1 283installs inspecting-hermes-desktop-dom The inspecting-hermes-desktop-dom skill reads the live DOM, computed CSS, and console output from Hermes Desktop over CDP. Use it to check whether a UI change took effect or identify the style rule in control. CX Codex +1 263installs github Routes GitHub workflows through the gh CLI, covering issues, PR lifecycles, code reviews, and repo tasks. Designed for tracking delivery straight from the terminal. CX Codex +1 245installs heartmula This skill guides local song creation with HeartMuLa from lyrics and tags. Use it when you want an open-source workflow for AI music generation. CX Codex +1 230installs godmode godmode is a Claude Code skill with three prompt-level routes past model safety filters: templates, word obfuscation, and querying a model pool through OpenRouter. CX Codex +1 214installs

Project sponsors

Companies that keep this analytics open