Get balances of all holders of a specific ERC-20 token contract

Authorization required to use this endpoint

To get your API key, follow the instruction here.

The Get Balances by Contract endpoint provides data on your token holders and the amount they hold. You must specify the contract address to search by.

A successful request to the endpoint will return a JSON response with the balance data, marked as items, for a particular contract address. The items will contain the fields with their id, EOA address, value_raw, value_calculated, seen_at_block_number. The token data will be shown at the top of the response.


Please note that the current calculation of the total supply is based on transfers to and from the zero address. This method may not work accurately for tokens that have different minting mechanics, such as USDT and BNB.

The cURL request demonstrated below can give you the gist of how the endpoint operates. Be sure to replace YOUR_API_KEY with your actual API key.

curl --location '' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY'
Click Try It! to start a request and see the response here!