---
title: "PnL leaderboard"
method: GET
path: "/v1/leaderboards/pnl"
tags: ["Leaderboards"]
---

# PnL leaderboard

`GET /v1/leaderboards/pnl`

## Request

- Base URL: `https://crowdintel.xyz/api`
- URL: `https://crowdintel.xyz/api/v1/leaderboards/pnl`
- Auth: HTTP bearer

**Min tier: `free`.** Wallets ranked by accounting-grade PnL, routed per wallet class (see `pnl_source`): Polymarket's own figure when available, the on-chain cash ledger for retail wallets, and null/0 (`pnl_source: none`) for market-maker/whale wallets pending refresh. `free` keys see the top 25; `terminal`+ paginate to depth 500. Cursor-paginated.

## Query parameters

- `sort_dir` 'asc' | 'desc'
- `limit` integer
- `min_resolved_bets` integer
- `cursor` string

## Response `200`

Cursor-paginated leaderboard rows.

- object
  - `data` LeaderboardEntry[]
    - `address` string
    - `polymarket_name` string, nullable
    - `total_volume` number, nullable
    - `total_pnl` number, nullable
    - `pnl_source` 'polymarket_api' | 'ledger' | 'none': Where the PnL figure comes from: `polymarket_api` = Polymarket's own profit figure, `ledger` = CrowdIntel on-chain cash ledger (retail wallets), `none` = no trustworthy figure yet (market-maker/whale wallets pending refresh report null/0).
    - `pnl_as_of` string, date-time, nullable: Freshness timestamp of the PnL figure; null when `pnl_source` is `none`.
    - `win_rate` number, nullable
    - `z_score` number, nullable
    - `total_bets` integer, nullable
  - `next_cursor` string, nullable

## Other responses

- `400`: Malformed parameters or a rejected guardrail (e.g. unfiltered trades query, cluster blowup, window > 90 days).
- `401`: Missing, invalid, or revoked API key. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `403`: Key valid but its tier is below this endpoint's minimum. Returned before the rate limiter runs, so it carries no `X-RateLimit-*` headers.
- `429`: Hourly or monthly rate limit exceeded.

---

[API](https://skmtc.dev/crowdintel/apis/crowdintel-api.md) · [All operations](https://skmtc.dev/crowdintel/apis/crowdintel-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crowdintel/apis/crowdintel-api/revisions/7059cfe9320d?raw)