PearPear

Get the PEAR Protocol trader leaderboard

Ranks trade accounts by net PnL, volume, trade count or average position ROI. Returns at most 200 rows. Unrealized PnL is included whenever the window still contains now — an absent endDate, or one that has not yet arrived; only a window that has already closed returns settled realized PnL alone. ROI is the plain average of the account per-position returns, each measured against the size that position opened with, and is omitted for an account whose positions could none of them be measured. Accounts whose owner linked no X account are left off the board; pass includeUnlinkedX=true to rank them too. A trader who linked X and then withheld the handle keeps their row, unnamed. Open to everyone, and the same board for everyone: the linked X handle, name, avatar and user id are returned to any caller, unless their owner has hidden them.

GET
/statistics/leaderboard

Query Parameters

clientId?string
connector?array<>
asset?array<>
sortBy?string
Default"totalNetPnl"
startDate?integer
Range0 <= value <= 9007199254740991
endDate?integer
Range0 <= value <= 9007199254740991
includeUnlinkedX?|
Defaultfalse
limit?integer
Range0 < value <= 200
Default200

Response Body

application/json

curl -X GET "https://example.com/statistics/leaderboard"
{  "data": [    {      "tradeAccountId": "string",      "userId": "string",      "connector": "hyperliquid",      "volume": "string",      "grossRealizedPnl": "string",      "grossUpnl": "string",      "fundingPayment": "string",      "totalNetPnl": "string",      "pearFee": "string",      "tradeFee": "string",      "totalTrades": 0,      "roi": "string",      "xHandle": "string",      "xName": "string",      "xAvatarUrl": "string",      "xUserId": "string"    }  ]}