/
LE
legend
/
Legend API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 11h ago · Updated 11h ago
View markdown
legend
Legend API
post
List top holders for multiple assets
OpenAPI 3.1.0
2026-08-12
245
240
1.0 MB
427ccfd67e8d
app
1
arena
36
attachments
6
bug-reports
1
capital
1
chase-orders
3
chat
38
clans
29
copy-trading
14
deposits
1
favorites
3
fills
1
following
13
friends
1
notifications
2
paper
1
portfolio
9
positions
8
posts
14
price-alerts
3
pusher
2
reports
1
search
4
season
2
telegram-account
2
tokens
3
trade-protection
2
trading
2
trailing-stops
4
transfers
1
user
31
get
Get current authenticated user
delete
Permanently delete current user account
patch
Update current user
get
Get user leaderboard
get
Get current user leaderboard rank and stats
get
List users
get
Get online users
post
Reset all user stats and history (fresh start)
post
Get presigned URL for profile picture upload
post
Get presigned URL for banner picture upload
post
Set custom referral code (one-time only)
post
Apply a referral code for an existing user (one-time only)
post
Called when user starts the onboarding flow
post
Refresh wallet performance metrics for the current user
get
Get users referred by a specific user
get
Get the count of users referred by the current user
get
Get referral rewards for the current user
get
Get the claimable reward balance (referral + clan leader) for the current user
get
Get the current user’s referral earn rate and 30-day volume tier progress
post
Claim the full claimable reward balance (referral + clan leader)
get
List referral reward payouts for the current user
get
List users currently holding an asset
post
List top holders for multiple assets
get
Get current user preferences
patch
Update current user preferences
post
Get users by IDs (batch)
post
Get trading stats for users
post
Get users by usernames (batch)
get
Get user by ID
get
Get user by username
get
Get users referred by a specific user
users
1
withdrawals
1
x-account
4
user
List top holders for multiple assets
post
/v1/users/holders/batch
Request body
object
required
symbols
string[]
required
limit
number
filter
'all'
|
'friends'
|
'clan'
network
'hyperliquid_testnet'
|
'hyperliquid_mainnet'
|
'hyperliquid_paper'
marketType
'perps'
|
'spot'
Response
Successful response
object
required