{
"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>",
"hlName": "<string>",
"commentCount30d": 123,
"pnl30d": 123,
"winRate30d": 123,
"tradeCount30d": 123,
"roiPercent30d": 123,
"pnl7d": 123,
"winRate7d": 123,
"tradeCount7d": 123,
"roiPercent7d": 123,
"medianHoldingTimeMinutes": 123,
"perAddressPnl30d": {},
"perAddressRoiPercent30d": {}
},
"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
Leaderboard
The V2 leaderboard response containing a flat list of traders sorted by combined PnL.
Structure
{
traders: TraderV2[] // Sorted by pnl.total descending
}
Differences from V1
| V1 Response | V2 Response |
|---|---|
{ sections: [{ key, title, commenters, others }] } | { traders: [...] } |
| Multiple categories in one response | Single filtered list |
Traders split into commenters and others | Single list with hasComments flag |
PnL in reason.value | PnL in pnl.total and pnl.perChain |
Example
{
"traders": [
{
"profile": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "TopTrader",
"images": {
"raw": "https://example.com/avatar.png",
"xs": "https://example.com/avatar-75.png",
"sm": "https://example.com/avatar-300.png"
},
"addresses": ["0x1234..."],
"metadata": { "pnl30d": 250000, "winRate30d": 0.72 },
"metrics": {
"thisPartner": { "followerCount": 100, "followingCount": 50 },
"allPartners": { "followerCount": 320, "followingCount": 50 },
"comments": { "commentCount30d": 12, "commentCountAllTime": 48 },
"copytradedAllTime": {
"count": 85,
"distinctActors": 30,
"volumeUSD": 125000
}
}
},
"pnl": {
"total": 250000,
"perChain": {
"base": 150000,
"solana": 100000
}
},
"hasComments": true
}
]
}
Show child attributes
Show child attributes
⌘I