> ## Documentation Index
> Fetch the complete documentation index at: https://docs.struct.to/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/api-reference/market/get-markets) by tag, status, or closed state.
* Fetch a single market [by condition ID](/api-reference/market/get-market-by-condition-id) or [by slug](/api-reference/market/get-market-by-slug).

## Price and volume

* [Get a market price chart](/api-reference/market/get-market-chart) or [OHLC candlesticks](/api-reference/market/get-market-candlesticks-by-condition_id).
* [Chart market volume over time](/api-reference/market/get-market-volume-chart).
* Drill into a single outcome with [position candlesticks](/api-reference/market/get-position-candlesticks-by-position_id) and the [position volume chart](/api-reference/market/get-position-volume-chart).

## Activity and metrics

* [Page through a market's trades](/api-reference/market/get-market-trades).
* [Detect sudden price jumps](/api-reference/market/detect-price-jumps) across markets.
* Surface top traders [for a market](/api-reference/market/get-top-traders-for-a-market) or [for a position](/api-reference/market/get-top-traders-for-a-position).
* Read live [market metrics](/api-reference/market/get-market-metrics) and [position metrics](/api-reference/market/get-position-metrics).
* [List oracle events](/api-reference/market/list-oracle-events) for resolution tracking.

## Analytics

* Per-market [percentage change](/api-reference/market/market-analytics-pct-change), [per-bucket candles](/api-reference/market/market-analytics-candles-per-bucket-deltas), and [cumulative timeseries](/api-reference/market/market-analytics-timeseries-cumulative).

## Order book and holders

* See live CLOB depth with the [order book for a position](/api-reference/order-book/get-order-book) or [every book in a market](/api-reference/order-book/get-order-books-for-a-market), and track [spread history](/api-reference/order-book/get-spread-history).
* See who holds a market with [market holders](/api-reference/holders/get-market-holders) and their [history over time](/api-reference/holders/get-market-holders-history).
* View markets through a fixed-income lens with [bonds](/api-reference/bonds/get-bonds).

## Example

<CodeGroup>
  ```typescript SDK theme={null}
  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",
  });
  ```

  ```bash cURL theme={null}
  curl "https://api.struct.to/v1/polymarket/market?limit=10&tags=politics" \
    -H "X-API-Key: YOUR_API_KEY"
  ```
</CodeGroup>

## Related

* Guides: [Finding Market Movers](/guides/finding-market-movers), [TradingView Charts](/guides/tradingview-charts), [CLOB Liquidity Markets Dashboard](/guides/clob-liquidity-markets-dashboard)
* SDK: [Markets namespace](/sdk/rest-api#markets)
* [Core concepts](/introduction/concepts)