---
title: "Get PnL leaderboard"
method: GET
path: "/v1/leaderboard/pnl"
tags: ["Leaderboard"]
---

# Get PnL leaderboard

`GET /v1/leaderboard/pnl`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/v1/leaderboard/pnl`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/leaderboard/pnl/get.ts> (a function with typed inputs; its response is checked against the schema)

Get leaderboard ranked by notional PnL for the given timeframe (1D/7D/30D/All)

## Query parameters

- `timeframe` 'LEADERBOARD_TIME_FRAME_UNSPECIFIED' | 'LEADERBOARD_TIME_FRAME_24H' | 'LEADERBOARD_TIME_FRAME_7D' | 'LEADERBOARD_TIME_FRAME_ALL' | 'LEADERBOARD_TIME_FRAME_30D'
- `limit` integer
- `page` integer

## Response `200`

A successful response.

- ApiGetPnlLeaderboardResponse
  - `entries` ApiPnlLeaderboardEntry[]
    - `rank` string, int64
    - `address` string
    - `account_value` string
    - `notional_pnl` string
    - `roi_percent` string
    - `win_rate` string
    - `trades` string, int64
    - `profile_image_url` string
    - `notional_volume` string
  - `total` integer

## Other responses

- `default`: An unexpected error response.

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)