---
title: "List top holders for multiple assets"
method: POST
path: "/v1/users/holders/batch"
tags: ["user"]
---

# List top holders for multiple assets

`POST /v1/users/holders/batch`

## Request body

- object
  - `symbols` string[], required
  - `limit` number
  - `filter` 'all' | 'friends' | 'clan'
  - `network` 'hyperliquid_testnet' | 'hyperliquid_mainnet' | 'hyperliquid_paper'
  - `marketType` 'perps' | 'spot'

## Response `200`

Successful response

- object

## Other responses

- `404` — Resource not found

## Changes

- **2026-08-25** `f91fbc22fde3` — 2 info
  - added the required property `additionalProperties/holders/items/user/clan_fee_rebate_rate` to the response with the `200` status
  - added the required property `additionalProperties/holders/items/user/fee_rebate_override_rate` to the response with the `200` status

[Change history](https://skmtc.dev/legend/apis/legend-api/changes/v1/users/holders/batch/post.md)

---

[API](https://skmtc.dev/legend/apis/legend-api.md) · [All operations](https://skmtc.dev/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/legend/legend-api/revisions/dbe693d00cb3/schema)