A holder list is a snapshot, not a signal

A leaderboard is tempting to read as a forecast. It is safer to treat it as a dated snapshot of public positions, with limits on what the snapshot can tell you.

Polymarket's analytics documentation exposes the largest public holders for each outcome. The response includes position size and public profile fields, with optional position economics for a single condition ID.

Read the grouping first

Holder results are grouped by outcome asset. Page size applies separately to each outcome, so a partial page is not a complete cross-outcome ranking until the groups are merged.

Keep the asset ID and outcome together in your storage. A large amount on one token should not be silently compared with a different outcome's amount as if they shared the same row.

Separate size from intent

The list can show amount, verification status, and optional average price or PnL fields. It does not, by itself, explain why a wallet holds the position, when it entered, or whether it plans to exit.

A pseudonym or profile label is context, not a trading thesis. Use it to identify a public record, not to invent a story about the person behind it.

Save the observation time

Holder rankings can change as positions move. Store the condition ID, asset ID, page cursor, and retrieval time so a later comparison can distinguish a new snapshot from a missing page.

The useful question is not who appears at the top today. It is what the public snapshot actually measured, what it left out, and how that evidence fits the market's rules.

Further reading: Public analytics.

Explore the markets: Open Polymarket (referral link).