Are you on the lookout for the simplest approach to get the total provide of a token? If that’s the case, you’re in the correct place. This information will present you easy methods to effortlessly entry the total provide of a token utilizing Moralis – the {industry}’s main Web3 information supplier. At Moralis, we’ve enriched our ERC-20 endpoints with in-depth metadata, guaranteeing you robotically obtain the total provide of a coin when querying token balances, metadata, and extra. Keen to leap straight into the code? Right here’s an instance exhibiting our token metadata endpoint in motion:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.moralis.io/api/v2.2/erc20/metadata?chain=eth&addressespercent5B0percent5D=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
By calling the endpoint above, you’ll obtain the metadata of the required token, together with two central parameters: total_supply and total_supply_formatted. Right here’s an instance of what it appears to be like like:
[
{
address: ‘0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48’,
address_label: ‘USD Coin (USDC)’,
name: ‘USD Coin’,
symbol: ‘USDC’,
decimals: ‘6’,
logo: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
logo_hash: ‘442b80bd16af0c0d9b22e03a16753823fe826e5bfd457292b55fa0ba8c1ba213’,
thumbnail: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
total_supply: ‘25373535439531383’,
total_supply_formatted: ‘25373535439.531383’,
fully_diluted_valuation: ‘25405862477.92’,
block_number: ‘19888348’,
validated: 1,
created_at: ‘2018-08-03T19:28:24.000Z’,
possible_spam: false,
verified_contract: true,
categories: [
‘Exchange-Issued Asset Tokens’,
‘Platform-Based Utility Tokens’,
‘Stablecoins’
],
hyperlinks: {
//…
}
}
]
That’s it! Getting the total provide of a token with Moralis is that straightforward. In the event you’d prefer to study extra about how this works, take a look at our official Token API documentation web page or proceed following alongside on this information.
Additionally, if you wish to leverage our APIs, don’t overlook to enroll with Moralis. You possibly can create an account freed from cost and acquire prompt entry to our premier suite of improvement instruments!
Overview
In at the moment’s article, we are going to start by clarifying what the overall provide of cryptocurrency means. We’ll additionally delve into some great benefits of understanding this metric and talk about widespread use circumstances the place figuring out the overall provide of a token is important. After that, we’ll introduce Moralis – the {industry}’s premier Web3 information supplier. In doing so, you’ll learn to receive the overall provide of a token utilizing Moralis’ Token API via a easy three-step course of:
Get a Moralis API KeyWrite a Script Calling the Token Balances with Costs EndpointExecute the Code
Following this, we’ll additionally spotlight different Moralis APIs that may be helpful when growing decentralized functions (dapps)!
So, for those who’re looking for the best technique to get the total provide of a token, this information is for you. Let’s dive in!
What’s the Whole Provide of a Crypto Token?
The full provide of a cryptocurrency refers back to the variety of cash or tokens that at the moment exist. This consists of tokens actively traded or held in circulation, in addition to these locked and awaiting launch to the general public market. Basically, the overall provide is calculated by subtracting the variety of tokens which were burned or destroyed from the sum of all cash minted!
The full provide of a cryptocurrency includes two main elements:
Circulating Provide: That is the variety of tokens or cash in circulation. It, for example, consists of tokens out there for buying and selling out there. Locked Cash: Though they exist, these tokens aren’t accessible for public buying and selling. A undertaking’s staff might retain a portion of the cash in reserve for strategic functions, equivalent to advertising actions and improvement funding, or designate them for particular initiatives like staking rewards.
This overview ought to offer you a transparent understanding of what the overall provide of a cryptocurrency entails. Now, let’s discover some advantages of this explicit metric!
Why Do You Wish to Get the Full Provide of a Token?
The full provide metric of crypto tokens gives a number of advantages, notably in funding evaluation, financial planning, and market understanding. Listed below are three key examples:
Crypto Valuations: The full provide metric is essential for calculating the valuation of a cryptocurrency. Market capitalization, a central indicator of a coin’s worth, is derived by multiplying the overall provide by the present value of the asset. This helps traders assess the relative dimension and value of various cryptocurrencies. Transparency & Belief: A transparent and immutable document of a token’s complete provide enhances transparency, which is essential for constructing belief amongst traders, customers, regulators, and different stakeholders. Understanding the overall provide ensures all events can confirm the variety of tokens in circulation. Funding Insights: A coin’s complete provide supplies essential insights into its abundance or shortage, that are necessary elements for cryptocurrency traders. Shortage can drive demand, whereas abundance might have an effect on the coin’s long-term value stability.
Token Provide Use Circumstances
On the subject of Web3 improvement, there are lots of cases while you want the overall provide of a cryptocurrency. Listed below are three outstanding use circumstances:
Wallets: Cryptocurrency wallets can show the overall provide to supply context a few person’s holdings. By exhibiting the overall variety of tokens out there, customers can perceive their share in relation to your entire provide, serving to them make knowledgeable selections about their investments. Decentralized Exchanges (DEXs): DEXs show a token’s complete provide to tell buying and selling selections and supply market context. This metric is essential for merchants because it influences methods, liquidity assessments, and general market evaluation. Analytic Platforms: Platforms that monitor cryptocurrency statistics and market behaviors, equivalent to Moralis Cash, use the overall provide of tokens as a core metric of their reporting. This information helps analysts and traders consider a token’s shortage, distribution, and potential worth.
That offers you an summary of what the overall provide of a token entails, the advantages of this metric, and situations wherein this information can come in useful. Within the following half, we’ll present you the simplest approach to get the total provide of a token!
The Best Technique to Get the Full Provide of a Token – Introducing Moralis
The best technique to entry the total provide of a token is to make the most of a Web3 information supplier equivalent to Moralis. At Moralis, we offer a complete array of nodes and cross-chain APIs, facilitating the seamless integration of on-chain information into your initiatives. By leveraging our top-tier improvement instruments, you’ll be able to create dapps extra swiftly and successfully!
So, how are you going to use Moralis to get the total provide of a token?
Moralis supplies extremely complete APIs, delivering extra information with fewer calls. As such, to get the total provide of a token, you solely have to name one in all our ERC-20 endpoints, equivalent to these for balances, metadata, and extra.
To point out you the way this works, let’s take a look at a brief script for fetching the metadata of any ERC-20 token:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.moralis.io/api/v2.2/erc20/metadata?chain=eth&addressespercent5B0percent5D=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
By calling the endpoint above, you’ll obtain, amongst different issues, two essential metrics: total_supply and total_supply_formatted. Right here’s an instance of the output:
[
{
address: ‘0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48’,
address_label: ‘USD Coin (USDC)’,
name: ‘USD Coin’,
symbol: ‘USDC’,
decimals: ‘6’,
logo: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
logo_hash: ‘442b80bd16af0c0d9b22e03a16753823fe826e5bfd457292b55fa0ba8c1ba213’,
thumbnail: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
total_supply: ‘25373535439531383’,
total_supply_formatted: ‘25373535439.531383’,
fully_diluted_valuation: ‘25405862477.92’,
block_number: ‘19888348’,
validated: 1,
created_at: ‘2018-08-03T19:28:24.000Z’,
possible_spam: false,
verified_contract: true,
categories: [
‘Exchange-Issued Asset Tokens’,
‘Platform-Based Utility Tokens’,
‘Stablecoins’
],
hyperlinks: {
//…
}
}
]
That’s it! Getting the total provide of a token is simple when utilizing Moralis!
Nonetheless, if you need an in depth breakdown of easy methods to name our numerous endpoints, be a part of us within the subsequent part as we stroll you thru a complete tutorial on easy methods to get the total provide of a token!
3-Step Tutorial: How one can Get the Full Provide of a Token
Because of the great nature of our API responses, you’ll robotically get the total provide of a token when calling any Moralis ERC-20 endpoint. To exhibit how this works, we’ll present you easy methods to fetch the token balances with costs of any tackle utilizing our Token API in three easy steps:
Get a Moralis API KeyWrite a Script Calling the Token Balances with Costs EndpointRun the Code
Nonetheless, earlier than you may get began with the tutorial, it’s essential to cope with a couple of conditions!
Stipulations
For this tutorial, we’ll be utilizing Node.js and JavaScript. As such, for those who haven’t already, ensure you arrange the next earlier than shifting on to step one:
Guarantee these are put in and able to use!
Step 1: Get a Moralis API Key
To name Moralis’ APIs, you want a Moralis API key. Consequently, the very first thing it’s essential to do is enroll. You possibly can register for a free account by clicking the “Begin for Free” button on the prime proper:
With an account at hand, merely log in and duplicate your Moralis API key:
Be sure you save the important thing, as you’ll want it within the subsequent part!
Step 2: Write a Script Calling the Token Balances with Costs Endpoint
Open your IDE, create a folder, and arrange a brand new undertaking utilizing the next terminal command:
npm init
Set up the required dependencies by working this command in your terminal:
npm set up node-fetch –save
npm set up moralis @moralisweb3/common-evm-utils
Add “kind”: “module” to your “package deal.json” file:
Create a brand new index.js file and add the next code:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.moralis.io/api/v2.2/wallets/0x4B16c5dE96EB2117bBE5fd171E4d203624B014aa/tokens?chain=eth’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
Subsequent, it’s essential to configure the code barely. First, change YOUR_API_KEY with the important thing you copied within the earlier step:
Then, configure the tackle parameter to suit your question:
That’s it for the code. All that is still is to run the script!
Step 3: Run the Code
Open a brand new terminal, navigate to the foundation folder of your undertaking utilizing the cd command, and run this enter to execute the script:
node index.js
In return, you’ll obtain a response containing not solely the balances of the required pockets but in addition every token’s full provide, value, value change over time, and way more. Right here’s an instance of what it’d appear to be:
{
[
{
token_address: ‘0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48’,
symbol: ‘USDC’,
name: ‘USD Coin’,
logo: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
thumbnail: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
decimals: 6,
balance: ‘1000000000000000’,
possible_spam: false,
verified_contract: true,
total_supply: ‘25373535439531383’,
total_supply_formatted: ‘25373535439.531383’,
percentage_relative_to_total_supply: 3.941114167488158,
balance_formatted: ‘1000000000.0’,
usd_price: 1.0007165741842363,
usd_price_24hr_percent_change: 0.04563286892779958,
usd_price_24hr_usd_change: 0.0004564473925958712,
usd_value: 1000716574.1842363,
usd_value_24hr_usd_change: 456447.3925958872,
native_token: false,
portfolio_percentage: 100
},
//…
]
}
Included within the response, you’ll discover each the total_supply and total_supply_formatted parameters for every token:
//…
total_supply: ‘25373535439531383’,
total_supply_formatted: ‘25373535439.531383’,
//…
That’s it. Leveraging Moralis makes it simple to get the total provide of a token!
Past Token Provide – Diving Deeper Into Moralis’ Web3 APIs
Moralis is the {industry}’s main Web3 information supplier. Our premier suite of improvement instruments consists of nodes for all main chains and specialised APIs tailor-made for numerous use circumstances. This consists of the Token API, Pockets API, NFT API, Streams API, and lots of extra. As such, when utilizing Moralis, you’ll be able to construct the whole lot from cryptocurrency wallets to NFT marketplaces with out breaking a sweat!
However what makes our APIs stand out in comparison with the competitors?
One Name – All of the Knowledge: At Moralis, we offer extremely complete APIs, providing you with extra information with fewer calls. Get all the knowledge you want from each on- and off-chain sources in a single response. Cross-Chain: Streamline your developer expertise with actually cross-chain suitable APIs, providing full function parity throughout the largest chains, together with Ethereum, Polygon, BNB Sensible Chain (BSC), and lots of extra. With Moralis, you not want a brand new information supplier for every chain. Enterprise-Grade Safety: Expertise the gold customary for information safety with Moralis. We’re proud to be the {industry}’s solely SOC 2 Sort 2 licensed Web3 infrastructure supplier, guaranteeing top-tier safety on your initiatives.
This offers you a quick overview of Moralis. Let’s now dive a bit deeper into our Web3 API suite!
Moralis’ Web3 APIs
Our suite of APIs consists of over ten use case-specific interfaces, and overlaying all of them on this information can be impractical. As a substitute, we’ll introduce you to a few examples:
Pockets API: The Pockets API is Web3’s premier interface for pockets information. With this instrument, you’ll be able to seamlessly fetch a pockets’s historical past, token balances, web price, profitability, and extra. This makes it the right instrument for constructing wallets, portfolio trackers, and different platforms that require pockets information.
NFT API: The NFT API supplies the whole lot you want when it comes to NFT information. With this API, you’ll be able to effortlessly get NFT balances, metadata, costs, and extra utilizing only a few strains of code. Consequently, that is the last word instrument for constructing NFT marketplaces, Web3 video games, and different NFT-related functions.
Streams API: Moralis’ Streams API is the best instrument for organising Web3 information pipelines. With this industry-leading API, you’ll be able to stream on-chain information into your undertaking’s backend with only a few clicks. It’s good for organising Web3 alerts, populating databases with real-time information, and way more.
For a complete take a look at all our remaining interfaces, please go to our official Web3 API web page!
Abstract: How one can Get the Full Provide of a Token
The simplest and most easy approach to get the total provide of a token is by leveraging a Web3 information supplier like Moralis. At Moralis, we’ve enriched our ERC-20 endpoints with detailed metadata. As such, to get the total provide of a token, you merely have to name one in all our endpoints for balances, metadata, and so on. Right here’s an instance utilizing our token metadata endpoint:
import fetch from ‘node-fetch’;
const choices = {
technique: ‘GET’,
headers: {
settle for: ‘software/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};
fetch(‘https://deep-index.moralis.io/api/v2.2/erc20/metadata?chain=eth&addressespercent5B0percent5D=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48’, choices)
.then(response => response.json())
.then(response => console.log(response))
.catch(err => console.error(err));
If you run the script above, you’ll obtain the metadata of any token, together with the total_supply and total_supply_formatted parameters. Right here’s what the response ought to appear to be:
[
{
address: ‘0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48’,
address_label: ‘USD Coin (USDC)’,
name: ‘USD Coin’,
symbol: ‘USDC’,
decimals: ‘6’,
logo: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
logo_hash: ‘442b80bd16af0c0d9b22e03a16753823fe826e5bfd457292b55fa0ba8c1ba213’,
thumbnail: ‘https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_e6ec22e3ef954a7f9eda04f294938f4d’,
total_supply: ‘25373535439531383’,
total_supply_formatted: ‘25373535439.531383’,
fully_diluted_valuation: ‘25405862477.92’,
block_number: ‘19888348’,
validated: 1,
created_at: ‘2018-08-03T19:28:24.000Z’,
possible_spam: false,
verified_contract: true,
categories: [
‘Exchange-Issued Asset Tokens’,
‘Platform-Based Utility Tokens’,
‘Stablecoins’
],
hyperlinks: {
//…
}
}
]
That’s it! Fetching the total provide of a token doesn’t must be tougher than this when working with Moralis!
If you wish to get the total provide of a token utilizing our APIs, enroll with Moralis. You possibly can create your account without cost, no bank card required, and acquire prompt entry to our premier suite of APIs!
