Get token holders

Returns a ranked list of token holders for a specific denomination, ordered by amount.

GET /indexer/richlist/v1/{denom}

Get token holders

cURL

curl --request GET \
  --url https://rollytics-api-evm-1.anvil.asia-southeast.initia.xyz/indexer/richlist/v1/{denom}

200

{
  "holders": [
    {
      "account": "<string>",
      "amount": "<string>"
    }
  ],
  "pagination": {
    "previous_key": "<string>",
    "next_key": "<string>",
    "total": "<string>"
  }
}

Path Parameters

denom · string · required

The token denomination. Use URL encoding for denoms containing / (e.g., l2%2F...).

Query Parameters

pagination.key · string

Cursor key for pagination.

pagination.offset · integer

Number of records to skip.

pagination.limit · integer · default: 100

Maximum number of records to return. Defaults to 100.

pagination.count_total · boolean · default: true

Whether to return the total count. Defaults to true.

pagination.reverse · boolean · default: true

When true, returns results in descending order. Defaults to true.

Response

200 - application/json

Successful response

holders · object[]

Show child attributes

pagination · object

Pagination metadata for list responses.

Show child attributes