---
title: "Top traders by PnL, ROI, volume or account value across time windows, each row with mechanical activity labels."
method: GET
path: "/api/leaderboard"
---

# Top traders by PnL, ROI, volume or account value across time windows, each row with mechanical activity labels.

`GET /api/leaderboard`

## Request

- Base URL: `https://tapeperp.com`
- URL: `https://tapeperp.com/api/leaderboard`
- Auth: none declared

## Query parameters

- `window` 'day' | 'week' | 'month' | 'allTime'
- `metric` 'pnl' | 'roi' | 'vlm' | 'accountValue'
- `limit` integer
- `format` 'full' | 'concise'
- `fields` string

## Response `200`

Leaderboard with provenance

## Other responses

- `400`: Invalid query parameter

---

[API](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api.md) · [All operations](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tapeperp/apis/tape-hyperliquid-analytics-api/revisions/5f86c44f9a91?raw)