Builder Leaderboard

Endpoint

GET /v1/builders/leaderboard

Server: https://data.openfish.fun

Authentication: None required

---

Query Parameters

Parameter	Type	Default	Constraints	Description
timePeriod	string (enum)	DAY	DAY, WEEK, MONTH, ALL	Time window over which volume is aggregated
limit	integer	25	0-50	Maximum number of builders in the response
offset	integer	0	0-1000	Pagination offset

---

Responses

200 — Leaderboard retrieved

The body is an array of LeaderboardEntry objects.

Field	Type	Description
rank	string	Rank position
builder	string	Builder name or identifier
volume	number	Total attributed trading volume
activeUsers	integer	Number of active users
verified	boolean	Whether the builder is verified
builderLogo	string	URL to builder logo

Sample Response:

[
  {
    "rank": "1",
    "builder": "my-trading-bot",
    "volume": 1250000.50,
    "activeUsers": 342,
    "verified": true,
    "builderLogo": "https://example.com/logo.png"
  }
]

400 — Bad Request

{ "error": "invalid timePeriod" }

500 — Server Error

{ "error": "Internal server error" }