Polymarket Markets API

Market discovery, pricing, trades, and per-market analytics on Polymarket.

A market is a single tradable question on Polymarket, identified by its condition_id. Each market resolves into one or more outcome positions, and every position has its own position_id. The Market endpoints cover discovery, metadata, price and volume history, candlesticks, trades, top traders, and per-market analytics.

Discover

• List and filter markets by tag, status, or closed state.
• Fetch a single market by condition ID or by slug.

Price and volume

• Get a market price chart or OHLC candlesticks.
• Chart market volume over time.
• Drill into a single outcome with position candlesticks and the position volume chart.

Activity and metrics

• Page through a market’s trades.
• Detect sudden price jumps across markets.
• Surface top traders for a market or for a position.
• Read live market metrics and position metrics.
• List oracle events for resolution tracking.

Analytics

• Per-market percentage change, per-bucket candles, and cumulative timeseries.

Order book and holders

• See live CLOB depth with the order book for a position or every book in a market, and track spread history.
• See who holds a market with market holders and their history over time.
• View markets through a fixed-income lens with bonds.

Example

SDK

import { StructClient } from "@structbuild/sdk";

const client = new StructClient({ apiKey: "YOUR_API_KEY" });

const { data: markets } = await client.markets.getMarkets({ limit: 10, tags: "politics" });

const { data: market } = await client.markets.getMarket({ conditionId: "0xabc..." });

const { data: candles } = await client.markets.getCandlestick({
  condition_id: "0xabc...",
  resolution: "1h",
});

Related

• Guides: Finding Market Movers, TradingView Charts, CLOB Liquidity Markets Dashboard
• SDK: Markets namespace
• Core concepts