Skip to main content
Everything else in the Perps API is live market data. This section is different: it answers questions that need accumulated history and a view across every account — which Polymarket’s API cannot give you, because its perps trades carry no account attribution and it only ever returns a wallet’s current portfolio. We capture every perps account’s portfolio continuously, so we can serve:
EndpointQuestion it answers
Whale LeaderboardWho are the biggest perps accounts — by equity, exposure, or PnL?
PositioningIs the crowd net long or short on an instrument, and how is that shifting?
Large PositionsWhich accounts are holding the biggest positions right now?
Position HistoryHow has one wallet’s position changed over time?

​
Freshness and honesty

These read from an archive we’ve been building continuously. Every row carries an as_of or snapshot_ts timestamp so you always know how fresh it is. Position history reaches back only as far as we’ve been capturing (it began July 9, 2026 and grows from there) — we never present a gap as if it were complete data. For the current, exact state of any single wallet, the live portfolio endpoint is always available as a pass-through.

​
A note on wallets

All of these accept either address form — a Polymarket profile address or the underlying signer — and resolve it automatically (how that works).