PolymarketDocumentation/docs/quickstart/fetching-data.md

Documentation Index

Fetch the complete documentation index at: https://docs.polymarket.com/llms.txt Use this file to discover all available pages before exploring further.

Fetching Market Data

Fetch Polymarket data in minutes with no authentication required

Get market data with zero setup. No API key, no authentication, no wallet required.

---

Understanding the Data Model

Before fetching data, understand how Polymarket structures its markets:

The top-level object representing a question like "Will X happen?" Each event contains one or more markets. Each market is a specific tradable binary outcome. Markets have `outcomes` and `outcomePrices` arrays that map 1:1. These prices represent implied probabilities.

{
  "outcomes": "[\"Yes\", \"No\"]",
  "outcomePrices": "[\"0.20\", \"0.80\"]"
}
// Index 0: "Yes" → 0.20 (20% probability)
// Index 1: "No" → 0.80 (80% probability)

---

Fetch Active Events

List all currently active events on Polymarket:

curl "https://gamma-api.polymarket.com/events?active=true&closed=false&limit=5"

```json theme={null} [ { "id": "123456", "slug": "will-bitcoin-reach-100k-by-2025", "title": "Will Bitcoin reach $100k by 2025?", "active": true, "closed": false, "tags": [ { "id": "21", "label": "Crypto", "slug": "crypto" } ], "markets": [ { "id": "789", "question": "Will Bitcoin reach $100k by 2025?", "clobTokenIds": ["TOKEN_YES_ID", "TOKEN_NO_ID"], "outcomes": "[\"Yes\", \"No\"]", "outcomePrices": "[\"0.65\", \"0.35\"]" } ] } ] ``` Always use `active=true&closed=false` to filter for live, tradable events.

---

Market Discovery Best Practices

For Sports Events

Use the /sports endpoint to discover leagues, then query by series_id:

# Get all supported sports leagues
curl "https://gamma-api.polymarket.com/sports"

# Get events for a specific league (e.g., NBA series_id=10345)
curl "https://gamma-api.polymarket.com/events?series_id=10345&active=true&closed=false"

# Filter to just game bets (not futures) using tag_id=100639
curl "https://gamma-api.polymarket.com/events?series_id=10345&tag_id=100639&active=true&closed=false&order=startTime&ascending=true"

`/sports` only returns automated leagues. For others (UFC, Boxing, F1, Golf, Chess), use tag IDs via `/events?tag_id=`.

For Non-Sports Topics

Use /tags to discover all available categories, then filter events:

# Get all available tags
curl "https://gamma-api.polymarket.com/tags?limit=100"

# Query events by topic
curl "https://gamma-api.polymarket.com/events?tag_id=2&active=true&closed=false"

Each event response includes a `tags` array, useful for discovering categories from live data and building your own tag mapping.

---

Get Market Details

Once you have an event, get details for a specific market using its ID or slug:

curl "https://gamma-api.polymarket.com/markets?slug=will-bitcoin-reach-100k-by-2025"

The response includes clobTokenIds, you'll need these to fetch prices and place orders.

---

Get Current Price

Query the CLOB for the current price of any token:

curl "https://clob.polymarket.com/price?token_id=YOUR_TOKEN_ID&side=buy"

```json theme={null} { "price": "0.65" } ```

---

Get Orderbook Depth

See all bids and asks for a market:

curl "https://clob.polymarket.com/book?token_id=YOUR_TOKEN_ID"

```json theme={null} { "market": "0x...", "asset_id": "YOUR_TOKEN_ID", "bids": [ { "price": "0.64", "size": "500" }, { "price": "0.63", "size": "1200" } ], "asks": [ { "price": "0.66", "size": "300" }, { "price": "0.67", "size": "800" } ] } ```

---

More Data APIs

Deep dive into market discovery Positions, activity, and holders data Real-time orderbook updates Real-time data streaming service