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
npx skills add NousResearch/hermes-agent --skill polymarket -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/polymarket/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/polymarket/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill polymarket -a codex2Manually: put the files in place
.agents/skills/polymarket/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill polymarket -a cursor2Manually: put the files in place
.cursor/skills/polymarket/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install NousResearch/hermes-agent optional-skills/finance/polymarket2Manually: put the files in place
.github/skills/polymarket/SKILL.md1Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill polymarket -a gemini-cli2Platform CLI
gemini skills install https://github.com/NousResearch/hermes-agent --path optional-skills/finance/polymarketManually: put the files in place
.devin/skills/polymarket/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add NousResearch/hermes-agent --skill polymarket -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.