Skip to main content
Loading market data…
GET/api/v1/hyperliquid/leaderboard/{window}Standard tier+ · 300 req/min

Path-param flavour of the leaderboard endpoint.

Identical body shape to `/hyperliquid/leaderboard?window=…` — this variant accepts the window as a path segment so callers can bookmark or nest it behind a CDN rewrite.

Path parameters

Segments of the URL path, validated server-side.

NameTypeRequiredDefaultDescription
windowenumrequired
Leaderboard window.
1d7d30dytdall

Query parameters

All query parameters are optional unless marked required.

NameTypeRequiredDefaultDescription
limitnumberoptional50
How many traders to return. Max 200.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

data payloadtypescript
// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{ window; ts; traders }

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

Requestbash
curl -sS "http://localhost:3000/api/v1/hyperliquid/leaderboard/7d?limit=10"
Responsejson
{ "data": { "window": "7d", "ts": 1744834800000, "traders": [] }, "meta": { "total": 0, "window": "7d", "limit": 10 } }

Next

Check the error code reference, or get an API key to try the request against your own account.