---
title: "Get top holders for a token"
method: GET
path: "/v2/tokens/top-holders"
tags: ["Token Information"]
---

# Get top holders for a token

`GET /v2/tokens/top-holders`

Returns top holders ordered by balance from the token-holders index. Only considers the latest snapshot (nonce=1).

## Query parameters

- `token` string, required
- `network` string, required
- `size` number
- `cursor` string

## Response `200`

- TokenTopHoldersResponse
  - `token` string, required
  - `network` string, required
  - `items` TokenHolder[], required
    - `rank` number, required
    - `address` string, required
    - `balance` number, required
    - `pct_of_supply` number, required
    - `name_tag` string, nullable
    - `category` string, nullable
    - `entity` string, nullable
    - `is_contract` boolean, required
    - `is_multisig` boolean, required
    - `num_sends` number
    - `num_receives` number
    - `unique_senders` number
    - `unique_receivers` number
    - `address_role` string, nullable
    - `malicious` boolean, nullable
  - `meta` CursorMetaDto, required
    - `next_cursor` string, nullable — Opaque string cursor pointing to the next page of results. null if there is no next page.
    - `previous_cursor` string, nullable — Opaque string cursor pointing to the previous page of results. null if there is no previous page.
    - `first_page_cursor` string — Opaque string cursor pointing to the very first page in the entire dataset with respect to the current filter.
    - `last_page_cursor` string, nullable — Opaque string cursor pointing to the very last page in the entire dataset with respect to the current filter.
    - `total_count` number, nullable — Total number of results.
    - `page_number` number — Current page number.

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/revisions/9926df2e476d/schema)