Skip to main content
GET
/
v1
/
leaderboard
Get trader leaderboard
curl --request GET \
  --url https://data-api.kuest.com/v1/leaderboard
[
  {
    "rank": "1",
    "proxyWallet": "0x1234567890abcdef1234567890abcdef12345678",
    "userName": "Theo4",
    "vol": 22862194,
    "pnl": 8499002,
    "profileImage": "https://cdn.kuest.com/profiles/theo4.png",
    "xUsername": null,
    "verifiedBadge": null
  },
  {
    "rank": "2",
    "proxyWallet": "0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
    "userName": "SecondPlace",
    "vol": 129473073,
    "pnl": 18025142,
    "profileImage": null,
    "xUsername": null,
    "verifiedBadge": null
  }
]
https://data-api.kuest.com/v1/leaderboard ranks traders by volume or PnL, with filters for category, time period, and user.

​
Query parameters

  • category: Category filter (OVERALL, POLITICS, SPORTS, CRYPTO, FINANCE, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH).
  • timePeriod: Time window (DAY, WEEK, MONTH, ALL).
  • orderBy: Ordering (PNL or VOL).
  • limit: Max rows (1-50, default 25).
  • offset: Pagination (0-1000).
  • user: Filter by wallet address.
  • userName: Filter by username.

​
Notes

  • DAY/WEEK/MONTH: PnL is approximate for the selected window.
  • ALL: PnL uses realized totals from closed positions.

Query Parameters

​
category
enum<string>
default:OVERALL

Category filter.

Available options:
OVERALL,
POLITICS,
SPORTS,
CRYPTO,
FINANCE,
CULTURE,
MENTIONS,
WEATHER,
ECONOMICS,
TECH
​
timePeriod
enum<string>
default:DAY

Time window for aggregation.

Available options:
DAY,
WEEK,
MONTH,
ALL
​
orderBy
enum<string>
default:PNL

Ordering criteria.

Available options:
PNL,
VOL
​
limit
integer
default:25

Maximum number of traders to return.

Required range: 1 <= x <= 50
​
offset
integer
default:0

Starting index for pagination.

Required range: 0 <= x <= 1000
​
user
string

Filter to a single wallet address.

Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
userName
string

Filter to a single username.

Response

Leaderboard returned.

​
rank
string
​
proxyWallet
string

0x-prefixed EVM address (40 hex chars).

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0x56687bf447db6ffa42ffe2204a05edaa20f55839"

​
userName
string | null
​
vol
number
​
pnl
number
​
profileImage
string | null
​
xUsername
string | null
​
verifiedBadge
boolean | null