---
title: "Get user volume leaderboard"
method: GET
path: "/v1/stats/user-volume/leaderboard"
tags: ["Stats"]
---

# Get user volume leaderboard

`GET /v1/stats/user-volume/leaderboard`

Get top users ranked by volume category within a time range

## Query parameters

- `category` 'USER_VOLUME_CATEGORY_TRADED' | 'USER_VOLUME_CATEGORY_LIQUIDATION' | 'USER_VOLUME_CATEGORY_TOTAL_FEE'
- `window` string
- `limit` integer

## Response `200`

A successful response.

- ApiGetUserVolumeLeaderboardResponse
  - `entries` ApiUserVolumeEntry[]
    - `rank` integer
    - `address` string
    - `traded_volume` string
    - `liquidation_volume` string
    - `total_volume` string
    - `total_fee` string
    - `trade_count` integer
  - `category` 'USER_VOLUME_CATEGORY_TRADED' | 'USER_VOLUME_CATEGORY_LIQUIDATION' | 'USER_VOLUME_CATEGORY_TOTAL_FEE' — - USER_VOLUME_CATEGORY_TRADED: Rank by regular trading volume (default; includes TPSL fills, excludes liquidations) - USER_VOLUME_CATEGORY_LIQUIDATION: Rank by liquidation volume - USER_VOLUME_CATEGORY_TOTAL_FEE: Rank by total fees paid (maker + taker + liquidation fees)
  - `window` string
  - `start_time` string, int64
  - `end_time` string, int64

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/revisions/194af8339c0d/schema)