---
title: "Changes to Get Leaderboard"
method: GET
path: "/api/v1/user/leaderboard"
---

# Changes to Get Leaderboard

`GET /api/v1/user/leaderboard`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 23 revisions.

- **2026-09-10** `fad9eecaba2e`: 1 info
- **2026-05-28** `75ffe546b73a`: 2 breaking, 16 info
- **2026-01-29** `16fe50636aa5`: 1 info

## Changes

- **2026-09-10** `fad9eecaba2e`: 1 info
  - added the required property `data/items/other_xp` to the response with the `200` status
- **2026-05-28** `75ffe546b73a`: 2 breaking, 16 info
  - the `query` request parameter `timeframe` was restricted to a list of enum values
  - removed the required property `data/items/wallet` from the response with the `200` status
  - api tag `Leaderboard` added
  - api tag `User` removed
  - added the new optional `query` request parameter `limit`
  - added the new optional `query` request parameter `offset`
  - added the new enum value `30d` to the `query` request parameter `timeframe`
  - added the new enum value `7d` to the `query` request parameter `timeframe`
  - added the new enum value `all` to the `query` request parameter `timeframe`
  - added the new enum value `today` to the `query` request parameter `timeframe`
  - for the `query` request parameter `timeframe`, the type was generalized from no type to `string`
  - added the required property `data/items/ranked` to the response with the `200` status
  - added the required property `data/items/referral_xp` to the response with the `200` status
  - added the required property `data/items/sub_account_address` to the response with the `200` status
  - added the required property `data/items/total_xp` to the response with the `200` status
  - added the required property `data/items/trading_xp` to the response with the `200` status
  - added the required property `meta/limit` to the response with the `200` status
  - added the required property `meta/offset` to the response with the `200` status
- **2026-01-29** `16fe50636aa5`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/docs/api/v1/user/leaderboard/get.md) - [API](https://skmtc.dev/ekidenfi/apis/ekiden-gateway.md) - [Page](https://skmtc.dev/ekidenfi/apis/ekiden-gateway/changes/api/v1/user/leaderboard/get)
