> ## 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.

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

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

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

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

> **[Trade history](/api-docs/api-docs/openapi/trader-trades)**
>
> Newest-first trade history.

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

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

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

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

```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](/api-docs/api-docs/openapi/analytics-overview)**
>
> Platform-wide counts and volume across events, markets, and traders.

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

## Search

> **[Search](/api-docs/api-docs/openapi/search)**
>
> 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.