How to Get the Full Supply of a Token - Moralis Web3

Are you on the lookout for the best solution to get the complete provide of a token? In that case, you’re in the correct place. This information will present you the best way to effortlessly entry the complete provide of a token utilizing Moralis – the {industry}’s main Web3 information supplier. At Moralis, we’ve got enriched our ERC-20 endpoints with in-depth metadata, making certain you routinely obtain the complete 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: ‘utility/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 desired token, together with two central parameters: total_supply and total_supply_formatted. Right here’s an instance of what it seems 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 complete provide of a token with Moralis is that easy. In the event you’d wish to be taught 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 neglect to enroll with Moralis. You’ll be able to create an account freed from cost and acquire instantaneous entry to our premier suite of improvement instruments!

Overview

In at present’s article, we’ll start by clarifying what the overall provide of cryptocurrency means. We’ll additionally delve into the benefits of understanding this metric and talk about widespread use instances the place realizing the overall provide of a token is crucial. After that, we’ll introduce Moralis – the {industry}’s premier Web3 information supplier. In doing so, you’ll discover ways 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 creating decentralized purposes (dapps)!

So, should you’re in search of the best technique to get the complete provide of a token, this information is for you. Let’s dive in!

What’s the Whole Provide of a Crypto Token?

The whole provide of a cryptocurrency refers back to the variety of cash or tokens that at present 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 have been burned or destroyed from the sum of all cash minted!

The whole provide of a cryptocurrency contains two main elements:

Circulating Provide: That is the variety of tokens or cash in circulation. It, as an example, consists of tokens obtainable for buying and selling out there. Locked Cash: Though they exist, these tokens aren’t accessible for public buying and selling. A venture’s workforce could retain a portion of the cash in reserve for strategic functions, akin to advertising actions and improvement funding, or designate them for particular initiatives like staking rewards.

This overview ought to provide you with 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 Need to Get the Full Provide of a Token?

The whole provide metric of crypto tokens presents a number of advantages, notably in funding evaluation, financial planning, and market understanding. Listed here are three key examples:

Crypto Valuations: The whole 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 worth of the asset. This helps traders assess the relative measurement 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. Realizing the overall provide ensures all events can confirm the variety of tokens in circulation. Funding Insights: A coin’s complete provide offers essential insights into its abundance or shortage, that are vital elements for cryptocurrency traders. Shortage can drive demand, whereas abundance could have an effect on the coin’s long-term worth stability.

Token Provide Use Instances

In the case of Web3 improvement, there are various cases whenever you want the overall provide of a cryptocurrency. Listed here are three outstanding use instances:

Wallets: Cryptocurrency wallets can show the overall provide to offer context a couple of consumer’s holdings. By exhibiting the overall variety of tokens obtainable, customers can perceive their share in relation to all the provide, serving to them make knowledgeable choices about their investments. Decentralized Exchanges (DEXs): DEXs show a token’s complete provide to tell buying and selling choices 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, akin 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 outline of what the overall provide of a token entails, the advantages of this metric, and eventualities through which this information can turn out to be useful. Within the following half, we’ll present you the best solution to get the complete provide of a token!

The Best Technique to Get the Full Provide of a Token – Introducing Moralis

The only technique to entry the complete provide of a token is to make the most of a Web3 information supplier akin 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 tasks. By leveraging our top-tier improvement instruments, you possibly can create dapps extra swiftly and successfully!

So, how will you use Moralis to get the complete provide of a token?

Moralis offers extremely complete APIs, delivering extra information with fewer calls. As such, to get the complete provide of a token, you solely must name one in every of our ERC-20 endpoints, akin to these for balances, metadata, and extra.

To point out you ways 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: ‘utility/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};

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:

That’s it! Getting the complete provide of a token is simple when utilizing Moralis!

Nevertheless, if you need an in depth breakdown of the best way to name our numerous endpoints, be part of us within the subsequent part as we stroll you thru a complete tutorial on the best way to get the complete provide of a token!

3-Step Tutorial: How you can Get the Full Provide of a Token

Because of the excellent nature of our API responses, you’ll routinely get the complete provide of a token when calling any Moralis ERC-20 endpoint. To display how this works, we’ll present you the best way to fetch the token balances with costs of any handle utilizing our Token API in three easy steps:

Get a Moralis API KeyWrite a Script Calling the Token Balances with Costs EndpointRun the Code

Nevertheless, earlier than you will get began with the tutorial, it is advisable cope with a number of stipulations!

Conditions

For this tutorial, we’ll be utilizing Node.js and JavaScript. As such, should you haven’t already, be sure to arrange the next earlier than transferring 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 is advisable do is join. You’ll be able to register for a free account by clicking the “Begin for Free” button on the high proper:

With an account at hand, merely log in and replica your Moralis API key:

Be sure to 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 venture utilizing the next terminal command:

npm init

Set up the required dependencies by operating this command in your terminal:

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

Add “sort”: “module” to your “bundle.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: ‘utility/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 is advisable configure the code barely. First, change YOUR_API_KEY with the important thing you copied within the earlier step:

Then, configure the handle parameter to suit your question:

That’s it for the code. All that continues to be is to run the script!

Step 3: Run the Code

Open a brand new terminal, navigate to the basis folder of your venture 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 desired pockets but additionally every token’s full provide, worth, worth change over time, and rather 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 straightforward to get the complete 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 instances. This consists of the Token API, Pockets API, NFT API, Streams API, and plenty of extra. As such, when utilizing Moralis, you possibly can construct every thing 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 data you want from each on- and off-chain sources in a single response. Cross-Chain: Streamline your developer expertise with really cross-chain appropriate APIs, providing full characteristic parity throughout the most important chains, together with Ethereum, Polygon, BNB Good Chain (BSC), and plenty of extra. With Moralis, you now not want a brand new information supplier for every chain. Enterprise-Grade Safety: Expertise the gold normal for information safety with Moralis. We’re proud to be the {industry}’s solely SOC 2 Sort 2 licensed Web3 infrastructure supplier, making certain top-tier safety to your tasks.

This provides 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 protecting all of them on this information could 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 device, you possibly can seamlessly fetch a pockets’s historical past, token balances, internet price, profitability, and extra. This makes it the right device for constructing wallets, portfolio trackers, and different platforms that require pockets information.

NFT API: The NFT API offers every thing you want by way of NFT information. With this API, you possibly can effortlessly get NFT balances, metadata, costs, and extra utilizing only a few traces of code. Consequently, that is the final word device for constructing NFT marketplaces, Web3 video games, and different NFT-related purposes.

Streams API: Moralis’ Streams API is the perfect device for establishing Web3 information pipelines. With this industry-leading API, you possibly can stream on-chain information into your venture’s backend with only a few clicks. It’s excellent for establishing Web3 alerts, populating databases with real-time information, and rather more.

For a complete take a look at all our remaining interfaces, please go to our official Web3 API web page!

Abstract: How you can Get the Full Provide of a Token

The best and most simple solution to get the complete provide of a token is by leveraging a Web3 information supplier like Moralis. At Moralis, we’ve got enriched our ERC-20 endpoints with detailed metadata. As such, to get the complete provide of a token, you merely must name one in every of 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: ‘utility/json’,
‘X-API-Key’: ‘YOUR_API_KEY’
},
};

While 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:

That’s it! Fetching the complete provide of a token doesn’t should be tougher than this when working with Moralis!

If you wish to get the complete provide of a token utilizing our APIs, join with Moralis. You’ll be able to create your account without spending a dime, no bank card required, and acquire instantaneous entry to our premier suite of APIs!

Source link