---
title: "Returns the list of holders of an EVM (ERC-20, ...) token.
This endpoint does not verify that `address` is actually an EVM token; if it is not, it will simply return an empty list."
method: GET
path: "/{runtime}/evm_tokens/{address}/holders"
---

# Returns the list of holders of an EVM (ERC-20, ...) token.
This endpoint does not verify that `address` is actually an EVM token; if it is not, it will simply return an empty list.

`GET /{runtime}/evm_tokens/{address}/holders`

## Path parameters

- `runtime` 'emerald' | 'sapphire' | 'pontusxtest' | 'pontusxdev' | 'cipher', required
- `address` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

The requested holders.

- TokenHolderList — A list of token holders for a specific (implied) runtime and token.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `holders` BareTokenHolder[], required
    - `holder_address` string, required — The Oasis address of the account holder.
    - `eth_holder_address` string — The Ethereum address of the same account holder, if meaningfully defined.
    - `balance` string, bigint, required

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)