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

# Get combined leaderboard

`GET /v1/leaderboard/combined`

## Request

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

Get leaderboard with merged PnL and volume stats for the given timeframe. Supports sorting by any field.

## Query parameters

- `timeframe` 'LEADERBOARD_TIME_FRAME_UNSPECIFIED' | 'LEADERBOARD_TIME_FRAME_24H' | 'LEADERBOARD_TIME_FRAME_7D' | 'LEADERBOARD_TIME_FRAME_ALL' | 'LEADERBOARD_TIME_FRAME_30D'
- `sort_by` 'COMBINED_LEADERBOARD_SORT_BY_PNL' | 'COMBINED_LEADERBOARD_SORT_BY_ROI' | 'COMBINED_LEADERBOARD_SORT_BY_WIN_RATE' | 'COMBINED_LEADERBOARD_SORT_BY_TRADES' | 'COMBINED_LEADERBOARD_SORT_BY_VOLUME' | 'COMBINED_LEADERBOARD_SORT_BY_REFERRAL_VOLUME' | 'COMBINED_LEADERBOARD_SORT_BY_COMBINED_VOLUME'
- `asc` boolean
- `limit` integer
- `page` integer
- `insilico_only` boolean

## Response `200`

A successful response.

- ApiGetCombinedLeaderboardResponse
  - `entries` ApiCombinedLeaderboardEntry[]
    - `rank` string, int64
    - `address` string
    - `account_value` string
    - `notional_pnl` string
    - `roi_percent` string
    - `win_rate` string
    - `trades` string, int64
    - `notional_volume` string
    - `referral_volume` string
    - `combined_volume` string
    - `profile_image_url` string
    - `display_name` 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)