Get ERC20 Token Holder Stats

GEThttps://deep-index.moralis.io/api/v2.2/erc20/:address/holders

Get token holder summary

PATH PARAMS

addressstringrequired

The token contract address

QUERY PARAMS

chainstring

The chain to query

eth0x1sepolia0xaa36a7holesky0x4268polygon0x89polygon amoy0x13882bsc0x38bsc testnet0x61avalanche0xa86afantom0xfapalm0x2a15c308dcronos0x19arbitrum0xa4b1

Responses

API KEY

Node.js

// Dependencies to install:
// $ npm install node-fetch --save
// add "type": "module" to package.json

import fetch from 'node-fetch';

const options = {
  method: 'GET',
  headers: {
    accept: 'application/json',
    'X-API-Key': 'YOUR_API_KEY'
  },
};

fetch('https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders?chain=eth', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Python

# Dependencies to install:

# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders?chain=eth"

headers = {
  "Accept": "application/json",
  "X-API-Key": "YOUR_API_KEY"
}

response = requests.request("GET", url, headers=headers)

print(response.text)

cURL

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders?chain=eth' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders?chain=eth"

  req, _ := http.NewRequest("GET", url, payload)

  req.Header.Add("Accept", "application/json")
  req.Header.Add("X-API-Key", "YOUR_API_KEY")

  res, _ := http.DefaultClient.Do(req)

  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))

}

PHP

<?php
// Dependencies to install:
// $ composer require guzzlehttp/guzzle

require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders?chain=eth', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

200 Returns token holder summary

{
  "totalHolders": 107777,
  "holdersByAcquisition": {
    "swap": 378279,
    "transfer": 816041,
    "airdrop": 12899
  },
  "holderChange": {
    "5min": {
      "change": 1,
      "changePercent": 5
    },
    "1h": {
      "change": 9,
      "changePercent": 0.0084
    },
    "6h": {
      "change": 71,
      "changePercent": 0.066
    },
    "24h": {
      "change": 291,
      "changePercent": 0.27
    },
    "3d": {
      "change": 503,
      "changePercent": 0.47
    },
    "7d": {
      "change": 981,
      "changePercent": 0.91
    },
    "30d": {
      "change": 3630,
      "changePercent": 3.4
    }
  },
  "holderSupply": {
    "top10": {
      "supply": 67058.61,
      "supplyPercent": 52
    },
    "top25": {
      "supply": 81873.72,
      "supplyPercent": 63
    },
    "top50": {
      "supply": 90468.6,
      "supplyPercent": 70
    },
    "top100": {
      "supply": 97659.36,
      "supplyPercent": 76
    },
    "top250": {
      "supply": 106577.03,
      "supplyPercent": 83
    },
    "top500": {
      "supply": 112637.5,
      "supplyPercent": 87
    }
  }
}