---
title: "Get the ticker leaderboard for a selected period"
method: GET
path: "/v1/leaderboard/users/ticker"
tags: ["user"]
---

# Get the ticker leaderboard for a selected period

`GET /v1/leaderboard/users/ticker`

## Request

- Base URL: `https://app.legend.trade/api/rest`
- URL: `https://app.legend.trade/api/rest/v1/leaderboard/users/ticker`
- Auth: none declared
- TypeScript: <https://skmtc.dev/legend/apis/legend-api/docs/v1/leaderboard/users/ticker/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `network` 'hyperliquid_mainnet' | 'hyperliquid_testnet'
- `period` '24h' | '7d' | '30d' | 'all'

## Response `200`

Successful response

- LeaderboardTickerOutput
  - `users` object[], required
    - `user` object, required
      - `id` string, required
      - `username` string, required
      - `display_name` string, required
      - `avatar_url` string, required
    - `rank` integer, required
    - `totalProfitUsd` number, required

## Other responses

- `400`: Invalid input data
- `404`: Not found
- `500`: Internal server error

## Changes

> 112 revisions in range; 1 not diffed.

- **2026-09-10** `4201e72dc54f`: 1 info
  - added the new optional `query` request parameter `period`
- **2026-09-08** `fae004332dd6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/legend/apis/legend-api/changes/v1/leaderboard/users/ticker/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/4d28493a550f?raw)