{
"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>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123,
"perAddressPnl30d": {},
"perAddressRoiPercent30d": {}
},
"isNSFW": false,
"metrics": {
"thisPartner": {
"followingCount": 123,
"followerCount": 123
},
"allPartners": {
"followingCount": 123,
"followerCount": 123
},
"comments": {
"commentCount30d": 123,
"commentCountAllTime": 123
},
"copytradedAllTime": {
"count": 123,
"distinctActors": 123,
"volumeUSD": 123
}
},
"externalId": "<string>",
"isFollowedByUser": true
},
"pnl": {
"total": 123,
"perChain": {
"base": 123,
"solana": 123,
"ethereum": 123,
"hyperliquid": 123
}
},
"hasComments": true,
"isFollowedByUser": true
}Response Types
Trader
A trader on the V2 leaderboard, including their profile, PnL breakdown by chain, and optionally their copytrade stats.
Structure
{
profile: ProfileExtended, // Full profile with metrics
pnl: {
total: number, // Combined PnL across selected chains
perChain?: { // Per-chain breakdown (optional, partial record)
base?: number,
solana?: number,
ethereum?: number,
hyperliquid?: number
}
},
hasComments: boolean, // Whether this trader has posted swap comments
copytrades?: { // Only present on /v2/leaderboard/copytraded
count: number, // Total copytrades of their comments
distinctActors: number, // Unique users who copied
volumeUSD: number // Total volume from copytrades
}
}
PnL Calculation
pnl.totalis calculated by summingpnl.perChainvalues for the chains requested in the query- If no
chainsparameter is provided, all chains are included - All values are 30-day realized PnL in USD