Get leaderboard

Endpoint

GET /v1/leaderboard

Server: https://data.openfish.fun (port 3003)

Tags: Core

Produces a ranked list of traders ordered by trading volume or profit-and-loss over a configurable time window.

---

Parameters

Name	In	Type	Default	Description
category	query	string		Category filter (reserved)
timePeriod	query	string	ALL	Time period. One of: ALL, 1D, 7D, 30D, 90D, 365D
orderBy	query	string	vol	Order field. One of: vol, pnl
limit	query	integer	25	Max results (max 50)
offset	query	integer	0	Pagination offset
user	query	string		Narrow to a single user address
userName	query	string		Search by user name or pseudonym (ILIKE)

---

Response

200 — A JSON array of TraderLeaderboardEntry objects.

[
  {
    "rank": 1,
    "proxyWallet": "0xabc...",
    "vol": "250000.00",
    "pnl": "12500.50",
    "name": "Alice",
    "profileImage": "https://...",
    "userName": "alice_trades",
    "xUsername": "alice_x",
    "verifiedBadge": true
  }
]

---

Example

curl "https://data.openfish.fun/v1/leaderboard?timePeriod=7D&orderBy=pnl&limit=10"