With the Web3 market’s main NFT API and EVM API from Moralis, you may get all transfers of an NFT seamlessly. All you have to do is set up the Moralis SDK and name the ”getNFTTransfers” endpoint! Principally, by including a token tackle, the token ID, and the chain to the code snippet under, you cowl the central code to get all transfers of an NFT:
const response = await Moralis.EvmApi.nft.getNFTTransfers({
tackle,
tokenId,
chain,
});
Calling the ”getNFTTransfers” endpoint returns all transfers related to the token tackle and shops them within the ”response” object. From there, it’s as much as you to make use of this info creatively in your Web3 improvement endeavors. That stated, for extra detailed info on calling this endpoint, take a look at the documentation web page on get all transfers of a non-fungible token. In any other case, be part of us on this tutorial as we present you this works in observe!
Easy methods to Get All Transfers of an NFT – Overview
In case you are seeking to construct an NFT market, worth estimator, analytics platform, or every other NFT-related platform, you’ll quickly understand that you simply require on-chain knowledge. An excellent instance is the switch information of NFTs, which you, amongst different issues, would possibly wish to show to enhance the consumer expertise. Nevertheless, querying this info has been fairly cumbersome from a traditional perspective. Fortuitously for you, that is now not the case, due to Moralis’ NFT API. If you wish to study extra about how this works, keep caught in as we present you get all transfers of an NFT with Moralis!
First, let’s return to fundamentals and discover precisely what an NFT is. From there, we’ll clarify why you will need to get the switch historical past of an NFT. Nevertheless, in case you are already acquainted with this, you may skip straight into the ”Tutorial: Easy methods to Get All Transfers of an NFT in 3 Steps” part. In that half, we illustrate get all transfers of an NFT within the following three simple steps:
PrerequisitesCall Moralis’ ”getNFTTransfers” EndpointRun the Program
What’s extra, the device you’ll familiarize your self with throughout this tutorial is just one of Moralis’ Web3 APIs. In case you are critical about entering into blockchain improvement, you need to take into account testing different instruments from Moralis. An excellent instance is the Streams API, permitting you to stream on-chain knowledge into your initiatives’ backends through Moralis webhooks!
Now, earlier than you progress additional on this article, join with Moralis instantly, as you will need to have an account to comply with alongside within the upcoming tutorial!
What’s an NFT?
Earlier than displaying you get all transfers of an NFT, this preliminary part explores the intricacies of those tokens. By doing so, you obtain an summary of what they’re, which helps in understanding why it’s important for builders to entry info related to NFTs. So, with out additional ado, let’s reply the query, ”what’s an NFT?”.
NFTs is an abbreviation for ”non-fungible tokens”, and to grasp what they’re, a wonderful place to start out is to investigate the terminology. The time period ”non-fungible” originates from conventional economics and describes items, gadgets, and property with distinctive properties. As an illustration, a portray is non-fungible, as artwork items are usually one-of-a-kind. Based mostly on this definition, NFTs are distinctive, one-of-a-kind cryptocurrency tokens.
To make the outline above much more comprehensible, let’s discover the opposite facet of the spectrum: fungible property. Since non-fungible property are distinctive, it signifies that fungible property are interchangeable.
Within the blockchain world, a transparent instance of a fungible asset is Bitcoin. All Bitcoin tokens are similar, suggesting that one could be swapped for one more with out financial compensation as they’ve the identical worth. The identical can’t be stated for NFTs. Why? As a result of these tokens have distinctive properties, one may not share the identical worth as one other.
Since NFTs are non-fungible tokens, their uniqueness makes them supreme for representing just about every other non-fungible property. Consequently, that is why many individuals affiliate NFTs with digital artwork. Nevertheless, be aware that NFTs usually don’t ”comprise” an asset like a digital artwork piece however fairly level to a non-fungible asset of their metadata, offering proof of possession.
However, with a quick introduction to NFTs, allow us to now discover why you will need to get the switch histories of those tokens!
Why is it Vital to Get the Switch Historical past of an NFT?
Anybody can question a blockchain community for info, such because the transaction historical past of an NFT. However why is it necessary for builders to get all transfers of an NFT?
Let’s say you wish to construct a market akin to OpenSea, an NFT analytics platform, or an NFT worth estimator. In these cases, you may extremely profit from the power to get all transfers of an NFT. With this info, you may create a extra compelling consumer expertise (UX) by, amongst different issues, displaying an NFT’s transaction historical past straight in your app’s consumer interface (UI). In consequence, your customers can keep away from querying the blockchain themselves and make knowledgeable selections primarily based on this knowledge.
You may additionally wish to use this knowledge to calculate common costs, worth developments, and rather more. Accordingly, this knowledge could be extremely helpful in your Web3 improvement endeavors. That stated, it’s equally necessary that builders have easy accessibility to this on-chain knowledge, which is the place Moralis enters the image!
You possibly can question a blockchain for on-chain NFT knowledge in a number of methods, however it usually requires a large period of time and engineering sources. Nevertheless, with Moralis’ NFT API and the ”getNFTTransfers” endpoint, you may get all transfers of an NFT with only some traces of code.
If you wish to study extra about this, be part of us within the following part, the place we offer a complete tutorial on get all transfers of an NFT in three steps!
Tutorial: Easy methods to Get All Transfers of an NFT in 3 Steps
Now that you’ve got familiarized your self with NFTs and have a extra profound understanding of why it’s important to get all transfers of an NFT, this part will present you purchase this knowledge. To make this course of extra seamless, we use Moralis’ NFT API to make a single name to the ”getNFTTransfers” endpoint.
All you have to do is provide a contract tackle, token ID, and the chain you have an interest in. In flip, you obtain a response if the type of an array containing all transfers related to the required tackle. You’ll additionally obtain extra knowledge relating to every transaction, such because the block quantity, transaction hash, contract sort, and rather more!
What’s extra, via this Moralis device, you may get all transfers of an NFT in solely three steps:
PrerequisitesCall Moralis’ ”getNFTTransfers” EndpointRun the Program
By following the steps above, you may get all transfers of an NFT very quickly. If this sounds thrilling, be part of us as we kickstart this tutorial by masking the required conditions!
Step 1: Conditions
Earlier than we dive into the script we use to get all transfers of an NFT, you have to cope with a couple of conditions. First, you will need to guarantee that you’ve got each NodeJS and npm prepared. So, in case you shouldn’t have them already, go to the next webpage and obtain the newest model of NodeJS: “https://nodejs.dev/en/obtain/“.
From there, the following prerequisite is to enroll with Moralis. Organising your account is free and solely takes a couple of seconds! So, create your account instantly.
Nevertheless, you would possibly surprise, ”why do I would like a Moralis account?”. In an effort to make API calls to any of Moralis’ endpoints, together with ”getNFTTransfers”, you require an API key, which is why you have to be a member of Moralis. After getting joined, you will discover your key by logging in and navigating to the ”Web3 APIs” web page:
You possibly can go forward and replica the important thing instantly by clicking on the “copy” button:
Save the important thing for now, as you will have it within the second step.
However, that covers the conditions! Let’s bounce straight into the second step, the place we present you add the code for calling the ”getNFTTransfers” endpoint!
Step 2: Name Moralis’ ”getNFTTransfers” Endpoint
On this second step, we are going to present you the code we use to get all transfers of an NFT by calling the ”getNFTTransfers” endpoint. To start with, open your built-in improvement surroundings (IDE) and arrange a brand new JavaScript challenge. From there, create a brand new ”index.js” file and add the next contents:
const Moralis = require(‘moralis’).default;
const { EvmChain } = require(‘@moralisweb3/common-evm-utils’);
const runApp = async () => {
await Moralis.begin({
apiKey: “YOUR_API_KEY”,
// …and every other configuration
});
const tackle=”0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d”;
const tokenId = 1;
const chain = EvmChain.ETHEREUM;
const response = await Moralis.EvmApi.nft.getNFTTransfers({
tackle,
tokenId,
chain,
});
console.log(response.toJSON());
}
runApp();
Above, you will discover the entire code to get all transfers from an NFT. Nevertheless, you have to make a couple of configurations earlier than working this program. First, you will need to add your API key to the code by changing ”YOUR_API_KEY”. Subsequent, you have to take into account the ”tackle”, ”tokenId”, and ”chain” variables.
Within the code snippet above, we added default values to those three variables. As such, you have to enter the token tackle of the NFT you wish to question. Furthermore, you additionally want to alter the token ID and chain to suit the token accordingly.
The code then makes use of these three variables as parameters when calling the ”getNFTTransfers” endpoint. The outcomes returned are then saved within the ”response” object, which is lastly console-logged. As soon as you’re happy together with your configurations, all that continues to be is working the code. We’ll present you the way to take action within the last step!
Step 3: Run the Program
On this final step of the ”Easy methods to Get All Transfers of an NFT” tutorial, we are going to present you run the code and take a look at what the responses seem like. Nevertheless, earlier than doing so, you have to open a brand new terminal and set up the Moralis SDK in your challenge utilizing the npm command under:
npm set up moralis @moralisweb3/common-evm-utils
From there, all that continues to be to execute this system is working the next terminal enter:
node index.js
When you run the command above, this system will log the ends in the console. Accordingly, you need to obtain a response just like the one proven under:
{
“complete”: 2,
“web page”: 0,
“page_size”: 100,
“cursor”: null,
“end result”: [
{
“block_number”: “12344148”,
“block_timestamp”: “2021-04-30T21:11:46.000Z”,
“block_hash”: “0xa367b094366bc68de295ae6167797afc55eeb8383869363a6d7eb143c31d8274”,
“transaction_hash”: “0xe93e858f9330afa4581e260198195623aa7f5cd2809012440ea291d317be9f2f”,
“transaction_index”: 154,
“log_index”: 328,
“value”: “0”,
“contract_type”: “ERC721”,
“transaction_type”: “Single”,
“token_address”: “0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d”,
“token_id”: “1”,
“from_address”: “0xaba7161a7fb69c88e16ed9f455ce62b791ee4d03”,
“to_address”: “0x46efbaedc92067e6d60e84ed6395099723252496”,
“amount”: “1”,
“verified”: 1,
“operator”: null
},
In the code snippet, we only included information regarding one of the transfers. However, as you can see from the ”total” parameter at the very top, there are two transfers in total. Moreover, every transaction is returned to you in the ”results” array, and you will receive the same information regarding all NFT transfers associated with the token address provided.
As such, you get parsed data such as the block number, block hash, ”to” and ”from” addresses, and much more. From here, you can use this information directly in your Web3 projects to, among other things, improve the user experience!
That covers the entirety of this tutorial. If you want more information about this process, check out the documentation page on how to get all transfers of a non-fungible token!
Summary – Get All Transfers of an NFT
If you want to create NFT-related projects, you will quickly come to realize that you can highly benefit from accessing real-time on-chain data. For instance, if you want to create an NFT marketplace, you can improve the UX by displaying the transaction history of NFTs directly in your app’s UI. However, getting this information has been quite difficult from a traditional perspective. Fortunately, this is no longer the case, thanks to Web3 infrastructure providers such as Moralis!
This tutorial taught you how to get all transfers of an NFT using Moralis. Thanks to Moralis’ NFT API and the ”getNFTTransfers” endpoint, you were able to do so in only three quick steps:
PrerequisitesCall Moralis’ ”getNFTTransfers” EndpointRun the Program
If you found this tutorial helpful, you might want to learn more about Moralis’ NFT API. If this is the case, check out our articles on how to get NFT collection data or get all NFTs from a contract! In addition, if you’re interested in storage solutions, explore metadata for NFT storage in Moralis’ NFT metadata article!
Nevertheless, no matter what on-chain NFT data you want to query, sign up with Moralis to access a more seamless developer experience. With an account, you can fully leverage the power of blockchain technology in all future development endeavors!
