---
title: "Get competition leaderboard"
method: GET
path: "/v1/competition/leaderboard"
tags: ["Competition"]
---

# Get competition leaderboard

`GET /v1/competition/leaderboard`

## Request

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

Get competition leaderboard ranked by equity (ROI)

## Query parameters

- `limit` integer
- `type` 'COMPETITION_LEADERBOARD_TYPE_ACTIVE' | 'COMPETITION_LEADERBOARD_TYPE_ALL_TIME'
- `page` integer

## Response `200`

A successful response.

- ApiGetCompetitionLeaderboardResponse
  - `entries` ApiCompetitionLeaderboardEntry[]
    - `rank` string, int64
    - `address` string
    - `username` string
    - `equity` string
    - `roi_percent` string
    - `trades_executed` string, int64
    - `account_equity` string
    - `total_volume` string
    - `unrealized_pnl` string
    - `reward_wallet` string
    - `profile_image_url` string
    - `x_profile` object
  - `total` integer
  - `start_time` string, int64
  - `end_time` string, int64
  - `round_number` integer

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/v1/competition/leaderboard/get.md)

---

[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)