Traders & Analytics

Trader leaderboards and deep per-trader analytics — positions, PnL, category stats, score — plus platform-wide market signals and venue volume.

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.

# Top 20 traders by 30-day PnL
curl "https://api.coinstats.app/v1/prediction/traders?sort=pnl30d&limit=20" \
  -H "X-API-KEY: YOUR_API_KEY"

# A trader's category analytics (best/worst positions included)
curl "https://api.coinstats.app/v1/prediction/traders/0xWALLET/category-stats" \
  -H "X-API-KEY: YOUR_API_KEY"

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.

Venue volume

Each venue’s lifetime and 24h volume with its coverage stated, and each venue’s share of the 24h volume.

One venue's volume

The same figures for polymarket, kalshi or polymarket-us alone.

# Every venue's volume and the 24h market share
curl "https://api.coinstats.app/v1/prediction/volume?view=all" \
  -H "X-API-KEY: YOUR_API_KEY"

Read coverage before quoting a figure. Polymarket’s totals are complete, and so are Kalshi’s: they cover every open Kalshi market, summed hourly from Kalshi’s catalog, not only the markets the lists return (which is what the overview sums). Polymarket US is partial: the lifetime volume of the markets stored, with volume24hr: null since it publishes no 24-hour volume. marketShare24hr is computed only across venues with complete coverage, so it is null (with marketShareBlockedBy saying why) until two qualify; under view=us it always is.

Search

Search

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

# Search markets, events, and traders at once
curl "https://api.coinstats.app/v1/prediction/search?q=election&limit=10" \
  -H "X-API-KEY: YOUR_API_KEY"