---
title: "Returns users leaderboard (at the top of the board are users, that have generated the most fees)"
method: POST
path: "/api/Users/usersLeaderboard"
tags: ["Users"]
---

# Returns users leaderboard (at the top of the board are users, that have generated the most fees)

`POST /api/Users/usersLeaderboard`

## Request body

- UserLeaderboardRequestDTO
  - `walletAddress` string, nullable — Address of a wallet to search for [hex of base58, optional]
  - `skip` integer, required — items to skip (pagination)
  - `take` integer, required — Number of items to return (pagination) max page size is 100

## Response `200`

OK

- UserLeaderboardResponseDTO — Users leaderboard page info
  - `users` UserLeaderboardItemDTO[], nullable — Leaderboard items from requested page
    - `walletAddress` AddressPropertyDTO
      - `Base64Value` string, byte, nullable — Binary representation of the property value
      - `bytesArrayValue` string, nullable — Bytes array representation of the value
      - `stringValue` string, nullable — String representation of the property value
    - `userRank` integer — Rank of the user in the leaderboard Users are ranked by TotalFeesGeneratedUsd descending
    - `totalVolumeUSD` number, double — Total give amount's USD equivalent of all user's orders that used the referral code
    - `totalFeesUSD` number, double — Total fees' USD equivalent of all user's orders that used the referral code
    - `totalExecutedOrders` integer — Total number of user's orders that used the referral code
  - `totalCount` integer — Total number of leaderboard items
  - `searchResult` UserLeaderboardItemDTO
    - `walletAddress` AddressPropertyDTO
      - `Base64Value` string, byte, nullable — Binary representation of the property value
      - `bytesArrayValue` string, nullable — Bytes array representation of the value
      - `stringValue` string, nullable — String representation of the property value
    - `userRank` integer — Rank of the user in the leaderboard Users are ranked by TotalFeesGeneratedUsd descending
    - `totalVolumeUSD` number, double — Total give amount's USD equivalent of all user's orders that used the referral code
    - `totalFeesUSD` number, double — Total fees' USD equivalent of all user's orders that used the referral code
    - `totalExecutedOrders` integer — Total number of user's orders that used the referral code

---

[API](https://skmtc.net/debridge/apis/debridge-liquidity-network-dln-api.md) · [All operations](https://skmtc.net/debridge/apis/debridge-liquidity-network-dln-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debridge/debridge-liquidity-network-dln-api/revisions/ec461847e46f/schema)