Leaderboard

GET /api/stats/leaderboard_base Description: Returns the current global leaderboard of wallets ranked by total trading volume (buy + sell) within a selected time period. Includes PnL, ROI %, winrate, buy/sell counts etc.Query Parameters

Parameter	Type	Required	Description
api_key	String	Yes	API key for authentication
period	String	No	Time period: 6h, 1d, 7d, 30d (default: 1d)

Response Status Code: 200 OK Content-Type: application/jsonjson

[
  {
    "wallet_address": "5x...abc",
    "name": "TraderXYZ",
    "image_url": "https://...png",
    "twitter": "https://twitter.com/TraderXYZ",
    "telegram": "",
    "total_volume": 1247.89,
    "pnl_base": 348.12,
    "pnl_percent": 38.74,
    "buy_count": 42,
    "sell_count": 19,
    "winrate": 68.42,
    "rank": 1
  },
  ...
]

Error Responses

Status	Body example
400	{"error": "Period must be one of: 6h, 1d, 7d, 30d"}
403	{"error": "Invalid or exhausted API key"}

Example Requestbash

curl "http://82.29.177.109:8080/api/stats/leaderboard_base?period=7d&api_key=YOUR_API_KEY"

Notes

• Sorted by total_volume descending

• Cached indefinitely (updated via background cleanup task + real-time WebSocket)

• pnl_base = realized profit/loss in ETH

• pnl_percent = ROI in % (can be negative)

• winrate = % of sells with profit per token (only counts tokens with at least one sell)

• Empty twitter/telegram/image_url fields are returned as empty strings