In at this time’s tutorial, we’ll present you how one can use the {industry}’s #1 crypto worth API – the Moralis Worth API – to fetch an asset’s real-time and historic worth. We’ll additionally briefly present you how one can make batch requests to fetch the costs of a number of belongings concurrently. For those who’re desperate to get going, then listed below are three fast examples of the way it works:
- Fetch Actual-Time Costs
With a single API name to thegetTokenPrice()
endpoint, you may seamlessly fetch the real-time worth of an asset:
import Moralis from 'moralis'; strive { await Moralis.begin({ apiKey: "YOUR_API_KEY" }); const response = await Moralis.EvmApi.token.getTokenPrice({ "chain": "0x1", "handle": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0" }); console.log(response.uncooked); } catch (e) { console.error(e); }
- Get Historic Costs
By specifying thetoBlock
parameter when calling thegetTokenPrice()
endpoint, you may effortlessly get the worth of an asset at a given cut-off date:
import Moralis from 'moralis'; strive { await Moralis.begin({ apiKey: "YOUR_API_KEY" }); const response = await Moralis.EvmApi.token.getTokenPrice({ "chain": "0x1", "toBlock": 18085987, "handle": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0" }); console.log(response.uncooked); } catch (e) { console.error(e); }
- Make Batch Requests
You may make batch requests by passing an array of addresses to get the worth of a number of tokens in a single response:
// Dependencies to put in: // $ npm set up node-fetch --save // add "sort": "module" to package deal.json import fetch from 'node-fetch'; const choices = { technique: 'POST', headers: { settle for: 'utility/json', 'content-type': 'utility/json', 'X-API-Key': 'YOUR_API_KEY' }, physique: JSON.stringify({ "tokens": [ { "token_address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84", "to_block": 16314545 } ] }) }; fetch('https://deep-index.moralis.io/api/v2.2/erc20/costs?chain=eth&embody=percent_change', choices) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
Getting worth information with the Moralis Worth API has by no means been simpler. By familiarizing your self with this API, you may spin up Web3 purposes very quickly. You may as well study extra concerning the use circumstances above by testing the official Moralis Worth API documentation.
Additionally, don’t overlook to enroll with Moralis instantly so you can begin leveraging the complete energy of the blockchain {industry} at this time!
Overview
We’ll kickstart at this time’s article by exploring the intricacies of crypto worth APIs. From there, we’ll look nearer at why you would possibly want a worth API for cryptocurrency within the first place. Subsequent, we’re going to cowl some distinguished crypto worth API use circumstances. In doing so, we’ll introduce the Moralis Worth API and present you how one can use this device to fetch worth information. Extra particularly, we’ll present you how one can:
- Fetch real-time worth information
- Get historic token costs
- Make batch requests
So, in case you are already acquainted with the ins and outs of crypto worth APIs, be happy to skip to the ”Crypto Worth API Use Circumstances” part and get straight into the code!
In any other case, be a part of us within the following part as we take a look at what a crypto worth API is!
What’s a Crypto Worth API?
Cross-system communication is crucial when constructing purposes and web sites, as they don’t work optimally in isolation in at this time’s interconnected world. As such, builders want environment friendly methods to allow decoupled software program techniques to speak with each other. Fortuitously, that is exactly the place APIs enter the equation.
However what precisely is an API? And the way do they work within the context of Web3 growth?
A crypto API, quick for utility programming interface, is a algorithm, protocols, and strategies permitting you to seamlessly work together with blockchain networks and combine crypto-related performance into your purposes, software program, and web sites. They supply a structured approach to entry information and carry out actions associated to blockchain networks, cryptocurrencies, and decentralized purposes (dapps).
A crypto worth API is a selected sort of interface specializing in worth information, and it lets you seamlessly entry real-time and historic costs for varied cryptocurrencies, like ETH (Ethereum), BTC (Bitcoin), and so forth.
All in all, crypto worth APIs make the method of querying blockchain networks for pricing information simple. Moreover, they play an integral function within the Web3 growth house, making your job as a developer considerably extra accessible!
Why Do You Want a Dwell Crypto Worth API?
It doesn’t matter if you happen to plan to construct a decentralized change (DEX) or the subsequent MetaMask; you’ll nearly all the time have to combine pricing information when constructing Web3 initiatives. And by leveraging a crypto worth API, it can save you an abundance of time and growth sources!
Querying blockchain networks is a tedious process, and if you happen to’re doing it from scratch, it may shortly change into a time-consuming course of. So, as an alternative of “reinventing the wheel”, you may merely use a crypto worth API to get real-time and historic worth information with a couple of strains of code. That means, you may allocate your time and sources towards extra important duties like serving your finish customers.
By leveraging a crypto worth API, you’ll immediately achieve a aggressive benefit and might transfer to market a lot faster than your opponents!
Crypto Worth API Use Circumstances
With an outline of what crypto worth APIs are and why you want them, let’s now discover the {industry}’s main interface: the Moralis Worth API. The API provided by Moralis has a number of use circumstances, and within the following sections, we’ll cowl three distinguished examples:
- Fetch real-time costs
- Get historic worth information
- Make batch requests
Nevertheless, earlier than we present you how one can use the Moralis Worth API to fetch real-time token costs, you initially have to take care of a few stipulations!
Stipulations
Earlier than you get began with the free crypto Worth API from Moralis, you initially have to have the next put in:
- Node v.14+ or Python
- NPM/Yarn or Pip
You additionally have to register with Moralis to get your API key. As such, if you happen to haven’t already, hit the ”Begin for Free” button on the prime proper on Moralis‘ homepage:
When you’ve arrange your account, go to the ”Web3 APIs” tab and hit the ”Get your API keys” button:
With the API key at your disposal, you additionally have to run the next command within the root folder of your mission to put in the Moralis SDK:
npm set up moralis @moralisweb3/common-evm-utils
Now that’s it; you at the moment are prepared to start out utilizing the Moralis Worth API to fetch worth information! So, with out additional ado, let’s soar straight into the primary use case and present you how one can fetch real-time costs utilizing the {industry}’s main worth API for crypto!
Fetch Actual-Time Costs
With the Moralis Worth API, you may effortlessly question the real-time worth of any ERC-20 token. All it requires is a single API name, and right here’s an instance of what it would seem like:
import Moralis from 'moralis'; strive { await Moralis.begin({ apiKey: "YOUR_API_KEY" }); const response = await Moralis.EvmApi.token.getTokenPrice({ "chain": "0x1", "handle": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0" }); console.log(response.uncooked); } catch (e) { console.error(e); }
When you run the code above, you’ll get a response trying one thing like this:
{ "tokenName": "Matic Token", "tokenSymbol": "MATIC", "tokenLogo": "https://cdn.moralis.io/eth/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0.png", "tokenDecimals": "18", "nativePrice": { "worth": "332947305392970", "decimals": 18, "identify": "Ether", "image": "ETH", "handle": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "usdPrice": 0.5423105104030737, "usdPriceFormatted": "0.5423105104030737", "exchangeAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984", "exchangeName": "Uniswap v3", "tokenAddress": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0" }
By merely passing the chain and contract handle as parameters when calling the getTokenPrice()
endpoint, you’ll get the token’s real-time worth denominated in each the native cryptocurrency of the chain and USD.
Word: Don’t overlook to exchange YOUR_API_KEY
together with your precise Moralis API key.
Get Historic Worth Information
Along with fetching the real-time worth of a token, you may simply as simply use the Moralis Worth API to question the worth at any given cut-off date. To take action, you merely have to enter a timestamp or a block quantity, and the crypto Worth API from Moralis takes care of the remaining!
So, how does it work?
To get the historic worth of a token, you may merely use the getTokenPrice()
endpoint as soon as once more. Nevertheless, this time, it’s essential to specify the toBlock
parameter. Right here’s an instance of what it may seem like:
import Moralis from 'moralis'; strive { await Moralis.begin({ apiKey: "YOUR_API_KEY" }); const response = await Moralis.EvmApi.token.getTokenPrice({ "chain": "0x1", "toBlock": 18085987, "handle": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0" }); console.log(response.uncooked); } catch (e) { console.error(e); }
In return, you’ll get a response trying one thing like this:
{ "tokenName": "Matic Token", "tokenSymbol": "MATIC", "tokenLogo": "https://cdn.moralis.io/eth/0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0.png", "tokenDecimals": "18", "nativePrice": { "worth": "338661989977717", "decimals": 18, "identify": "Ether", "image": "ETH", "handle": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "usdPrice": 0.5535986848542233, "usdPriceFormatted": "0.5535986848542233", "exchangeAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984", "exchangeName": "Uniswap v3", "tokenAddress": "0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0", "toBlock": "18085987" }
As soon as once more, you get the worth denominated in each the chain’s native token in addition to USD. Nevertheless, this time, it’s the worth from the desired timestamp/block quantity.
Word: Don’t overlook to exchange YOUR_API_KEY
together with your precise Moralis API key.
Make Batch Requests
Lastly, with the Moralis Worth API, you can also make batch requests to fetch the worth of a number of tokens concurrently and in a single response. To take action, you merely have to specify an array of token addresses, and right here’s an instance of what it would seem like:
// Dependencies to put in: // $ npm set up node-fetch --save // add "sort": "module" to package deal.json import fetch from 'node-fetch'; const choices = { technique: 'POST', headers: { settle for: 'utility/json', 'content-type': 'utility/json', 'X-API-Key': 'YOUR_API_KEY' }, physique: JSON.stringify({ "tokens": [ { "token_address": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84", "to_block": 16314545 } ] }) }; fetch('https://deep-index.moralis.io/api/v2.2/erc20/costs?chain=eth&embody=percent_change', choices) .then(response => response.json()) .then(response => console.log(response)) .catch(err => console.error(err));
In return, you’ll obtain an array containing token costs denominated within the blockchain’s native forex and USD. Right here’s an instance response:
[ { "tokenName": "stETH", "tokenSymbol": "stETH", "tokenLogo": "https://cdn.moralis.io/eth/0xae7ab96520de3a18e5e111b5eaab095312d7fe84.png", "tokenDecimals": "18", "nativePrice": { "value": "985900938416575600", "decimals": 18, "name": "Ether", "symbol": "ETH", "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2" }, "usdPrice": 1183.2332106724853, "usdPriceFormatted": "1183.2332106724853", "24hrPercentChange": "-27.08746487985908", "exchangeAddress": "0x1f98431c8ad98523631ae4a59f267346ea31f984", "exchangeName": "Uniswap v3", "tokenAddress": "0xae7ab96520de3a18e5e111b5eaab095312d7fe84", "toBlock": "16314545" } ]
That’s it; when working with the Moralis Worth API, it doesn’t must be extra complicated than that to fetch present and historic token costs!
Word: Don’t overlook to exchange YOUR_API_KEY
together with your precise Moralis API key.
Why Use the Moralis Crypto Worth API?
Together with the use circumstances above, there are a number of extra the reason why it’s best to go for the Moralis Worth API for crypto. To focus on why, we’ll take a look at some advantages and benefits of Moralis’ industry-leading crypto Worth API on this part!
- Costs for All Tokens: In case you have had sufficient of awful protection and lacking tokens, then you definitely’ll wish to begin utilizing the Moralis Worth API. With this API, cash present up instantaneously as they begin buying and selling on any DEX. We monitor each new coin and liquidity pool to provide the newest worth information as quickly because it turns into obtainable. There are not any approval processes and no gatekeeping!
- Assist for All Main EVM Chains: The Moralis Worth API helps all main EVM chains and a number of DEXs. Some distinguished examples embody QuickSwap, Camelot, Uniswap, TraderJoe, and lots of others. Consequently, the Moralis Worth API is the one worth API it’s essential to construct your Web3 initiatives!
Now, how does Moralis examine to different crypto worth API suppliers?
The Moralis Crypto Worth API vs. Different Options
With protection starting from the smallest and latest cash to essentially the most well-established cryptocurrencies, Moralis offers essentially the most complete API in the marketplace. Moreover, the Moralis crypto Worth API is the {industry}’s premier possibility by any metric, together with options, aggressive pricing, and velocity!
As an illustration, right here’s a comparability with opponents like CoinMarketCap and CoinGecko:
So, if you happen to’re planning to construct a Web3 mission the place you want worth information, create your free Moralis account at this time and begin leveraging the true energy of blockchain know-how!
Past the Crypto Worth API
The Worth API for crypto is simply the tip of the iceberg, and there’s much more to Moralis. Moreover, the free crypto Worth API works like a allure along with the opposite interfaces in Moralis’ Web3 API suite. As such, if you happen to’re critical about constructing Web3 initiatives, take into account checkout out a few of our different merchandise:
- Pockets API: The right API for constructing Web3 wallets.
- Token API: A robust out-of-the-box resolution for fetching ERC-20 token information in actual time.
- Steadiness API: Get the token stability for any person pockets.
- DeFi API: Fetch pair and liquidity reserve information throughout a number of blockchain networks.
- Transaction API: Get detailed transactions and log information in a heartbeat.
Moralis’ Multi-Chain Compatibility
Do you know you don’t restrict your self to at least one blockchain community when working with Moralis? Moralis helps chain-agnostic constructing, that means you may construct Web3 initiatives and dapps throughout the most well-liked blockchain networks. Some distinguished examples embody Ethereum, BNB Good Chain, Polygon, Avalanche, and lots of others.
The Moralis workforce is working onerous day by day on including new networks and integrations. As such, you may anticipate extra blockchain networks and much more cross-chain compatibility sooner or later!
Abstract: Free Crypto Worth API
We kickstarted at this time’s article by exploring the ins and outs of worth APIs for crypto. In doing so, we discovered {that a} crypto worth API is a algorithm, strategies, and protocols enabling you to effortlessly work together with and combine blockchain-related performance into your initiatives.
From there, we launched the Moralis Worth API for crypto. Moreover, we demonstrated how one can fetch real-time token costs, get historic token costs, and make batch requests! Consequently, when you have adopted alongside this far, you now know how one can use the Moralis Worth API to fetch the information it’s essential to construct extra refined Web3 initiatives!
If that is your ambition, be happy to take a look at some extra content material right here on the Web3 weblog. As an illustration, discover ways to create a blockchain explorer or dive into Web3 market growth.
Additionally, if you happen to haven’t already, be sure that to enroll with Moralis. You possibly can create your account free of charge to get fast entry to the assorted APIs. With these instruments, you can begin leveraging the complete energy of Web3 know-how right away!