---
title: "Get the current user's clan rank on the clan leaderboard"
method: GET
path: "/v1/leaderboard/clans/me/rank"
tags: ["clans"]
---

# Get the current user's clan rank on the clan leaderboard

`GET /v1/leaderboard/clans/me/rank`

## Request

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

## Query parameters

- `network` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper'
- `period` '24h' | '7d' | '30d' | 'all'
- `sortBy` 'totalPnl' | 'totalValue' | 'memberCount' | 'name'
- `sortDirection` 'asc' | 'desc'

## Response `200`

Successful response

- ClanLeaderboardMeRank
  - `rank` integer, required: Canonical 1-indexed clan standing by total PnL descending; independent of the requested sort.
  - `total` integer, required: Total number of ranked clans.
  - `offset` integer, required: Zero-indexed clan position under the requested sort; use this value for pagination.
  - `clan` object, required
    - `id` string, required
    - `name` string, required
    - `imageUrl` string, nullable, required
  - `stats` object, required
    - `totalPnl` number, required
    - `totalValue` number, required
    - `avgRoi` number, nullable, required
    - `memberCount` integer, 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`: 2 breaking, 2 info
  - the response property `anyOf[#/components/schemas/ClanLeaderboardMeRank]/clan/imageUrl` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/ClanLeaderboardMeRank]/stats/avgRoi` became nullable for the status `200`
  - response property `anyOf[#/components/schemas/ClanLeaderboardMeRank]/clan/imageUrl` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
  - response property `anyOf[#/components/schemas/ClanLeaderboardMeRank]/stats/avgRoi` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2026-08-20** `dabff888da35`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/leaderboard/clans/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)