> ## Documentation Index
> Fetch the complete documentation index at: https://coinstats.app/api-docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](https://coinstats.app/api-docs/api-docs/openapi/list-traders.md)**
>
> Rank by PnL (multiple windows), score, volume, win rate, or ROI; filter by `tier`.

> **[Top traders](https://coinstats.app/api-docs/api-docs/openapi/top-traders.md)**
>
> The top tier-1/tier-2 traders by PnL or volume.

> **[Trader profile](https://coinstats.app/api-docs/api-docs/openapi/get-trader.md)**
>
> Enriched profile with live PnL, cash balance, portfolio value, and rank.

> **[Open positions](https://coinstats.app/api-docs/api-docs/openapi/trader-positions.md)**
>
> Current positions with cost basis and unrealized PnL.

> **[Trade history](https://coinstats.app/api-docs/api-docs/openapi/trader-trades.md)**
>
> Newest-first trade history.

> **[Trade stats](https://coinstats.app/api-docs/api-docs/openapi/trader-trade-stats.md)**
>
> Aggregate trade statistics plus a headline PnL summary.

> **[Category stats](https://coinstats.app/api-docs/api-docs/openapi/trader-category-stats.md)**
>
> Per-category analytics plus best/worst positions.

> **[Trader score](https://coinstats.app/api-docs/api-docs/openapi/trader-score.md)**
>
> Composite score across performance, consistency, volume, experience.

Also available per trader: [activity feed](https://coinstats.app/api-docs/api-docs/openapi/trader-activity.md), [daily PnL history](https://coinstats.app/api-docs/api-docs/openapi/trader-pnl-history.md), and [trade stats](https://coinstats.app/api-docs/api-docs/openapi/trader-trade-stats.md).

```bash theme={null}
# 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](https://coinstats.app/api-docs/api-docs/openapi/analytics-overview.md)**
>
> Platform-wide counts and volume across events, markets, and traders.

> **[Market signals](https://coinstats.app/api-docs/api-docs/openapi/analytics-market-signals.md)**
>
> Composite whale + smart-money signals with a buy/sell recommendation.

> **[Venue volume](https://coinstats.app/api-docs/api-docs/openapi/venue-volume.md)**
>
> Each venue's lifetime and 24h volume with its coverage stated, and each venue's share of the 24h volume.

> **[One venue's volume](https://coinstats.app/api-docs/api-docs/openapi/get-venue-volume.md)**
>
> The same figures for `polymarket`, `kalshi` or `polymarket-us` alone.

```bash theme={null}
# 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"
```

> [!NOTE]
>
> **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](https://coinstats.app/api-docs/api-docs/openapi/search.md)**
>
> Search across events, markets, and traders in one call.

```bash theme={null}
# 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"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.