Making Polymarket Exchange Data Accessible for Research

Polymarket supports large, multi-option events such as “Who will win the 2024 Presidential Election?” An event contains underlying binary markets, such as “Will Joe Biden win the 2024 Presidential Election?” Traders can place market and limit orders to buy or sell Yes and No outcomes.

• conditionId: The unique blockchain address assigned to an event with a binary outcome.

  Example: 0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be

• token_id / clobTokenId: The unique identifier assigned to each Yes or No token in an event.

  Example: 98022490269692409998126496127597032490334070080325855126491859374983463996227

• address / proxyWallet: The unique blockchain address for a wallet, which can also identify a public profile.

  Example: 0x6A9D222616C90FcA5754cd1333cFD9b7fb6a4F74https://polymarket.com/0x6A9D222616C90FcA5754cd1333cFD9b7fb6a4F74 (opens in a new tab)

• market_slug / slug: The unique readable string used to construct a market or event URL.

  Example: what-will-happen-before-gta-vihttps://polymarket.com/event/what-will-happen-before-gta-vi (opens in a new tab)

The Gamma API provides market- and event-level data. List active markets with limit and offset pagination; the maximum limit is 500.

curl "https://gamma-api.polymarket.com/markets?active=true&limit=100&offset=0"

Retrieve one market or event by its ID:

curl "https://gamma-api.polymarket.com/{markets OR events}/{id}"

Ranked tags and categories—such as NBA or politics—can be used to discover related markets and events.

curl "https://gamma-api.polymarket.com/tags"

The following request retrieves a complete market record:

curl "https://gamma-api.polymarket.com/markets/540817"

More Gamma API applications are documented in the Events API reference (opens in a new tab).

CLOB requests require the specific token_id for a Yes or No outcome. The clobTokenIds returned by Gamma provide those identifiers.

curl "https://clob.polymarket.com/price?token_id={token_id}&side=BUY"

curl "https://clob.polymarket.com/price?token_id=98022490269692409998126496127597032490334070080325855126491859374983463996227&side=BUY"

{"price":"0.5"}

Therefore, $0.50 was the best price for the Yes token on the order book on July 20.

To retrieve time-series data:

curl "https://clob.polymarket.com/prices-history?market={token_id}&interval={XX}&fidelity={XX}"

curl "https://clob.polymarket.com/prices-history?market=98022490269692409998126496127597032490334070080325855126491859374983463996227&interval=1d&fidelity=10"

{"history":[{"t":1784493604,"p":0.505},{"t":1784494204,"p":0.505},{"t":1784494818,"p":0.505},{"t":1784495406,"p":0.505},{"t":1784496006,"p":0.505}...]}

Fees, tick sizes, bid-ask spreads, and other data points are available in the Orderbook & Pricing documentation (opens in a new tab).

The Data API provides user-level history and trade data on markets. Trade history can be filtered by market, user, or time range.

curl "https://data-api.polymarket.com/trades?market={condition_id}&limit=500"

curl "https://data-api.polymarket.com/trades?market=0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be&limit=500"

[{"proxyWallet":"0x2f54bd8300000000000000000000000000000000","side":"SELL","asset":"98022490269692409998126496127597032490334070080325855126491859374983463996227","conditionId":"0x1fad72fae204143ff1c3035e99e7c0f65ea8d5cd9bd1070987bd1a3316f772be","size":1.98,"price":0.5}...]

The returned proxyWallet can be used as the address when studying a user’s behavior and history.

Closed positions for a user:

curl "https://data-api.polymarket.com/closed-positions?user={address}"

Total portfolio value for a user:

curl "https://data-api.polymarket.com/value?user={address}"

User positions, open interest, market history, and related endpoints are available in the Profile API documentation (opens in a new tab).