user

List top holders for multiple assets

Changed on Oct 25, 2026

post/v1/users/holders/batch

Request

Base URL
https://app.legend.trade/api/rest
URL
https://app.legend.trade/api/rest/v1/users/holders/batch
Auth
none declared

Request body

symbolsstring[] required

limitnumber

filter'all' | 'friends' | 'clan'

network'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper'

marketType'perps' | 'spot'

Response

Successful response

object required

Changes

Oct 25, 20268d368659667e Revision changes
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property //// became nullable for the status
- breaking
  the response property ////// became nullable for the status
- breaking
  the response property //// became nullable for the status
- info
  response property additionalProperties/holders/items/user/bio list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/callerCopyProfileId list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan/anyOf[subschema #1]/banner_url list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan/anyOf[subschema #1]/chat_room_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan/anyOf[subschema #1]/description list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan/anyOf[subschema #1]/image_url list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan_fee_rebate_rate list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/clan_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/deleted_at list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/fee_rebate_override_rate list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/fee_rebate_rate list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/invite_code_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/last_online list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/last_online_mobile list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/last_reset_at list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/main_signer_quorum_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/max_market_order_slippage list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/referral_code list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/referral_code_alt list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/referred_by_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/telegram_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/wallet_address list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/wallets/items/signer_quorum_id list-of-types was narrowed by removing types null from media type application/json of response 200
- info
  response property additionalProperties/holders/items/user/x_username list-of-types was narrowed by removing types null from media type application/json of response 200
Oct 7, 2026440fd2d98e59 Revision changes
- info
  added the optional property //// to the response with the status

Operation history (4 revisions)

List top holders for multiple assets

Request

Request body

Response 200OK

Changes

Response