rewrite this title Solana Token Holder API – Get a List of Solana Crypto Holders – Moralis APIs

Are you looking for an easy way to get data about Solana token holders? Introducing Moralis’ Solana Token Holder API – the industry’s #1 tool for fetching and integrating holder data. Get a list of Solana token holders stats and query historical statistics with just a single API call, allowing you to build decentralized applications (dapps) faster and more efficiently!

Want to jump straight into the code? Check out the Token Holder Stats endpoint in action below:

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”,
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

With the Token Holder Stats endpoint, you can effortlessly query a token holder summary – including the total number of holders, changes in holder count, acquisition insights, and distribution data – without breaking a sweat. Here’s a sample response:

{
totalHolders: 647008,
holdersByAcquisition: { swap: 473654, transfer: 158202, airdrop: 15152 },
holderChange: {
‘5min’: { change: 1, changePercent: 0.00015 },
‘1h’: { change: 0, changePercent: 0 },
‘6h’: { change: -5, changePercent: -0.00077 },
’24h’: { change: -91, changePercent: -0.014 },
‘3d’: { change: 17, changePercent: 0.0026 },
‘7d’: { change: -786, changePercent: -0.12 },
’30d’: { change: -66419, changePercent: -10 }
},
holderDistribution: {
whales: 2,
sharks: 0,
dolphins: 4,
fish: 5,
octopus: 16,
crabs: 54,
shrimps: 646927
}
}

To learn more about the Solana Token Holder API, join us in today’s guide or check out the Moralis YouTube video below:

Want to try the Solana Token Holder API and other tools yourself? Sign up for a free Moralis for Developers account using the button below!

Overview

Data about token holders can be extremely valuable to traders and investors, helping them assess market sentiment, identify potential supply concentration risks, and much more. As such, integrating holder insights into your crypto projects will help drive engagement, improve retention, and boost the overall value of your platform. 

But what is the best and easiest way to get this data? 

Enter Moralis’ Solana Token Holder API, which allows you to fetch and integrate detailed token holder insights into your projects with just single API calls.

Are you eager to learn more about what this API entails and how it works? Join us down below as we jump straight into the action. Let’s get going!

Introducing the Solana Token Holder API – The Best Way to Get a List of Solana Holders Stats

The Solana Token Holder API gives you the tools you need to effortlessly get holder insights about all tokens on the Solana blockchain. As such, it’s a top-tier interface for anyone looking to enrich their crypto projects with both real-time and historical holder data. 

Here’s a quick overview of the API endpoints: 

Token Holder Stats: Fetch a list of Solana holders stats, including the total number of holders, acquisition insights, changes in holder count, and distribution data.

Token Holders Timeseries: Query historical holder statistics for any Solana token over a specified time period. 

Let’s explore both these endpoints a bit further in separate sections!

Get Token Holder Stats

With the Token Holder Stats endpoint, you can effortlessly get a holder summary for any token on the Solana network. To call it, you simply have to pass along a network and token address parameter. Here’s an example of what it might look like: 

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/2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv”,
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

In return for running the code above, you’ll get a response that looks like this: 

{
totalHolders: 517517,
holdersByAcquisition: { swap: 138323, transfer: 153296, airdrop: 225898 },
holderChange: {
‘5min’: { change: 1, changePercent: 0.00019 },
‘1h’: { change: 5, changePercent: 0.00097 },
‘6h’: { change: 16, changePercent: 0.0031 },
’24h’: { change: -226, changePercent: -0.044 },
‘3d’: { change: -987, changePercent: -0.19 },
‘7d’: { change: -2036, changePercent: -0.39 },
’30d’: { change: -54675, changePercent: -11 }
},
holderDistribution: {
whales: 1,
sharks: 1,
dolphins: 11,
fish: 11,
octopus: 23,
crabs: 225,
shrimps: 517245
}
}

Let’s break down the response parameters here: 

totalHolders: The total number of holders.

holdersByAcquisition: A breakdown of how holders got their tokens, whether it’s through swaps, transfers, or airdrops.

holderChange: Changes in holder count over different time frames. From as short as five minutes to as long as a month.

holderDistribution: Holder distribution by wallet size. Categories include whales, sharks, dolphins, fish, octopus, crabs, and shrimps. 

Check out the Token Holder Stats documentation page to learn more about this endpoint! 

Get Token Holders Timeseries

