rewrite this title Get Solana Whales – How to Fetch Top Whales of a Solana Token – Moralis APIs

Get the whales of any Solana token in seconds! With Moralis’ Solana Token Holders API, you can fetch everything from top token whales to supply distribution insights with just a single API call. Power your crypto project with real-time token holder data that drives engagement, boosts retention, and enhances the overall value of your platform!

To get started, we’ll immediately look at a quick code example that highlights the accessibility of Moralis’ APIs. Here’s how easy it is to get whales for any Solana token: 

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/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/top-holders’, options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));

Calling the endpoint above returns a list of the Solana token’s top holders, complete with balances, supply percentages, and more valuable data. Here’s what it can look like:

{
//…
“totalSupply”: “9245329770.355232”,
“result”: [
{
“balance”: “891735383455576”,
“balanceFormatted”: “891735383.455576”,
“isContract”: false,
“ownerAddress”: “9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM”,
“usdValue”: “891826340.464688468752”,
“percentageRelativeToTotalSupply”: 9.65
},
/…
]
}

That’s it! With just a single API request, you can easily get top holders and whales for any Solana token! 

If you’re eager to learn more about this, please follow along in today’s tutorial or check out the YouTube video below: 

Additionally, if you immediately want to start using our APIs yourself, then click the button below and sign up with Moralis for free!

Overview

Access to top holders of a token is highly beneficial for crypto traders and investors. With this data, they can easily monitor whale action, copy trading strategies, and much more. As such, adding a list of top token holders and whales to your crypto platform will help enhance user value, drive engagement, and boost retention – all of which are essential when running a project!

But how do you get the whales and top holders of any Solana token? And what can you build with this data? 

For the answers to the above questions, join us below as we kickstart this guide by diving straight into the industry’s top crypto data provider: Moralis for Developers. Let’s go! 

Introducing Moralis for Developers – The Easiest Way to Get the Whales of Any Solana Token

Moralis is a leading crypto data provider that features world-class APIs and RPC nodes, designed to make on-chain data integration a breeze. Fetch top Solana whales, a wallet’s fully decoded transaction history, real-time token prices, OHLCV candlesticks, NFT transfers, and much more with just a single line of code. Get the tools, resources, and data you need to build powerful crypto-enabled projects – all in one place! 

Here are three key reasons why developers choose Moralis as their data provider:

Streamlined Developer Experience: With Moralis’ outcome-oriented APIs, you get more data with fewer calls. Build comprehensive token pages, interactive candlestick charts, insightful transaction timelines, and more with just a single endpoint.

Cross-Chain Compatibility: Moralis supports all major EVM chains and the Solana network. This means you can use one unified toolkit to build projects with support spanning the entire Web3 ecosystem. 

World-Class Security & Reliability: With a SOC 2 Type 2 certificate, we can ensure that all Moralis tools and features deliver enterprise-grade security and reliability. 

With an overview of Moralis, let’s take a closer look at the Solana Token Holders API, allowing you to get Solana whales with just one call!

Exploring the Solana Token Holders API

With the Solana Token Holders API, you can get everything from top Solana whales to insight about supply distribution without breaking a sweat. As such, it’s the ultimate tool for anyone looking to fetch and integrate data about Solana token holders into their crypto project! 

Let’s explore the three endpoints of the Solana Token Holders API:

/token/:network/:address/top-holders: Fetch whales and top holders for any Solana token.

/token/mainnet/holders/:address: Query a holder summary for any token on the Solana blockchain, including short-term trend data, acquisition insights, and more.

/token/mainnet/holders/:address/historical: Get historical holder statistics for any Solana token. 

Let’s now dive straight into our tutorial showing you how to fetch top whales of a Solana token!

Full Tutorial: How to Fetch Top Solana Whales in 3 Steps

With the Solana Token Holders API, you can get top whales and holders of a token in three simple steps: 

Get a Moralis API Key

Write a Script

Run the Code

But before we can kick things off, you need to take care of a few prerequisites if you’d like to follow along in today’s tutorial!

Prerequisites

Make sure you have the following ready and installed: 

