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 Token Holders Timeseries

Ethereum Logo

Looking for token holders timeseries on EVM?

Access historical token holder statistics on EVM using our API.

Explore EVM API
GEThttps://solana-gateway.moralis.io/token/mainnet/holders/:address/historical

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

PATH PARAMS
networkstringrequired
The network to query
addressstringrequired
The token mint address
QUERY PARAMS
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
limitnumber
Number of results to return
Responses
API KEY
// 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://solana-gateway.moralis.io/token/mainnet/holders/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/historical?fromDate=2025-01-01T10%3A00%3A00&toDate=2025-02-01T11%3A00%3A00&timeFrame=1d&limit=100', options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Response Example
{
"result": [
{
"timestamp": "2025-02-01T00:00:00.000Z",
"totalHolders": 666573,
"netHolderChange": -10384,
"holderPercentChange": -1.6,
"newHoldersByAcquisition": {
"swap": 6746,
"transfer": 5696,
"airdrop": 529
},
"holdersIn": {
"whales": 1,
"sharks": 1,
"dolphins": 1,
"fish": 1,
"octopus": 1,
"crab": 32,
"shrimps": 12939
},
"holdersOut": {
"whales": 10,
"sharks": 10,
"dolphins": 10,
"fish": 12,
"octopus": 3,
"crab": 36,
"shrimps": 23316
}
}
]
}