Polymarket Markets API

​

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

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