> ## Documentation Index
> Fetch the complete documentation index at: https://docs.etherscan.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Token Holder List by Contract Address

> Retrieves the current list of ERC-20 token holders and their token balances.

export const chain = '1';

<Warning>
  **Effective July 1, 2026**, the maximum records returned per request will be reduced from 10,000 to 1,000 for Free tier API users. See the full list of [affected endpoints](https://docs.etherscan.io/changelog#upcoming-change-reduced-maximum-records-per-request-on-the-free-api-tier).
</Warning>

<Note>
  This is a PRO endpoint, available to the [Standard Plan](/resources/rate-limits) and above
</Note>

### Query Parameters

<ParamField query="apikey" default="YourApiKeyToken" type="string">
  Your Etherscan API key.
</ParamField>

<ParamField query="chainid" default="1" type="string">
  Chain ID to query, eg `1` for Ethereum, `8453` for Base from our [supported chains](/supported-chains).
</ParamField>

<ParamField query="module" default="token" type="string">
  Set to `token` for this endpoint.
</ParamField>

<ParamField query="action" default="tokenholderlist" type="string">
  Set to `tokenholderlist` for this endpoint.
</ParamField>

<ParamField query="contractaddress" default="0xaaaebe6fe48e54f431b0c390cfaf0b017d09d42d" type="string">
  Contract address of the ERC-20 token.
</ParamField>

<ParamField query="page" default="1" type="integer">
  Page number for pagination.
</ParamField>

<ParamField query="offset" default="100" type="integer">
  Number of records per page. Use the `page` parameter for subsequent records.
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "status": "1",
    "message": "OK",
    "result": [
      {
        "TokenHolderAddress": "0xa5b7d615c99f011a22f16f5809890ca6900200a3",
        "TokenHolderQuantity": "2"
      },
      {
        "TokenHolderAddress": "0x0412a1d25fbdcabc536603198330021ccb13240b",
        "TokenHolderQuantity": "3385700"
      }
    ]
  }
  ```
</ResponseExample>