Are you in search of a simple option to get information about Solana token holders? Introducing Moralis’ Solana Token Holder API – the trade’s #1 instrument for fetching and integrating holder information. Get a listing of Solana token holders stats and question historic statistics with only a single API name, permitting you to construct decentralized functions (dapps) quicker and extra effectively!
Need to leap straight into the code? Try the Token Holder Stats endpoint in motion under:
import fetch from “node-fetch”;
const choices = {
methodology: “GET”,
headers: {
settle for: “utility/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};
fetch(
“https://solana-gateway.moralis.io/token/mainnet/holders/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
With the Token Holder Stats endpoint, you may effortlessly question a token holder abstract – together with the full variety of holders, adjustments in holder rely, acquisition insights, and distribution information – with out breaking a sweat. Right here’s a pattern response:
{
totalHolders: 647008,
holdersByAcquisition: { swap: 473654, switch: 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 be taught extra in regards to the Solana Token Holder API, be a part of us in right this moment’s information or try the Moralis YouTube video under:
Need to attempt the Solana Token Holder API and different instruments your self? Join a free Moralis for Builders account utilizing the button under!
Overview
Information about token holders may be extraordinarily priceless to merchants and buyers, serving to them assess market sentiment, determine potential provide focus dangers, and way more. As such, integrating holder insights into your crypto tasks will assist drive engagement, enhance retention, and increase the general worth of your platform.
However what’s the finest and best option to get this information?
Enter Moralis’ Solana Token Holder API, which lets you fetch and combine detailed token holder insights into your tasks with simply single API calls.
Are you desirous to be taught extra about what this API entails and the way it works? Be a part of us down under as we leap straight into the motion. Let’s get going!
Introducing the Solana Token Holder API – The Finest Method to Get a Checklist of Solana Holders Stats
The Solana Token Holder API offers you the instruments it’s essential effortlessly get holder insights about all tokens on the Solana blockchain. As such, it’s a top-tier interface for anybody seeking to enrich their crypto tasks with each real-time and historic holder information.
Right here’s a fast overview of the API endpoints:
Token Holder Stats: Fetch a listing of Solana holders stats, together with the full variety of holders, acquisition insights, adjustments in holder rely, and distribution information.
Token Holders Timeseries: Question historic holder statistics for any Solana token over a specified time interval.
Let’s discover each these endpoints a bit additional in separate sections!
Get Token Holder Stats
With the Token Holder Stats endpoint, you may effortlessly get a holder abstract for any token on the Solana community. To name it, you merely should move alongside a community and token tackle parameter. Right here’s an instance of what it would appear like:
import fetch from “node-fetch”;
const choices = {
methodology: “GET”,
headers: {
settle for: “utility/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};
fetch(
“https://solana-gateway.moralis.io/token/mainnet/holders/2zMMhcVQEXDtdE6vsFS7S7D5oUodfJHE8vd1gnBouauv”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
In return for operating the code above, you’ll get a response that appears like this:
{
totalHolders: 517517,
holdersByAcquisition: { swap: 138323, switch: 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 right here:
totalHolders: The entire variety of holders.
holdersByAcquisition: A breakdown of how holders acquired their tokens, whether or not it’s by means of swaps, transfers, or airdrops.
holderChange: Modifications in holder rely over completely different time frames. From as brief as 5 minutes to so long as a month.
holderDistribution: Holder distribution by pockets measurement. Classes embrace whales, sharks, dolphins, fish, octopus, crabs, and shrimps.
Try the Token Holder Stats documentation web page to be taught extra about this endpoint!
Get Token Holders Timeseries
With the Token Holders Timeseries endpoint, you may seamlessly fetch an array of historic holder statistics for any Solana token tackle over a specified time interval. To name it, it’s essential move alongside community, tackle, fromDate, toDate, and timeFrame parameters. Right here’s what it will possibly appear like:
import fetch from “node-fetch”;
const choices = {
methodology: “GET”,
headers: {
settle for: “utility/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};
fetch(
“https://solana-gateway.moralis.io/token/mainnet/holders/6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN/historic?fromDate=2025-01-01T10percent3A00percent3A00&toDate=2025-02-01T11percent3A00percent3A00&timeFrame=1d&restrict=100”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
Working the script above will provide you with an array that appears one thing like this:
{
“consequence”: [
{
“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
}
},
//…
],
“web page”: 1
}
Every merchandise within the array has a couple of completely different parameters. Let’s break them down under:
timestamp: A timestamp for the particular information level.
totalHolders: The entire variety of holders for the timestamp.
netHolderChange: Web change within the variety of token holders.
holderPercentChange: Share change within the variety of token holders.
newHoldersByAcquisition: A breakdown of how new holders acquired their tokens.
holdersIn: New holders by pockets measurement.
holdersOut: Holders that left by pockets measurement.
To be taught extra about this endpoint, try the Token Holder Timeseries documentation web page!
Full Tutorial: Find out how to Get a Checklist of Solana Holders Stats
With an outline of the Solana Token Holder API, we’ll now present you methods to use it in apply. Extra particularly, we’re going to stroll you thru a tutorial on methods to get a listing of stats about Solana token holders in three easy steps:
Get Your self a Moralis API Key
Write a Script Calling the Token Holder Stats Endpoint
Run the Code & Interpret the Information
Conditions
For this tutorial, we’ll be utilizing Node.js. As such, if you wish to comply with alongside, ensure you have the next put in:
Step 1: Get Your self a Moralis API Key
If you wish to begin utilizing the Solana Token Holder API, you want a Moralis API key. As such, in the event you haven’t already, click on the ”Begin for Free” button and arrange an account:
After logging into the admin panel, yow will discover your API key straight on the house web page:
Copy and save the important thing for now, as you’re going to want it within the subsequent step after we name the Solana Token Holders API.
Step 2: Write a Script Calling the Token Holder Stats Endpoint
Along with your API key at hand, it’s time to jot down a script that calls the Token Holder Stats endpoint. So, open your most well-liked code editor, arrange a folder, launch a brand new terminal, and initialize a mission with the command under:
npm init
Subsequent, set up the next dependencies:
npm set up node-fetch –save
npm set up moralis @moralisweb3/common-evm-utils
Once you create a brand new Node.js mission, you’ll robotically get a ”bundle.json” file. Open this file and add ”sort”: ”module” to the record:
From right here, create a brand new ”index.js” file and add the next script:
import fetch from “node-fetch”;
const choices = {
methodology: “GET”,
headers: {
settle for: “utility/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};
fetch(
“https://solana-gateway.moralis.io/token/mainnet/holders/9BB6NFEcjBCtnNLFko2FqVQBq8HHM13kCyYcdQbgpump”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));
Lastly, exchange YOUR_API_KEY with the important thing you copied in step one, and alter the tackle parameter to suit your preferences:
Step 3: Run the Code & Interpret the Information
Lastly, run this terminal command to execute the code:
node index.js
In return, you’ll get a listing of stats – together with the full variety of holders, adjustments in holder rely, acquisition information, and distribution insights – with only one endpoint. Right here’s a pattern response:
{
totalHolders: 125339,
holdersByAcquisition: { swap: 93138, switch: 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 listing of stats about Solana token holders when working with Moralis doesn’t should be more difficult than this!
Use Circumstances for the Solana Token Holder API
The Solana Token Holder API has a number of distinguished use circumstances. Let’s discover 4 distinguished examples under:
Holder Traits: Give your customers perception into how the variety of holders has been growing over varied time durations, giving them each short- and long-term perception into holder rely.
Pockets Distribution: Present how the full provide is distributed based mostly on pockets measurement. This can, for instance, assist customers determine potential focus dangers, permitting them to make extra knowledgeable funding selections.
Holder Acquisition: Show how holders acquired their tokens, whether or not it’s through transfers, swaps, or airdrops. This may be very important info in figuring out general market sentiment.
Holders Chart: Construct complete holder charts that give customers a transparent visible illustration of how holders have grown or declined over time.
Right here’s an instance of a dashboard implementing the options above:
The options talked about above are only some examples of what you may construct with the Solana Token Holder API. Right here, the one factor limiting you is your creativeness!
What Makes the Solana Token Holder API the Finest within the Enterprise?
At this level, you may ask your self, “Why ought to I exploit the Solana Token Holder API?” To reply this, let’s take a more in-depth have a look at three the explanation why Moralis stands out because the #1 crypto information supplier within the Web3 trade!
Most Complete APIs: The APIs provided by Moralis are outcome-oriented, supplying you with the trade’s most complete responses. That approach, you get extra information with fewer calls, permitting you to construct quicker and extra effectively.
In depth Cross-Chain Help: Moralis supplies full function parity throughout all main chains, together with Solana, Ethereum, Optimism, Base, and many others. Use one unified toolkit to construct dapps suitable with all probably the most vital blockchain networks.
Enterprise-Grade Reliability & Safety: Moralis is SOC 2 Sort 2 licensed, guaranteeing world-class reliability and safety throughout all options and instruments.
In brief, Moralis affords the trade’s most complete, safe, and dependable APIs so you may construct cross-chain suitable dapps with out breaking a sweat!
Past Getting a Checklist of Solana Holders Information – Exploring Different APIs & Options
The Solana Token Holders API is barely a style of what you are able to do with Moralis. As such, let’s briefly have a look at three extra interfaces that you simply’ll need to try in the event you’re constructing Web3 tasks:
NFT API: Get NFT balances and up-to-date metadata for any token on the Solana blockchain. That is the proper API for anybody seeking to combine NFT-related information into crypto tasks. So, in the event you’re constructing NFT marketplaces, NFT-Fi platforms, or different related tasks, try the NFT API.
Worth API: Fetch real-time costs, in-depth buying and selling stats, and OHLCV information with simply single API calls. Use the Worth API to complement your crypto mission with correct value information and construct highly effective options like candlestick charts.
Pockets API: Question any pockets’s portfolio information, decoded pockets historical past, profitability, and way more with out breaking a sweat. The Pockets API is a world-class interface in the event you’re trying so as to add pockets information to your tasks. As such, in the event you’re constructing portfolio trackers, tax platforms, and different related tasks, discover the Pockets API right this moment.
Try the Solana API web page to be taught extra in regards to the interfaces above!
Add Holder Charts with Moralis Crypto Widgets
Should you’re not seeking to construct holder charts and different options from scratch, you’ll need to try Moralis’ Token Web page Widget. With the Token Web page Widget, you may combine a whole token web page – together with holder charts, development information, acquisition insights, and extra – with ease. Right here’s what it seems to be like:
So, how do you add this your self?
Right here’s a three-step breakdown of the method:
Step 2 – The web page will function a Wrapped Bitcoin (WBTC) widget by default. To configure the widget, scroll all the way down to the ”Configuration” part, choose a series, and add the token tackle of your selection:
Step 3 – Copy the code and combine it into your mission:
And that’s it; it’s that straightforward so as to add a token web page to your mission. Integrating a token web page into your mission is a wonderful option to preserve your customers knowledgeable and energetic. As such, it’s an excellent instrument for reinforcing each person engagement and retention!
Abstract: Solana Token Holder API – Get a Checklist of Solana Holders
Integrating token holder information into your mission may also help drive person engagement, enhance retention, and increase worth – all since you’re giving your customers priceless insights they will use to make extra knowledgeable buying and selling selections.
However what’s the finest and best option to get Solana token holders?
Introducing the Solana Token Holder API, permitting you to fetch in-depth holder information for any Solana token with simply single calls. Listed here are two key endpoints:
Token Holder Stats: Get a token holder abstract – together with the full variety of holders, acquisition information, adjustments in holder rely, and provide distribution insights – with one endpoint.
Token Holder Timeseries: Fetch historic holder statistics for any Solana token tackle over a set time interval with ease.
With the Solana Token Holder API, you may construct highly effective options like holder charts and provides your customers seamless perception into traits, provide distribution, and acquisition information.
If you wish to use the Solana Token Holder API your self, take this chance to enroll in a free Moralis account so you can begin streamlining your growth endeavors right this moment!
Additionally, in the event you discovered this information fascinating, take into account trying out some extra content material right here on the weblog. For instance, learn our deep dives into the OHLC API and Handle Labeling API.
