Get token holders list

Polkadot

https://polkadot.api.subscan.io

POST

/api/scan/token/holders

Retrieve the list of accounts holding a specific token, including native tokens and built-in assets. Supports filtering by balance range and sorting.

Request

Header Params

Body Params application/jsonRequired

Example

{
    "included_zero_balance": true,
    "max_balance": "string",
    "min_balance": "string",
    "order": "desc",
    "order_field": "balance",
    "page": 0,
    "row": 10,
    "token": "string",
    "unique_id": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://polkadot.api.subscan.io/api/scan/token/holders' \
--header 'x-api-key: 4d0c8ba32dde4a06bda83d52af49120f' \
--header 'Content-Type: application/json' \
--data-raw '{
    "included_zero_balance": true,
    "max_balance": "string",
    "min_balance": "string",
    "order": "desc",
    "order_field": "balance",
    "page": 0,
    "row": 10,
    "token": "string",
    "unique_id": "string"
}'

Responses

🟢200OK

application/json

Successfully retrieved token holders list with pagination

Body

Example

Modified at 2025-11-18 09:27:21

Search accounts by identity

Account token list v2