Step 1: Get a Moralis API Key

To call the Solana Token Holders API, you need a Moralis API key. As such, if you haven’t already, create an account by clicking the ”Start for Free” button at the top right:

After creating an account, you’ll find your API key directly under the ”Home” tab: 

Save the key for now, as you’re going to need it in the following section to fetch top whales of a Solana token! 

Step 2: Write a Script

Next, you need to create a script to call the /token/:network/:address/top-holders endpoint. To do so, start by opening your IDE and setting up a Node.js project using the following terminal command: 

npm init

From here, use the commands below to install the required dependencies:

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

Open the ”package.json” file in your project directory and add ”type”: ”module” to the list: 

Set up a new ”index.js” file and add the code 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/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/top-holders’, options)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));

Lastly, you need to configure the code slightly by adding your key and configuring the parameters to fit your preferences:

Step 3: Run the Code

To run the code, open a new terminal and execute the following command in your project’s root folder: 

node index.js

Doing so will return a list of top Solana whales, complete with addresses, balances, supply percentages, and other valuable data. Here’s an example of what it can look like: 

{
//…
“totalSupply”: “9245329770.355232”,
“result”: [
{
“balance”: “891735383455576”,
“balanceFormatted”: “891735383.455576”,
“isContract”: false,
“ownerAddress”: “9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM”,
“usdValue”: “891826340.464688468752”,
“percentageRelativeToTotalSupply”: 9.65
},
/…
]
}

Congratulations! You now know how to effortlessly fetch top whales and holders of any Solana token!

If you’d like to try out the endpoint, please check out the get top token holders documentation for more information!

Beyond Fetching Top Solana Holders & Whales

Now that you know how to get top holders and whales, let’s also explore the remaining two endpoints of the Solana Token Holders API: 

Query Solana Token Holders Stats

The /token/mainnet/holders/:address endpoint provides a summary of token holder stats. To call this endpoint, just pass along a network and an address parameter. Here’s a sample script showing how it works: 

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

Calling the endpoint above will give you insight into a token’s holder count, short-term trends, acquisition data, and supply distribution. Here’s an example of what it can look like:

{
totalHolders: 513238,
holdersByAcquisition: { swap: 161815, transfer: 137575, airdrop: 213848 },
holderChange: {
‘5min’: { change: -7, changePercent: -0.0014 },
‘1h’: { change: -45, changePercent: -0.0088 },
‘6h’: { change: -208, changePercent: -0.041 },
’24h’: { change: -494, changePercent: -0.096 },
‘3d’: { change: -1652, changePercent: -0.32 },
‘7d’: { change: -3002, changePercent: -0.58 },
’30d’: { change: 15457, changePercent: 3 }
},
holderDistribution: {
whales: 48,
sharks: 38,
dolphins: 672,
fish: 2575,
octopus: 3115,
crabs: 10879,
shrimps: 495911
},
holderSupply: {
top10: { supply: ‘46127367876201534’, supplyPercent: 51.89 },
top25: { supply: ‘54426340492558695’, supplyPercent: 61.23 },
top50: { supply: ‘58627892894350393’, supplyPercent: 65.96 },
top100: { supply: ‘61349275758201721’, supplyPercent: 69.02 },
top250: { supply: ‘64534047701161353’, supplyPercent: 72.6 },
top500: { supply: ‘66981557873551574’, supplyPercent: 75.35 }
}
}

Get Solana Token Holders Timeseries

With the /token/mainnet/holders/:address/historical endpoint, you can query historical holder statistics for any Solana token. To do so, you need to pass along multiple query parameters, including network, address, fromDate, toDate, and timeFrame. Here’s a sample 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/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 code above will give you a list of timestamps. Each one includes holder counts, net changes in holder count, acquisition insights, and other useful data. Here’s an example of a response:

{
“result”: [
{
“timestamp”: “2025-02-01T00:00:00.000Z”,
“totalHolders”: 669942,
“netHolderChange”: -9926,
“holderPercentChange”: -1.5,
“newHoldersByAcquisition”: {
“swap”: 6746,
“transfer”: 5696,
“airdrop”: 529
},
“holdersIn”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 0,
“crabs”: 32,
“shrimps”: 12939
},
“holdersOut”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 3,
“crabs”: 36,
“shrimps”: 22858
}
},
//…
],
}

