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

# KOL Leaderboard

> Rank the best tracked wallets by PnL, win rate, trades or volume on any chain. Endpoints, chains, first steps and a cookbook.

Rank the best tracked wallets on any chain, by PnL, win rate, trades or volume. Show the top traders as a podium and the rest in a sortable table. It answers a simple question, who is winning right now.

## What it shows

A ranked list of KOL, Smart Money or Whale wallets for a chosen period, each with PnL, win rate, trade count and volume. Use it as a discovery page for the best wallets to follow or copy.

## Blockchains

Solana, BNB, Base, ETH and Robinhood. Solana has KOL, Smart Money and Whale. BNB and Base have KOL and Smart Money. ETH and Robinhood have KOL and Smart Money.

## Endpoints

One call returns the whole ranked list.

<Card title="GET /v1/wallet/leaderboard" href="https://docs.cabalspy.xyz/leaderboard">
  Ranked wallets for a chain, wallet type and period, each with a profile, period stats and win rate.
</Card>

## First steps

<Steps>
  <Step title="Get an API key">
    Register at [apidashboard.cabalspy.xyz](https://apidashboard.cabalspy.xyz) and create a key.
  </Step>

  <Step title="Choose chain, type and period">
    Pick a chain, a wallet type (kol, smart or whale, where the chain supports it) and a period of 6h, 1d, 7d or 30d.
  </Step>

  <Step title="Call the leaderboard endpoint">
    Pass blockchain, type, period and api\_key. The response carries the ranked list.
  </Step>
</Steps>

```bash Quick test theme={null}
curl "https://api.cabalspy.xyz/v1/wallet/leaderboard?blockchain=solana&type=kol&period=1d&api_key=YOUR_KEY"
```

## Build it

<CardGroup cols={2}>
  <Card title="Cookbook, Leaderboard" href="https://docs.cabalspy.xyz/build-a-leaderboard-like-axiom-vision">
    Build the ranked, searchable leaderboard step by step.
  </Card>

  <Card title="GitHub demo" icon="github" href="https://github.com/CabalSpy/Leaderboard-Demo">
    Open-source, run in minutes.
  </Card>
</CardGroup>