---
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`

## 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` — Resource not found
- `500` — Internal server error

---

[API](https://skmtc.net/legend/apis/legend-api.md) · [All operations](https://skmtc.net/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/legend/legend-api/revisions/1edcd08d9f89/schema)