Skip to main content
This is the deepest part of the API. Every trade on Polymarket is attributable to a wallet, so you can rank traders and fully reconstruct what each one is doing. Traders are identified by walletAddress; markets by conditionId.

​
Traders

Leaderboard

Rank by PnL (multiple windows), score, volume, win rate, or ROI; filter by tier.

Top traders

The top tier-1/tier-2 traders by PnL or volume.

Trader profile

Enriched profile with live PnL, cash balance, portfolio value, and rank.

Open positions

Current positions with cost basis and unrealized PnL.

Trade history

Newest-first trade history.

Trade stats

Aggregate trade statistics plus a headline PnL summary.

Category stats

Per-category analytics plus best/worst positions.

Trader score

Composite score across performance, consistency, volume, experience.
Also available per trader: activity feed, daily PnL history, and trade stats.

​
Platform analytics

Overview

Platform-wide counts and volume across events, markets, and traders.

Market signals

Composite whale + smart-money signals with a buy/sell recommendation.

Search

Search across events, markets, and traders in one call.