# Polymarket

> Query Polymarket prediction markets — top markets, search, event details, and odds. Use when asked about prediction markets, event odds, Polymarket data, election markets, crypto predictions, or betting odds on real-world events.

- Skill: `jiayaoqijia/polymarket-2` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add jiayaoqijia/polymarket-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jiayaoqijia/polymarket-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: jiayaoqijia (https://skillmd.com/u/jiayaoqijia)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jiayaoqijia/polymarket-2

---


# Polymarket

Query prediction market data from Polymarket. Free, no authentication required for read operations.

## API

Base: `https://gamma-api.polymarket.com`

**Top markets by volume**:
```
web_fetch url="https://gamma-api.polymarket.com/markets?limit=20&order=volume24hr&ascending=false&active=true"
```

**Search markets**:
```
web_fetch url="https://gamma-api.polymarket.com/markets?limit=10&active=true&tag=crypto"
```

**Market by slug**:
```
web_fetch url="https://gamma-api.polymarket.com/markets?slug=will-bitcoin-reach-100k-in-2026"
```

**Events list**:
```
web_fetch url="https://gamma-api.polymarket.com/events?limit=20&active=true&order=volume24hr&ascending=false"
```

**Event by slug**:
```
web_fetch url="https://gamma-api.polymarket.com/events?slug=2026-us-midterms"
```

## CLOB API (Order Book)

Base: `https://clob.polymarket.com`

**Market order book**:
```
web_fetch url="https://clob.polymarket.com/book?token_id=TOKEN_ID"
```

**Market price history**:
```
web_fetch url="https://clob.polymarket.com/prices-history?market=CONDITION_ID&interval=1d&fidelity=60"
```

## Response Fields

| Field | Description |
|-------|-------------|
| `question` | The market question |
| `outcomePrices` | Current prices (probabilities) for each outcome |
| `volume` | Total volume traded (USD) |
| `volume24hr` | 24-hour volume |
| `liquidity` | Current liquidity in the market |
| `endDate` | Market resolution date |
| `active` | Whether market is still trading |
| `outcomes` | Array of outcome names |

## Use Cases

- **Event forecasting**: check odds on elections, crypto milestones, geopolitical events
- **Sentiment gauge**: market-implied probabilities as a signal for other strategies
- **Arbitrage detection**: compare Polymarket odds with other prediction platforms
- **Portfolio hedging**: identify hedge opportunities for crypto positions

## Usage Tips

- Prices represent probabilities (0.65 = 65% chance)
- Volume and liquidity indicate market confidence
- Active markets only — check `active=true` filter
- Markets resolve based on verifiable real-world outcomes
- Polymarket operates on Polygon for settlement