Token Holder API - Best Cross-Chain Crypto Holder API

What in case you might get prime holders, correct provide distribution knowledge, acquisition insights, and far more for any token with only one line of code? Enter Moralis Token Holder API, the final word instrument for anybody trying to fetch and combine crypto holder knowledge into Web3 tasks. Wanting to be taught extra about this top-tier API? Be part of us in at this time’s information as we present you precisely the way it works. Let’s go!

If you wish to soar straight into the code, try the Token Holders endpoint in motion proper right here:

import fetch from “node-fetch”;

const choices = {
methodology: “GET”,
headers: {
settle for: “software/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};

fetch(
“https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/homeowners?chain=eth&order=DESC”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

Calling the endpoint above offers you a listing of the required token’s prime holders. Furthermore, the response is enriched with tackle labels, logos, provide percentages, and extra, minimizing the calls wanted to construct advanced options:

{
//…
“consequence”: [
{
balance: ‘6196351909968209613047652223963’,
balance_formatted: ‘6196351909968.209613047652223963’,
is_contract: false,
owner_address: ‘0xf89d7b9c864f589bbf53a82105107622b35eaa40’,
owner_address_label: ‘Bybit: Hot Wallet’,
entity: ‘Bybit’,
entity_logo: ‘https://entities-logos.s3.us-east-1.amazonaws.com/bybit.png’,
usd_value: ‘42105073.909894451498985291’,
percentage_relative_to_total_supply: 1.472902466893352
},
//…
]
}

The Token Holders endpoint solely scratches the floor of the Token Holder API. To be taught extra, comply with alongside as we present you how you can simply fetch any token’s provide distribution, acquisition knowledge, and far more.

Wish to check out the Token Holder API your self instantly? Join a free Moralis account at this time!

Overview

Including token holder knowledge can considerably enhance your platform’s worth. Exposing pockets distribution insights, prime holders, acquisition knowledge, and extra permits customers to higher gauge market sentiment, determine focus dangers, catch potential scams, and spot whale actions. And this added transparency can enhance decision-making for each crypto merchants and traders. As such, whether or not you’re constructing a DEX tracker, portfolio instrument, or analytics dashboard, token holder insights can set your product aside.

However what’s the finest and simplest way so as to add token holder knowledge to your Web3 tasks?

In the event you’re searching for the reply to this query, be part of us down beneath as we kick issues off by introducing you to the {industry}’s main crypto knowledge supplier: Moralis!

Introducing Moralis for Builders: The Business’s Main Crypto Information Supplier

Moralis for Builders is the {industry}’s #1 crypto knowledge supplier. In our suite of Web3 growth instruments, you’ll discover top-tier APIs and next-generation RPC nodes designed to streamline dependable knowledge integration into your tasks. Consequently, when utilizing Moralis, you may construct decentralized functions (dapps) sooner and extra effectively!

However what makes Moralis the #1 crypto knowledge supplier?

Complete APIs: Moralis APIs are constructed with the result in thoughts, providing you with extra knowledge with fewer calls. Get complete token holder knowledge, a pockets’s full transaction historical past, in-depth portfolio knowledge, and far more with simply single requests.

Cross-Chain Compatibility: Expertise full function parity throughout all main chains, together with Solana, Ethereum, BNB Good Chain (BSC), Base, Optimism, and plenty of extra networks. Use one set of instruments to construct throughout the whole Web3 ecosystem.

Enterprise-Grade Reliability & Safety: Moralis is SOC 2 Kind 2 licensed, highlighting our dedication to sustaining world-class reliability and safety throughout all instruments and options.

With an outline of Moralis, let’s dive into the {industry}’s main Token Holder API!

Exploring the Finest Token Holder API

Moralis Token Holder API is the final word instrument for fetching and integrating holder knowledge into your Web3 tasks. You should utilize this premier API to get every thing from prime holders to acquisition knowledge – all with single strains of code!

Text: "Exploring the best token holder api"

The Token Holder API options three key endpoints:

Token Holders: Question all main holders of a token and their possession share.

Token Holder Stats: Get a listing of token holder stats, together with the holder rely, acquisition knowledge, provide distribution insights, and extra.

Token Holders Timeseries: Fetch historic holder statistics for any token over a set time interval.

Nonetheless, let’s discover these three endpoints additional in separate sections!

Token Holders

With the Token Holders endpoint, you may question a listing of all main holders of a token. Merely cross alongside an tackle and chain parameter and name the endpoint. Right here’s an instance of what it appears to be like like:

import fetch from “node-fetch”;

const choices = {
methodology: “GET”,
headers: {
settle for: “software/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};

In return for calling the endpoint, you get a listing of holders for the required token. Moreover, every merchandise within the array is enriched with logos, tackle labels, and far more. Right here’s a pattern response:

Token Holder Stats

The Token Holder Stats endpoint returns a holder abstract for the required token. To name it, merely cross alongside an tackle and chain parameter. Right here’s what it may well seem like:

import fetch from “node-fetch”;

const choices = {
methodology: “GET”,
headers: {
settle for: “software/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};

fetch(
“https://deep-index.moralis.io/api/v2.2/erc20/0x6982508145454ce325ddbe47a25d4ec3d2311933/holders?chain=eth”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

Calling this endpoint returns the full holder rely, acquisition metrics, distribution insights, and holder adjustments over time. Right here’s an instance response:

{
totalHolders: 421342,
holdersByAcquisition: { swap: 122795, switch: 282993, airdrop: 15554 },
holderChange: {
‘5min’: { change: 2, changePercent: 0.00047 },
‘1h’: { change: 18, changePercent: 0.0043 },
‘6h’: { change: 98, changePercent: 0.023 },
’24h’: { change: 356, changePercent: 0.084 },
‘3d’: { change: 1156, changePercent: 0.27 },
‘7d’: { change: 2122, changePercent: 0.5 },
’30d’: { change: 9819, changePercent: 2.3 }
},
holderSupply: {
top10: { provide: ‘164783457390612.77’, supplyPercent: 39 },
top25: { provide: ‘226647944524114.14’, supplyPercent: 54 },
top50: { provide: ‘273001677904297.12’, supplyPercent: 65 },
top100: { provide: ‘307354487723478.82’, supplyPercent: 73 },
top250: { provide: ‘344156607227442.39’, supplyPercent: 82 },
top500: { provide: ‘362561870786335.94’, supplyPercent: 86 }
},
holderDistribution: {
whales: 106,
sharks: 77,
dolphins: 634,
fish: 2130,
octopus: 6136,
crab: 22071,
shrimps: 390188
}
}

Token Holders Timeseries

With the Token Holders Timeseries endpoint, you may question an array of historic holder statistics inside a particular timeframe. To name this endpoint, you could cross alongside a sequence, tackle, toDate, fromDate, and timeFrame parameter. That is an instance of what it may well seem like:

import fetch from “node-fetch”;

const choices = {
methodology: “GET”,
headers: {
settle for: “software/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};

fetch(
“https://deep-index.moralis.io/api/v2.2/erc20/0x2260fac5e5542a773aa44fbcfedf7c193bc2c599/holders/historic?chain=eth&fromDate=2025-01-01T10percent3A00percent3A00&toDate=2025-02-01T11percent3A00percent3A00&timeFrame=1d”,
choices
)
.then((response) => response.json())
.then((response) => console.log(response))
.catch((err) => console.error(err));

Calling the endpoint above offers you an array of timestamps with the holder rely, the web change in holder rely, acquisition knowledge, and far more. Right here’s a pattern response:

{
//…
“consequence”: [
{
“timestamp”: “2025-02-01T00:00:00.000Z”,
“totalHolders”: 113624,
“netHolderChange”: 1474,
“holderPercentChange”: 1.3,
“newHoldersByAcquisition”: {
“swap”: 531,
“transfer”: 2052,
“airdrop”: 6
},
“holdersIn”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 5,
“crab”: 23,
“shrimps”: 2561
},
“holdersOut”: {
“whales”: 0,
“sharks”: 0,
“dolphins”: 0,
“fish”: 0,
“octopus”: 7,
“crab”: 22,
“shrimps”: 1086
}
},
//…
]
}

To be taught extra about these endpoints, please try the Token API documentation web page!

Full Tutorial: The way to Get Crypto Holder Information with the Token Holder API

Now that you’ve got familiarized your self with the Token Holder API let’s take a more in-depth have a look at how you should utilize this premier instrument to get crypto holder knowledge. Extra particularly, we’ll present you how you can get token holder stats in three easy steps:

Get an API Key

Write a Script

Run the Code

However earlier than we are able to transfer on, you want to deal with a few stipulations!

Stipulations

Earlier than continuing to step one, be sure you have the next put in:

Step 1: Get an API Key

The very first thing you’ll want is a Moralis API key. As such, in case you haven’t already, click on the ”Begin for Free” button on the prime proper and join an account:

With an account at hand, you’ll discover your API key straight below the ”House” tab when you log into the admin panel:

Copy the important thing for now, as you’ll want it within the subsequent step when calling the Token Holder API.

Step 2: Write a Script

Open your most well-liked IDE, arrange a mission, launch a brand new terminal, and initialize a brand new mission with this command:

npm init

Set up the required dependencies:

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

Subsequent, open your ”bundle.json” file and add ”sort”: ”module” to the listing:

"type": "module" highlighted in code editor.

From right here, arrange a brand new ”index.js” file and add the next code:

import fetch from “node-fetch”;

const choices = {
methodology: “GET”,
headers: {
settle for: “software/json”,
“X-API-Key”: “YOUR_API_KEY”,
},
};

Lastly, you want to make some small configurations to the code. Firstly, change YOUR_API_KEY with the important thing you simply copied. Additionally, swap out the tackle to suit your preferences:

Step 3: Run the Code

From right here, all that is still is to run the code. To take action, open a brand new terminal and run this command within the mission’s root folder:

node index.js

In return, you’ll get a response that appears like this:

Let’s break down the response parameters right here:

totalHolders: Variety of holders in whole.

holdersByAcquisition: An summary of how holders acquired their tokens, whether or not it’s by way of airdrops, transfers, or swaps.

holderChange: Modifications in holder rely over totally different timeframes. From so long as a month to as quick as 5 minutes.

holderSupply: Perception into provide distribution amongst prime holders.

holderDistribution: An summary of holder distribution by pockets dimension. Classes embody shrimp, crabs, octopus, fish, dolphins, sharks, and whales.

That’s it! It’s this straightforward to get crypto holder knowledge with the Token Holder API. Nevertheless, in case you’re searching for an much more in-depth tutorial, try the YouTube video down beneath:

Additionally, to be taught extra about this premier interface and different endpoints, please discover the Token API additional!

What Can You Construct with the Token Holder API?

The Token Holder API has many outstanding use instances, permitting you to construct every thing from holders lists to complete crypto charts. Let’s have a look at three outstanding examples down beneath.

#1 High Holders Record

With only one name to the Token Holders endpoint, you may create a complete listing of a token’s prime holders. What’s extra, because of the comprehensiveness of the response, you may embody tackle labels, possession percentages, and far more. Right here’s an instance of what it’d seem like:

#2 Token Holder Stats

With the Token Holder API, you may give customers in-depth perception into token holder stats, together with short-term developments, provide distribution, and acquisition knowledge. And the most effective half? You may get all the information you want with only one request to the Token Holder Stats endpoint. Right here’s an instance of what the function can seem like:

#3 Token Holders Chart

With the Token Holders Timeseries endpoint, you may fetch all the information wanted to construct a complete token holders chart, giving your customers an outline of how the holder rely has developed over time. Right here’s an instance of what it may well seem like:

High lists, dimension distribution tables, and crypto charts are solely three outstanding examples of what you may construct with the Token Holder API. Right here, the one factor stopping you is your creativeness!

Moralis vs. HolderScan API: Which is the Finest Crypto Holder API?

Now that what the Token Holder API is, let’s take a more in-depth have a look at how this premier instrument stacks up towards a recognized competitor: HolderScan API. Right here’s a fast abstract of some key variations:

Let’s break it down a bit additional beneath:

Cross-Chain Help: Moralis APIs assist all EVM chains and Solana, whereas HolderScan API is restricted to Solana solely.

Token Protection: Moralis APIs provide you with entry to greater than 6,500,000 tokens throughout all main chains. In distinction, the HolderScan API has a a lot narrower scope.

Out there Timeframes: Moralis helps a wider vary of holder timeframes, from 5 minutes to 30 days. As compared, the HolderScan API solely has three: seven, 14, and 30 days.

In-Depth Holder Information: Moralis offers extra detailed knowledge on token holders in comparison with HolderScan API. This contains extra granular distribution knowledge, in-depth acquisition insights, and extra.

All in all, the Token Holder API is a extra full resolution than the HolderScan API. As such, in case you’re searching for a simple solution to combine crypto holder insights into your platform, begin utilizing the Token Holder API at this time.

To additional spotlight why Moralis is the premier various, try the video beneath, exhibiting you ways straightforward it’s to construct a HolderScan clone with our APIs:

Additionally, superior APIs are one in every of many the reason why Moralis.com is a greater platform for crypto merchants than HolderScan. To be taught extra about this, learn our HolderScan various information!

Past the #1 Token Holder API – Exploring Different Moralis Instruments & Options

Along with a top-tier Token Holder API, Moralis gives a bunch of different industry-leading instruments. Listed below are another APIs and sources you’ll possible discover useful in case you’re a Web3 developer:

Pockets API: The right instrument for integrating wallet-related knowledge into your mission, permitting you to construct every thing from portfolio trackers to tax instruments with out breaking a sweat. Fetch in-depth portfolio knowledge, decoded pockets historical past, DeFi positions, a pockets’s internet value, and far more with only a single API name.

NFT API: The NFT API is a top-tier instrument for anybody constructing NFT-related platforms, akin to marketplaces, NFT-Fi platforms, and so forth. It permits customers to simply entry real-time possession insights, up-to-date metadata, balances, costs, and far more.

Value API: The final word interface for anybody trying to enrich their crypto platform with correct value knowledge. Question real-time and historic costs, in-depth buying and selling stats, and OHLCV knowledge with single requests.

Streams API: The Streams API is the {industry}’s #1 real-time knowledge resolution, permitting you to arrange personalized Web3 knowledge pipelines with minimal effort. Expertise 100% supply ensures, wealthy knowledge payloads, and full cross-chain assist spanning all main networks.

Prolonged RPC Strategies: With the Prolonged RPC Strategies, you get the identical knowledge Moralis’ APIs ship however by way of RPC-style requests. Get real-time costs, absolutely decoded transactions, token balances, NFT metadata, and far more with ease.

To be taught extra in regards to the instruments and interfaces above, please try the Web3 API web page!

Abstract: Token Holder API – Finest Cross-Chain Crypto Holder API

Including token holder knowledge to your platform may help enhance its worth by permitting customers to determine focus dangers, detect whale actions, and gauge general market sentiment. However what’s one of the best ways to fetch and combine these insights? The reply: Moralis Token Holder API!

Text: "Summary: Token Holder API - Best Cross-Chain Crypto Holder API"

The Token Holder API is the simplest solution to fetch and combine crypto holder knowledge into your Web3 tasks. Right here’s an outline of the obtainable endpoints:

Token Holders: Get a listing of all main holders of a token.

Token Holder Stats: Question token holder stats, together with acquisition insights, provide distribution knowledge, holder rely, and extra.

Token Holders Timeseries: Fetch historic holder statistics for any token.

So, in case you’re searching for a simple solution to get crypto holder knowledge, remember to try the Token Holder API at this time!

Additionally, in case you favored this information, take into account testing extra content material right here on the weblog. For instance, dive into our Raydium API article or discover ways to discover the highest SimpleHash various in 2025.

Source link