Skip to main content
GET
/
v2
/
leaderboard
Get PnL Leaderboard (V2)
curl --request GET \
  --url https://api.clicker.xyz/v2/leaderboard \
  --header 'Authorization: Bearer <token>'
{
  "traders": [
    {
      "profile": {
        "id": "<string>",
        "name": "<string>",
        "images": {
          "raw": "<string>",
          "xs": "<string>",
          "sm": "<string>"
        },
        "addresses": [
          "<string>"
        ],
        "metadata": {
          "farcasterUsername": "<string>",
          "farcasterId": 123,
          "lensHandle": "<string>",
          "ensName": "<string>",
          "twitterHandle": "<string>",
          "debankName": "<string>",
          "pumpName": "<string>",
          "commentCount30d": 123,
          "pnl30d": 123,
          "winRate30d": 123,
          "tradeCount30d": 123,
          "roiPercent30d": 123,
          "perAddressPnl30d": {},
          "perAddressRoiPercent30d": {},
          "perChainPnl30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          },
          "perChainRoiPercent30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          },
          "perChainVolumeUsd30d": {
            "solana": 123,
            "ethereum": 123,
            "base": 123,
            "hyperliquid": 123
          }
        },
        "metrics": {
          "thisPartner": {
            "followingCount": 123,
            "followerCount": 123
          },
          "allPartners": {
            "followingCount": 123,
            "followerCount": 123
          },
          "comments": {
            "commentCount30d": 123,
            "commentCountAllTime": 123
          },
          "copytradedAllTime": {
            "count": 123,
            "distinctActors": 123,
            "volumeUSD": 123
          }
        }
      },
      "pnl": {
        "total": 123,
        "perChain": {
          "base": 123,
          "solana": 123,
          "ethereum": 123,
          "hyperliquid": 123
        }
      },
      "hasComments": true,
      "copytrades": {
        "count": 123,
        "distinctActors": 123,
        "volumeUSD": 123
      }
    }
  ]
}
V2 is the recommended leaderboard API. It provides a simpler, filter-based approach compared to the section-based V1 endpoint.

V2 vs V1 Comparison

FeatureV1 (/v1/leaderboard)V2 (/v2/leaderboard)
StructureSection-based (multiple categories)Filter-based (flat list)
Chain selectionPre-defined sections like chain-solanachains query param
PnL dataSingle pnl30 valuepnl.total + pnl.perChain breakdown
Response{ sections: [...] }{ traders: [...] }

Key Features

Chain Filtering

Filter traders by one or more chains:
# Single chain
GET /v2/leaderboard?chains=solana

# Multiple chains (combined PnL)
GET /v2/leaderboard?chains=base&chains=solana
When multiple chains are selected, pnl.total is the sum of PnL across those chains.

Commenters Filter

Show only traders who have posted swap comments:
GET /v2/leaderboard?onlyWithComments=true

Per-Chain PnL Breakdown

The V2 response includes a breakdown of PnL per chain:
{
  "traders": [
    {
      "profile": { ... },
      "pnl": {
        "total": 125000,
        "perChain": {
          "base": 80000,
          "solana": 45000,
          "ethereum": 0,
          "hyperliquid": 0
        }
      },
      "hasComments": true
    }
  ]
}

Supported Chains

  • base - Base (Coinbase L2)
  • solana - Solana
  • ethereum - Ethereum mainnet
  • hyperliquid - Hyperliquid

Migration from V1

If you’re currently using V1 section-based leaderboards:
V1 SectionV2 Equivalent
chain-solana?chains=solana
chain-base?chains=base
chain-ethereum?chains=ethereum
overall?chains=base&chains=solana&chains=ethereum&chains=hyperliquid (or omit chains param)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50
Required range: 0 < x <= 250
chains
Available options:
base,
solana,
ethereum,
hyperliquid
onlyWithComments
enum<string>
default:false
Available options:
true,
false

Response

200

traders
object[]
required