Skip to main content

Don't have an API key yet?

Sign-up to Moralis to get your free API key and start building today.

Get Your Free API Key
Version: 2.2

Get ERC20 token owners

GEThttps://deep-index.moralis.io/api/v2.2/erc20/:token_address/owners

Identify the major holders of an ERC20 token and understand their ownership percentages

Known Issue

We are aware of an ordering issue impacting all chains other than Ethereum Mainnet. We are working on a fix for these chains which will be launched in the coming weeks.

PATH PARAMS
token_addressstringrequired
The address of the token contract
QUERY PARAMS
chainstring
The chain to query
limitnumber
The desired page size of the result.
cursorstring
The cursor returned in the previous response (used for getting the next page).
orderstring
The order of the result, in ascending (ASC) or descending (DESC)
Responses
API KEY
import Moralis from 'moralis';

try {
await Moralis.start({
apiKey: "YOUR_API_KEY"
});

const response = await Moralis.EvmApi.token.getTokenOwners({
"chain": "0x1",
"order": "DESC",
"tokenAddress": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0"
});

console.log(response.raw);
} catch (e) {
console.error(e);
}
Response Example
{
"page": "2",
"page_size": "100",
"cursor": "",
"result": {
"owner_address": "0x244...",
"owner_address_label": "Coinbase 1",
"balance": "57888888888888888888880",
"balance_formatted": "5.78",
"usd_value": "57888888888888888888880",
"is_contract": "",
"percentage_relative_to_total_supply": ""
}
}