Skip to main content
GET
/
erc20
/
{tokenAddress}
/
holders
Get a holders summary by token address
curl --request GET \
  --url https://deep-index.moralis.io/api/v2.2/erc20/{tokenAddress}/holders \
  --header 'X-API-Key: <api-key>'
{
  "totalHolders": "99999",
  "holderSupply": {
    "top10": {
      "supply": "10",
      "supplyPercent": "0.10"
    },
    "top25": {
      "supply": "10",
      "supplyPercent": "0.10"
    },
    "top50": {
      "supply": "10",
      "supplyPercent": "0.10"
    },
    "top100": {
      "supply": "10",
      "supplyPercent": "0.10"
    },
    "top250": {
      "supply": "10",
      "supplyPercent": "0.10"
    },
    "top500": {
      "supply": "10",
      "supplyPercent": "0.10"
    }
  },
  "holderChange": {
    "5min": {
      "change": "10",
      "changePercent": "0.10"
    },
    "1h": {
      "change": "10",
      "changePercent": "0.10"
    },
    "6h": {
      "change": "10",
      "changePercent": "0.10"
    },
    "24h": {
      "change": "10",
      "changePercent": "0.10"
    },
    "3d": {
      "change": "10",
      "changePercent": "0.10"
    },
    "7d": {
      "change": "10",
      "changePercent": "0.10"
    },
    "30d": {
      "change": "10",
      "changePercent": "0.10"
    }
  },
  "holdersByAcquisition": {
    "swap": "10",
    "transfer": "10",
    "airdrop": "10"
  },
  "holderDistribution": {
    "whales": "100",
    "sharks": "100",
    "dolphins": "100",
    "fish": "100",
    "octopus": "100",
    "crabs": "100",
    "shrimps": "100"
  }
}
Endpoint cost: CUs. Learn more about compute units.

Authorizations

​
X-API-Key
string
header
default:test
required

Path Parameters

​
tokenAddress
string
required

The token address to get transaction for

Example:

"0x6982508145454ce325ddbe47a25d4ec3d2311933"

Query Parameters

​
chain
enum<string>
default:eth

The chain to query

Available options:
eth,
0x1,
sepolia,
0xaa36a7,
polygon,
0x89,
bsc,
0x38,
bsc testnet,
0x61,
avalanche,
0xa86a,
fantom,
0xfa,
cronos,
0x19,
arbitrum,
0xa4b1,
chiliz,
0x15b38,
chiliz testnet,
0x15b32,
gnosis,
0x64,
gnosis testnet,
0x27d8,
base,
0x2105,
base sepolia,
0x14a34,
optimism,
0xa,
polygon amoy,
0x13882,
linea,
0xe708,
moonbeam,
0x504,
moonriver,
0x505,
moonbase,
0x507,
linea sepolia,
0xe705,
flow,
0x2eb,
flow-testnet,
0x221,
ronin,
0x7e4,
ronin-testnet,
0x7e5,
lisk,
0x46f,
lisk-sepolia,
0x106a,
pulse,
0x171,
sei-testnet,
0x530,
sei,
0x531,
monad,
0x8f
Example:

"eth"

Response

200 - application/json

Returns token holder summary result

​
totalHolders
number
required

The total holders of the token

Example:

"99999"

​
holderSupply
object
required

The holder supply

​
holderChange
object
required

The holder change

​
holdersByAcquisition
object
required

The holder change

​
holderDistribution
object
required

The holder distribution