---
title: "Get current user leaderboard rank and stats"
method: GET
path: "/v1/leaderboard/users/me/rank"
tags: ["user"]
---

# Get current user leaderboard rank and stats

`GET /v1/leaderboard/users/me/rank`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/leaderboard/users/me/rank`
- Auth: HTTP bearer

## Query parameters

- `network` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper'
- `period` '24h' | '7d' | '30d' | 'all'
- `sortBy` 'profit' | 'volume' | 'avgRoi' | 'avgReturn' | 'sharpe' | 'winRate' | 'holdTime' | 'name' | 'lastActive' | 'rank' | 'elo' | 'wins' | 'losses' | 'copiers'
- `sortDirection` 'asc' | 'desc'

## Response `200`

Successful response

- LeaderboardMeRank
  - `rank` integer, required: Canonical 1-indexed leaderboard standing by profit descending; independent of the requested sort.
  - `total` integer, required: Total number of ranked users.
  - `offset` integer, required: Zero-indexed position under the requested sort; use this value for pagination.
  - `stats` object, required
    - `elo` number, nullable, required
    - `wins` integer, required
    - `losses` integer, required
    - `totalProfitUsd` number, required
    - `roiPercent` number, nullable, required
    - `tradeWinRate` number, nullable, required
    - `volumeUsd` number, required
    - `accountValue` number, nullable, required
    - `avgWinPercent` number, nullable, required
    - `avgHoldTimeHours` number, nullable, required
    - `sharpeRatio` number, nullable, required

## Other responses

- `400`: Invalid input data
- `401`: Authorization not provided
- `403`: Insufficient access
- `404`: Not found
- `500`: Internal server error

## Changes

- **2026-10-25** `8d368659667e`: 7 breaking, 7 info
  - the response property `anyOf[#/components/schemas/LeaderboardMeRank]/stats/accountValue` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/LeaderboardMeRank]/stats/avgHoldTimeHours` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/LeaderboardMeRank]/stats/avgWinPercent` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/LeaderboardMeRank]/stats/elo` became nullable for the status `200`
  - …10 more
- **2026-10-07** `440fd2d98e59`: 4 info
  - added the new enum value `avgReturn` to the `query` request parameter `sortBy`
  - added the new enum value `holdTime` to the `query` request parameter `sortBy`
  - added the new enum value `sharpe` to the `query` request parameter `sortBy`
  - added the new enum value `winRate` to the `query` request parameter `sortBy`
- **2026-08-21** `9651975196e7`: 1 info
  - added the new enum value `copiers` to the `query` request parameter `sortBy`

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/leaderboard/users/me/rank/get.md)

---

[API](https://skmtc.dev/legend/apis/legend-api.md) - [All operations](https://skmtc.dev/legend/apis/legend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/legend/apis/legend-api/revisions/c3e45061cf81?raw)