Overview

All market data is available through public REST endpoints. No API key, no authentication, no wallet required.

curl "https://gamma-api.polymarket.com/events?limit=5"

Data Model

Polymarket structures data using two organizational models. The most fundamental element is always markets—events simply provide additional organization.

Event

A top-level object representing a question (e.g., “Who will win the 2024 Presidential Election?”). Contains one or more markets.

Market

A specific tradable binary outcome within an event. Maps to a pair of CLOB token IDs, a market address, a question ID, and a condition ID.

Single-Market Events vs Multi-Market Events

Type	Example
Single-market event	”Will Bitcoin reach $100k?” → 1 market (Yes/No)
Multi-market event	”Where will Barron Trump attend College?” → Markets for Georgetown, NYU, UPenn, Harvard, Other

Outcomes and Prices

Each market has outcomes and outcomePrices arrays that map 1:1. 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)

Markets can be traded via the CLOB if enableOrderBook is true.

Available Data

Endpoints are split across three APIs. See the API Reference for full endpoint documentation with parameters and response schemas.

Gamma API - Events Markets and Discovery

Endpoint	Description
`GET /events`	List events with filtering and pagination
`GET /events/{id}`	Get a single event by ID
`GET /markets`	List markets with filtering and pagination
`GET /markets/{id}`	Get a single market by ID
`GET /public-search`	Search across events, markets, and profiles
`GET /tags`	Ranked tags/categories
`GET /series`	Series (grouped events)
`GET /sports`	Sports metadata
`GET /teams`	Teams

CLOB API - Prices and Orderbooks

Endpoint	Description
`GET /price`	Price for a single token
`GET /prices`	Prices for multiple tokens
`GET /book`	Order book for a token
`POST /books`	Order books for multiple tokens
`GET /prices-history`	Historical price data for a token
`GET /midpoint`	Midpoint price for a token
`GET /spread`	Spread for a token

Data API - Positions Trades and Analytics

Endpoint	Description
`GET /positions?user={address}`	Current positions for a user
`GET /closed-positions?user={address}`	Closed positions for a user
`GET /activity?user={address}`	Onchain activity for a user
`GET /value?user={address}`	Total position value
`GET /oi`	Open interest for a market
`GET /holders`	Top holders of a market
`GET /trades`	Trade history

Data Model

Single-Market Events vs Multi-Market Events

Outcomes and Prices

Available Data

Gamma API - Events Markets and Discovery

CLOB API - Prices and Orderbooks

Data API - Positions Trades and Analytics

Next Steps

Fetching Markets

API Reference

​Data Model

​Single-Market Events vs Multi-Market Events

​Outcomes and Prices

​Available Data

​Gamma API - Events Markets and Discovery

​CLOB API - Prices and Orderbooks

​Data API - Positions Trades and Analytics

​Next Steps

Fetching Markets

API Reference

Data Model

Single-Market Events vs Multi-Market Events

Outcomes and Prices

Available Data

Gamma API - Events Markets and Discovery

CLOB API - Prices and Orderbooks

Data API - Positions Trades and Analytics

Next Steps