> ## Documentation Index
> Fetch the complete documentation index at: https://coinstats.app/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.

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

<CardGroup cols={2}>
  <Card title="Leaderboard" icon="ranking-star" href="/docs/openapi/list-traders">
    Rank by PnL (multiple windows), score, volume, win rate, or ROI; filter by `tier`.
  </Card>

  <Card title="Top traders" icon="crown" href="/docs/openapi/top-traders">
    The top tier-1/tier-2 traders by PnL or volume.
  </Card>

  <Card title="Trader profile" icon="id-badge" href="/docs/openapi/get-trader">
    Enriched profile with live PnL, cash balance, portfolio value, and rank.
  </Card>

  <Card title="Open positions" icon="layer-group" href="/docs/openapi/trader-positions">
    Current positions with cost basis and unrealized PnL.
  </Card>

  <Card title="Trade history" icon="receipt" href="/docs/openapi/trader-trades">
    Newest-first trade history.
  </Card>

  <Card title="Trade stats" icon="chart-pie" href="/docs/openapi/trader-trade-stats">
    Aggregate trade statistics plus a headline PnL summary.
  </Card>

  <Card title="Category stats" icon="tags" href="/docs/openapi/trader-category-stats">
    Per-category analytics plus best/worst positions.
  </Card>

  <Card title="Trader score" icon="star" href="/docs/openapi/trader-score">
    Composite score across performance, consistency, volume, experience.
  </Card>
</CardGroup>

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

```bash theme={null}
# Top 20 traders by 30-day PnL
curl "https://api.polystats.ai/api/traders?sort=pnl30d&limit=20" \
  -H "X-API-KEY: YOUR_API_KEY"

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

## Platform analytics

<CardGroup cols={2}>
  <Card title="Overview" icon="gauge" href="/docs/openapi/analytics-overview">
    Platform-wide counts and volume across events, markets, and traders.
  </Card>

  <Card title="Market signals" icon="signal" href="/docs/openapi/analytics-market-signals">
    Composite whale + smart-money signals with a buy/sell recommendation.
  </Card>
</CardGroup>

## Search

<CardGroup cols={1}>
  <Card title="Search" icon="magnifying-glass" href="/docs/openapi/search">
    Search across events, markets, and traders in one call.
  </Card>
</CardGroup>

```bash theme={null}
# Search markets, events, and traders at once
curl "https://api.polystats.ai/api/search?q=election&limit=10" \
  -H "X-API-KEY: YOUR_API_KEY"
```