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

curl "https://api.struct.to/v1/polymarket/holders/markets?condition_id=0xabc..." \
  -H "X-API-Key: YOUR_API_KEY"

Guide: Holder Metrics Tracking
SDK: Holders namespace
Core concepts

Introduction

Market

Events

Series

Trader

Combos

Holders

Order Book

Builders

Tags

Analytics

Assets

Bonds

Search

Polymarket Holders API

Current holders

History

Position context

Example

​Current holders

​History

​Position context

​Example

​Related

Current holders

History

Position context

Example

Related