Skip to main content
GET
Get PnL Leaderboard (V2)
V2 is the recommended leaderboard API. It provides a simpler, filter-based approach compared to the section-based V1 endpoint.

V2 vs V1 Comparison

Key Features

Chain Filtering

Filter traders by one or more chains:
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:

Per-Chain PnL Breakdown

The V2 response includes a breakdown of PnL per chain:

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:

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
viewerAddresses
string[]

Optional viewer address(es) to populate isFollowedByUser. Accepts a single address or an array of the viewer’s linked wallets (additional addresses beyond 10 are ignored).

onlyWithComments
enum<string>
default:false
Available options:
true,
false
timeframe
enum<string>
default:30d
Available options:
7d,
30d

Response

200

traders
object[]
required