Skip to main content
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:
1

Event

The top-level object representing a question like “Will X happen?”
2

Market

Each event contains one or more markets. Each market is a specific tradable binary outcome.
3

Outcomes & Prices

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"

[
  {
    "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=<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"

{
  "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"

{
  "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

Gamma API

Deep dive into market discovery

Data API

Positions, activity, and holders data

WebSocket

Real-time orderbook updates

RTDS

Real-time data streaming service