With the Token Holders Timeseries endpoint, you can seamlessly fetch an array of historical holder statistics for any Solana token address over a specified time period. To call it, you need to pass along network, address, fromDate, toDate, and timeFrame parameters. Here’s what it can look like: 

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));

Running the script above will give you an array that looks something like this: 

{
“result”: [
{
“timestamp”: “2025-02-01T00:00:00.000Z”,
“totalHolders”: 666573,
“netHolderChange”: -10384,
“holderPercentChange”: -1.6,
“newHoldersByAcquisition”: {
“swap”: 6746,
“transfer”: 5696,
“airdrop”: 529
},
“holdersIn”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 0,
“crab”: 32,
“shrimps”: 12939
},
“holdersOut”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 3,
“crab”: 36,
“shrimps”: 23316
}
},
//…
],
“page”: 1
}

Each item in the array has a few different parameters. Let’s break them down below:

timestamp: A timestamp for the specific data point.

totalHolders: The total number of holders for the timestamp.

netHolderChange: Net change in the number of token holders.

holderPercentChange: Percentage change in the number of token holders.

newHoldersByAcquisition: A breakdown of how new holders got their tokens.

holdersIn: New holders by wallet size. 

holdersOut: Holders that left by wallet size. 

To learn more about this endpoint, check out the Token Holder Timeseries documentation page! 

Full Tutorial: How to Get a List of Solana Holders Stats

With an overview of the Solana Token Holder API, we’ll now show you how to use it in practice. More specifically, we’re going to walk you through a tutorial on how to get a list of stats about Solana token holders in three simple steps:

Get Yourself a Moralis API Key

Write a Script Calling the Token Holder Stats Endpoint

Run the Code & Interpret the Data

Prerequisites

For this tutorial, we’ll be using Node.js. As such, if you want to follow along, make sure you have the following installed: 

Step 1: Get Yourself a Moralis API Key

If you want to start using the Solana Token Holder API, you need a Moralis API key. As such, if you haven’t already, click the ”Start for Free” button and set up an account: 

After logging into the admin panel, you can find your API key straight on the home page: 

Copy and save the key for now, as you’re going to need it in the next step when we call the Solana Token Holders API.

Step 2: Write a Script Calling the Token Holder Stats Endpoint

With your API key at hand, it’s time to write a script that calls the Token Holder Stats endpoint. So, open your preferred code editor, set up a folder, launch a new terminal, and initialize a project with the command below: 

npm init

Next, install the following dependencies: 

npm install node-fetch –save
npm install moralis @moralisweb3/common-evm-utils

When you create a new Node.js project, you’ll automatically get a ”package.json” file. Open this file and add ”type”: ”module” to the list: 

From here, create a new ”index.js” file and add the following script: 

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/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump”,
options
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

Lastly, replace YOUR_API_KEY with the key you copied in the first step, and change the address parameter to fit your preferences: 

Step 3: Run the Code & Interpret the Data

Finally, run this terminal command to execute the code:

node index.js

In return, you’ll get a list of stats – including the total number of holders, changes in holder count, acquisition data, and distribution insights – with just one endpoint. Here’s a sample response:

{
totalHolders: 125339,
holdersByAcquisition: { swap: 93138, transfer: 29156, airdrop: 3045 },
holderChange: {
‘5min’: { change: 8, changePercent: 0.0064 },
‘1h’: { change: 30, changePercent: 0.024 },
‘6h’: { change: 35, changePercent: 0.028 },
’24h’: { change: 1314, changePercent: 1 },
‘3d’: { change: 4319, changePercent: 3.4 },
‘7d’: { change: 7053, changePercent: 5.6 },
’30d’: { change: 9081, changePercent: 7.2 }
},
holderDistribution: {
whales: 0,
sharks: 0,
dolphins: 11,
fish: 57,
octopus: 227,
crabs: 886,
shrimps: 124158
}
}

Getting a list of stats about Solana token holders when working with Moralis doesn’t have to be more challenging than this!

Use Cases for the Solana Token Holder API

The Solana Token Holder API has multiple prominent use cases. Let’s explore four prominent examples below: 

Holder Trends: Give your users insight into how the number of holders has been developing over various time periods, giving them both short- and long-term insight into holder count.

Wallet Distribution: Show how the total supply is distributed based on wallet size. This will, for example, help users identify potential concentration risks, allowing them to make more informed investment decisions.

