Jiayaoqijia Official Polymarket

---
name: polymarket
description: >
  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.
---

# 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