Polymarket Holders API

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, or of a single position.

History

Track holder counts and distribution over time for a market, a position, or an event.

Position context

Pair holder data with live position metrics and market metrics, or read the order book for the depth behind a position.

Example

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..." });

Guide: Holder Metrics Tracking
SDK: Holders namespace
Core concepts

​Current holders

​History

​Position context

​Example

​Related

Current holders

History

Position context

Example

Related