Holder Acquisition: Display how holders acquired their tokens, whether it’s via transfers, swaps, or airdrops. This can be vital information in determining overall market sentiment. 

Holders Chart: Build comprehensive holder charts that give users a clear visual representation of how holders have grown or declined over time. 

Here’s an example of a dashboard implementing the features above: 

The features mentioned above are only a few examples of what you can build with the Solana Token Holder API. Here, the only thing limiting you is your imagination!

What Makes the Solana Token Holder API the Best in the Business?

At this point, you might ask yourself, “Why should I use the Solana Token Holder API?” To answer this, let’s take a closer look at three reasons why Moralis stands out as the #1 crypto data provider in the Web3 industry! 

Most Comprehensive APIs: The APIs offered by Moralis are outcome-oriented, giving you the industry’s most comprehensive responses. That way, you get more data with fewer calls, allowing you to build faster and more efficiently. 

Extensive Cross-Chain Support: Moralis provides full feature parity across all major chains, including Solana, Ethereum, Optimism, Base, etc. Use one unified toolkit to build dapps compatible with all the most significant blockchain networks. 

Enterprise-Grade Reliability & Security: Moralis is SOC 2 Type 2 certified, ensuring world-class reliability and security across all features and tools. 

In short, Moralis offers the industry’s most comprehensive, secure, and reliable APIs so you can build cross-chain compatible dapps without breaking a sweat! 

Beyond Getting a List of Solana Holders Data – Exploring Other APIs & Features

The Solana Token Holders API is only a taste of what you can do with Moralis. As such, let’s briefly look at three additional interfaces that you’ll want to check out if you’re building Web3 projects: 

NFT API: Get NFT balances and up-to-date metadata for any token on the Solana blockchain. This is the perfect API for anyone looking to integrate NFT-related data into crypto projects. So, if you’re building NFT marketplaces, NFT-Fi platforms, or other similar projects, check out the NFT API. 

Price API: Fetch real-time prices, in-depth trading stats, and OHLCV data with just single API calls. Use the Price API to enrich your crypto project with accurate price data and build powerful features like candlestick charts. 

Wallet API: Query any wallet’s portfolio data, decoded wallet history, profitability, and much more without breaking a sweat. The Wallet API is a world-class interface if you’re looking to add wallet data to your projects. As such, if you’re building portfolio trackers, tax platforms, and other similar projects, explore the Wallet API today.

Check out the Solana API page to learn more about the interfaces above!

Add Holder Charts with Moralis Crypto Widgets

If you’re not looking to build holder charts and other features from scratch, you’ll want to check out Moralis’ Token Page Widget. With the Token Page Widget, you can integrate an entire token page – including holder charts, trend data, acquisition insights, and more – with ease. Here’s what it looks like: 

So, how do you add this yourself? 

Here’s a three-step breakdown of the process: 

Step 2 – The page will feature a Wrapped Bitcoin (WBTC) widget by default. To configure the widget, scroll down to the ”Configuration” section, select a chain, and add the token address of your choice: 

Step 3 – Copy the code and integrate it into your project: 

And that’s it; it’s that easy to add a token page to your project. Integrating a token page into your project is an excellent way to keep your users informed and active. As such, it’s a great tool for boosting both user engagement and retention! 

Summary: Solana Token Holder API – Get a List of Solana Holders

Integrating token holder data into your project can help drive user engagement, improve retention, and boost value – all because you’re giving your users valuable insights they can use to make more informed trading decisions. 

But what is the best and easiest way to get Solana token holders? 

Introducing the Solana Token Holder API, allowing you to fetch in-depth holder data for any Solana token with just single calls. Here are two key endpoints: 

Token Holder Stats: Get a token holder summary – including the total number of holders, acquisition data, changes in holder count, and supply distribution insights – with one endpoint.

Token Holder Timeseries: Fetch historical holder statistics for any Solana token address over a set time period with ease.

With the Solana Token Holder API, you can build powerful features like holder charts and give your users seamless insight into trends, supply distribution, and acquisition data.

If you want to use the Solana Token Holder API yourself, take this opportunity to sign up for a free Moralis account so you can start streamlining your development endeavors today! 

Also, if you found this guide interesting, consider checking out some more content here on the blog. For example, read our deep dives into the OHLC API and Address Labeling API.