To learn more about and test the endpoints above, please explore the Solana Token API documentation page!

Why Do You Need to Fetch Top Solana Whales & Other Holder Data?

Integrating token holder insights into your cryptocurrency platform offers many benefits. Here are three examples: 

Enhance User Value: Enriching your platform with token holder data will enhance overall user value, making your project more attractive to crypto investors and traders.

Drive Engagement: Real-time insights and interactive features, such as holder charts, will ensure that your users stay active and engaged on your site.

Boost Retention: Providing accurate, trustworthy data will help you build a loyal user base that wants to return to your project for more information. 

All in all, integrating Solana token holder insights into your application or website is an excellent way to enhance value, drive engagement, and boost retention – all important if you’re looking to run a successful project!

Solana Token Holders API Use Cases

With the Solana Token Holders API, you can seamlessly build powerful features for your platform. Here are some key examples you’ll likely find interesting:

Lists of Top Holders & Whales: With just the /token/:network/:address/top-holders endpoint, you can easily build lists displaying any token’s top holders and whales. This will help users identify significant addresses, along with their balances, supply percentages, and other relevant details. Here’s an example of what it can look like:

Trends, Acquisition, & Distribution Tables: With the /token/mainnet/holders/:address endpoint, you can build tables that show trends, acquisition data, and supply distribution. These tables will allow your users to analyze short-term trends, understand how tokens were acquired, and spot potential concentration risks. Here’s what this feature might look like:

Token Holders Charts: Using the /token/mainnet/holders/:address/historical endpoint, you can easily build holder charts for your project, displaying holder count over various time periods. Adding a feature like this to your platform gives your users the tools they need to analyze both short- and long-term trends without breaking a sweat. Here’s an example of what the charts can look like:

Exploring Other Moralis APIs

In addition to the Solana Token Holders API, Moralis provides a comprehensive range of other industry-leading development tools. Here are three APIs you’ll likely find useful when building crypto projects: 

Wallet API: Using the Wallet API, you can effortlessly query any wallet’s decoded transaction history, token balances, NFT holdings, and more with just a single request. It’s the ultimate tool for building portfolio views, detailed transaction timelines, and other similar features.

Token API: With the Token API, you can easily get a token’s real-time price, swaps, snipers, pairs, metadata, and more with minimal effort. Utilize the Token API to effortlessly create everything from detailed token pages to interactive price charts. 

NFT API: With the NFT API, you can get NFT balances and metadata with just a single line of code. This is a great API for anyone looking to build NFT-Fi tools, NFT marketplaces, and other similar projects. 

If you’d like to learn more about Moralis and explore all our industry-leading tools, please check out the Web3 API page for more information! 

Summary: Get Solana Whales – How to Fetch Top Whales of a Solana Token

Insight into top token holders is extremely useful to traders and investors. With this information, they can easily copy trading strategies, monitor the activity of whales, and much more. As such, by integrating holder insights into your own platform, you’ll give your users the data they need to trade smarter and more efficiently. 

The best and easiest way to get the whales of any token is to use Moralis’ Solana Token Holders API. With this premier tool, you can fetch everything from top whales to acquisition insights for any token on the Solana blockchain network with ease. 

Here are the three endpoints of this premier API: 

/token/:network/:address/top-holders: Get whales and top holders of any Solana token.

/token/mainnet/holders/:address: Fetch a holder summary for any Solana token.

/token/mainnet/holders/:address/historical: Query any Solana token’s historical holder statistics.

When using this premier tool, you can build everything from lists of top whales to advanced holder charts with just a single endpoint! 

So, if you’re looking for an easy way to fetch the top whales of a Solana token, be sure to sign up for a Moralis account today! 

Also, if you want to learn more about what makes Moralis the leading crypto data provider, be sure to check out some of our comparison guides. For instance, see how our toolset compares to either the DeBank API or the CoinGecko API.