> ## 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 Holders API

> Current and historical holders of markets, positions, and events.

Holders are the wallets currently holding a position in a market. The Holders endpoints return the current holder set for a market or a single position, plus historical holder snapshots over time for markets, positions, and events.

## Current holders

* [Get the top holders of a market](/api-reference/holders/get-market-holders), or [of a single position](/api-reference/holders/get-position-holders).

## History

* Track holder counts and distribution over time for a [market](/api-reference/holders/get-market-holders-history), a [position](/api-reference/holders/get-position-holders-history), or an [event](/api-reference/holders/get-event-holders-history).

## Position context

* Pair holder data with live [position metrics](/api-reference/market/get-position-metrics) and [market metrics](/api-reference/market/get-market-metrics), or read the [order book](/api-reference/order-book/get-order-book) for the depth behind a position.

## Example

<CodeGroup>
  ```typescript SDK theme={null}
  import { StructClient } from "@structbuild/sdk";

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

  const { data: holders } = await client.holders.getMarketHolders({ condition_id: "0xabc..." });

  const { data: history } = await client.holders.getMarketHoldersHistory({ condition_id: "0xabc..." });
  ```

  ```bash cURL theme={null}
  curl "https://api.struct.to/v1/polymarket/holders/markets?condition_id=0xabc..." \
    -H "X-API-Key: YOUR_API_KEY"
  ```
</CodeGroup>

## Related

* Guide: [Holder Metrics Tracking](/guides/holder-metrics-tracking)
* SDK: [Holders namespace](/sdk/rest-api#holders)
* [Core concepts](/introduction/concepts)