Get ERC20 Token Holders Timeseries

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

Get historical holder statistics for a specific ERC20 token address over a date range

PATH PARAMS

addressstringrequired

The token contract address

QUERY PARAMS

chainstring

The chain to query

fromDatestringrequired

The starting date (format in seconds or datestring accepted by momentjs)

toDatestringrequired

The ending date (format in seconds or datestring accepted by momentjs)

timeFramestringrequired

The timeframe

Responses

200Returns historical token holder statistics

400Bad Request

404Not Found

429Too Many Requests

500Internal Server Error

API KEY

cURL
Node.js
Python
Go
PHP

curl --request GET \
     --url 'https://deep-index.moralis.io/api/v2.2/erc20/0xdac17f958d2ee523a2206206994597c13d831ec7/holders/historical?chain=eth&fromDate=2025-09-20T01%3A00%3A00Z&toDate=2025-09-20T02%3A00%3A00Z&timeFrame=10min' \
     --header 'accept: application/json' \
     --header 'X-API-Key: YOUR_API_KEY' 

// Node.js v18+ has native fetch support
// No additional dependencies required

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

fetch('https://deep-index.moralis.io/api/v2.2/erc20/0xdac17f958d2ee523a2206206994597c13d831ec7/holders/historical?chain=eth&fromDate=2025-09-20T01%3A00%3A00Z&toDate=2025-09-20T02%3A00%3A00Z&timeFrame=10min', options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

# Dependencies to install:
# $ python -m pip install requests

import requests

url = "https://deep-index.moralis.io/api/v2.2/erc20/0xdac17f958d2ee523a2206206994597c13d831ec7/holders/historical?chain=eth&fromDate=2025-09-20T01%3A00%3A00Z&toDate=2025-09-20T02%3A00%3A00Z&timeFrame=10min"

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

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

print(response.text)

package main

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

func main() {

  url := "https://deep-index.moralis.io/api/v2.2/erc20/0xdac17f958d2ee523a2206206994597c13d831ec7/holders/historical?chain=eth&fromDate=2025-09-20T01%3A00%3A00Z&toDate=2025-09-20T02%3A00%3A00Z&timeFrame=10min"

  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, _ := io.ReadAll(res.Body)

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

}

<?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/0xdac17f958d2ee523a2206206994597c13d831ec7/holders/historical?chain=eth&fromDate=2025-09-20T01%3A00%3A00Z&toDate=2025-09-20T02%3A00%3A00Z&timeFrame=10min', [
  'headers' => [
    'Accept' => 'application/json',
    'X-API-Key' => 'YOUR_API_KEY',
  ],
]);

echo $response->getBody();

Response Example

{
  "page": 1,
  "cursor": "",
  "result": [
    {
      "timestamp": "2025-01-01T00:00:00.000Z",
      "totalHolders": 104188,
      "netHolderChange": 32,
      "holderPercentChange": 0.031,
      "newHoldersByAcquisition": {
        "swap": 159,
        "transfer": 522,
        "airdrop": 3
      },
      "holdersIn": {
        "whales": "",
        "sharks": "",
        "dolphins": "",
        "fish": 2,
        "octopus": 4,
        "crab": 19,
        "shrimps": 659
      },
      "holdersOut": {
        "whales": "",
        "sharks": "",
        "dolphins": "",
        "fish": 1,
        "octopus": 5,
        "crab": 21,
        "shrimps": 625
      }
    }
  ]
}

Don't have an API key yet?

Get ERC20 Token Holders Timeseries

Looking for token holders timeseries on Solana?