At this time’s article will present you methods to get a person’s NFT tokens checklist with the Moralis NFT API. Due to the facility of this software, you solely want a single API name to the getWalletNFTs() endpoint to take action. Under, you could find the code exhibiting an instance of the way it works in observe:
const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");
const runApp = async () => {
await Moralis.begin({
apiKey: "YOUR_API_KEY",
// ...and another configuration
});
const deal with = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045";
const chain = EvmChain.ETHEREUM;
const response = await Moralis.EvmApi.nft.getWalletNFTs({
deal with,
chain,
});
console.log(response.toJSON());
};
runApp();
You merely want so as to add your Moralis API key, configure the deal with and chain parameters, and execute the code. In return, you’ll obtain a response containing an array of NFTs. And it may well look one thing like this:
{
"complete": 1456,
"web page": 1,
"page_size": 100,
"cursor": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21QYXJhbXMiOnsid2FsbGV0QWRkcmVzcyI6IjB4ZDhkYTZiZjI2OTY0YWY5ZDdlZWQ5ZTAzZTUzNDE1ZDM3YWE5NjA0NSJ9LCJrZXlzIjpbIjE2NjMyMzgxNzUuMDc3Il0sIndoZXJlIjp7Im93bmVyX29mIjoiMHhkOGRhNmJmMjY5NjRhZjlkN2VlZDllMDNlNTM0MTVkMzdhYTk2MDQ1In0sImxpbWl0IjoxMDAsIm9mZnNldCI6MCwib3JkZXIiOltdLCJ0b3RhbCI6MTQ1NiwicGFnZSI6MSwidGFpbE9mZnNldCI6MSwiaWF0IjoxNjY2NjgyNTUyfQ.E5DkWYvRTaFnVhgedRuT3IW-rb2V-ikFKwP2cg2Qf78",
"end result": [
{
"token_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
"token_id": "4765809967066625256798886812262830659450023020194524584471225959000376492819",
"amount": "1",
"owner_of": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"token_hash": "ba6d44b5f16be94283cecffeb784b7ca",
"block_number_minted": "15572796",
"block_number": "15573017",
"contract_type": "ERC721",
"name": "Ethereum Name Service",
"symbol": "ENS",
"token_uri": null,
"metadata": null,
"last_token_uri_sync": null,
"last_metadata_sync": "2022-09-20T06:06:08.153Z",
"minter_address": null
},
{
"token_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
"token_id": "84453794918345416145331514647027903846664455083247396107154093349515123913389",
"amount": "1",
"owner_of": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"token_hash": "7c0212cd3daf1b6b64f193c6dc102fb4",
"block_number_minted": "15572811",
"block_number": "15573017",
"contract_type": "ERC721",
"name": "Ethereum Name Service",
"symbol": "ENS",
"token_uri": null,
"metadata": null,
"last_token_uri_sync": null,
"last_metadata_sync": "2022-09-20T06:09:09.838Z",
"minter_address": null
}
],
"standing": "SYNCED"
}
To study extra about how this works, be a part of us on this article as we break down the method in additional element. Or try our official get NFTs by pockets documentation!
Additionally, earlier than we proceed, don’t neglect to join free with Moralis to entry the {industry}’s main NFT API. In doing so, you can begin leveraging the total energy of the Web3 {industry} instantly and construct your subsequent NFT undertaking in a heartbeat!
Overview
It doesn’t matter should you’re constructing a Web3 pockets, NFT market, or a blockchain-based gaming platform; chances are high you’ll have to fetch all NFT tokens owned by your customers. Nonetheless, to get a person NFT tokens checklist on a blockchain like Ethereum, you would need to parse the whole community, monitor ERC-721 sensible contracts, and get the newest possession knowledge for every token. This requires an enormous quantity of engineering time and assets. Happily, now you can bypass this by leveraging the Moralis NFT API. As an instance the facility of this software, we’ll take at the moment’s article to indicate you methods to get all tokens owned by a person deal with!
Nonetheless, earlier than we dive into the primary subject, we’ll kick issues off by taking a look at what an NFT API is. From there, we’ll introduce the Moralis NFT API to spotlight why that is the very best software to get a person NFT tokens checklist. After that, we’ll bounce straight into the tutorial and present you methods to get all NFT tokens owned by a person deal with in three steps:
- Step 1: Arrange Moralis
- Step 2: Name the
getWalletNFTs()Endpoint - Step 3: Run the Code
If you happen to’re already aware of the ins and outs of NFT APIs, be happy to skip straight into the ”Get an NFT Tokens Checklist of a Consumer in 3 Steps” part!
Lastly, we’ll high issues off by exploring some outstanding use instances the place it’s worthwhile to get all NFTs owned by a person deal with.
If this sounds intriguing, be a part of us on this article as we start by leaping straight into the intricacies of NFT APIs!
What’s an NFT API?
An NFT API – brief for software programming interface – is a set of protocols and guidelines permitting software program techniques to entry and work together with on-chain knowledge associated to non-fungible tokens. One of many details of an NFT API is to summary the complexities of querying blockchain networks by introducing a developer-friendly interface that means that you can seamlessly purchase NFT-related knowledge and combine it into your tasks.
NFT APIs usually provide a variety of options, empowering builders to create modern companies and functions revolving round NFTs. You will discover some frequent capabilities of NFT APIs under:
- Get NFTs Owned by Tackle: Most NFT API companies will let you seamlessly question the NFT stability of any deal with.
- Fetch NFT Metadata: NFTs normally have metadata hooked up to them. This info features a title, description, and different attributes. With an NFT API, you possibly can seamlessly get this info straight from the blockchain.
- Occasion Monitoring: NFT APIs typically present real-time occasion monitoring, permitting you to remain up to date concerning varied actions inside the NFT area. This consists of every thing from new listings to token gross sales.
- Get Switch Knowledge: With an NFT API, you may get the newest NFT switch knowledge in actual time. These interfaces additionally make it attainable to question historic transaction knowledge.
- Fetch Market Knowledge: Some NFT APIs assist integrations with main marketplaces, permitting you to retrieve pricing knowledge, details about trending collections, and extra.
However, now that you’ve an outline of NFT APIs, let’s introduce you to the simplest technique to get all tokens owned by a person deal with!
The best way to Get a Consumer NFT Tokens Checklist?
There are a number of NFT APIs to select from if you wish to get a person NFT tokens checklist. Nonetheless, the best choice is Moralis’ industry-leading NFT API!
The Moralis NFT API helps over three million NFT collections (and counting) throughout greater than ten EVM-compatible chains. This consists of established tasks like CryptoPunks, Pudgy Penguins, and many others., together with NFTs that dropped just some seconds in the past!
So, what are you able to do with the NFT API?
Due to the accessibility of this software, you possibly can, amongst different issues, do the next with a single line of code:
- Get NFTs by Assortment or Pockets: Simplify the event of your NFT tasks by effortlessly fetching all NFTs from a given assortment or pockets.
- Fetch NFT Metadata: Get NFT metadata, together with a token’s title, description, photos, traits, and extra, with a single API name. If you happen to’d prefer to study extra about this, try our article on methods to get ERC-721 on-chain metadata!
- Monitor NFT Trades by Market: Keep knowledgeable about NFT market dynamics by monitoring tokens throughout main platforms like OpenSea and Rarible.
- Retrieve NFT Possession Knowledge: Retrieve and examine NFT possession knowledge on the token or assortment degree with ease.
To study extra about how the Moralis NFT API works and why that is the most suitable choice in the marketplace, be a part of us within the subsequent part as we present you methods to get a person NFT tokens checklist in three simple steps!
Get a Consumer NFT Tokens Checklist in 3 Steps
The Moralis NFT API is very easy to make use of, and to get a person NFT tokens checklist, all you want is just a few traces of code and a single API name. To spotlight this accessibility, we’ll present you methods to get all NFTs owned by a person deal with in three steps:
- Step 1: Arrange Moralis
- Step 2: Name the
getWalletNFTs()Endpoint - Step 3: Run the Code
However earlier than we bounce into the tutorial, you need to cope with a few stipulations!
Conditions
Earlier than you may get a person NFT tokens checklist, you initially have to have the next put in and prepared:
Moreover, you may as well go forward and arrange a brand new undertaking and open it together with your built-in improvement setting (IDE). From there, open a brand new terminal and run the next command within the undertaking’s root folder to put in the Moralis SDK:
npm set up moralis @moralisweb3/common-evm-utils
That’s it for the stipulations. You’re now able to proceed with the tutorial. As such, with out additional delay, let’s bounce straight into step one and present you methods to arrange Moralis!
Step 1: Set Up Moralis
Earlier than you can also make calls to the Moralis NFT API, you want entry to your Moralis API key, and to get an API key, you want a Moralis account. That mentioned, you possibly can arrange an account free of charge by clicking on the ”Begin for Free” button on the high proper of the Moralis homepage:
After establishing your account and your Moralis undertaking, you could find your key by going to the ”Web3 APIs” tab and clicking on the ”Get your API keys” button:
This takes you to the next web page, and you’ll go forward and replica your API key and hold it for the second half:
That’s it for the preliminary step. Let’s now present you methods to implement the code for getting a person NFT tokens checklist!
Step 2: Name the getWalletNFTs() Endpoint
For this tutorial, we’ll be utilizing JavaScript to fetch all NFTs owned by a person deal with. As such, you possibly can proceed by creating an ”index.js” file in your undertaking’s root folder. From there, you possibly can copy and paste the code under:
const Moralis = require("moralis").default;
const { EvmChain } = require("@moralisweb3/common-evm-utils");
const runApp = async () => {
await Moralis.begin({
apiKey: "YOUR_API_KEY",
// ...and another configuration
});
const deal with = "0xd8da6bf26964af9d7eed9e03e53415d37aa96045";
const chain = EvmChain.ETHEREUM;
const response = await Moralis.EvmApi.nft.getWalletNFTs({
deal with,
chain,
});
console.log(response.toJSON());
};
runApp();
Subsequent, be sure to interchange YOUR_API_KEY with the API key you copied within the earlier step:
From right here, add the pockets deal with you need to get the NFTs from to the deal with const and configure chain if you wish to question one other blockchain community:
We then move the deal with and chain constants as parameters when calling the getWalletNFTs() endpoint:
That’s it! We solely want a single API name to the getWalletNFTs() endpoint to get a person NFT tokens checklist when working with Moralis!
From right here, we simply have to run the code above!
Step 3: Run the Code
Working the code is straightforward, and also you solely have to open a brand new terminal, enter the command under, and hit enter:
node index.js
Whenever you run the code, you’ll be supplied with an array of NFTs wanting one thing like this:
{
"complete": 1456,
"web page": 1,
"page_size": 100,
"cursor": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21QYXJhbXMiOnsid2FsbGV0QWRkcmVzcyI6IjB4ZDhkYTZiZjI2OTY0YWY5ZDdlZWQ5ZTAzZTUzNDE1ZDM3YWE5NjA0NSJ9LCJrZXlzIjpbIjE2NjMyMzgxNzUuMDc3Il0sIndoZXJlIjp7Im93bmVyX29mIjoiMHhkOGRhNmJmMjY5NjRhZjlkN2VlZDllMDNlNTM0MTVkMzdhYTk2MDQ1In0sImxpbWl0IjoxMDAsIm9mZnNldCI6MCwib3JkZXIiOltdLCJ0b3RhbCI6MTQ1NiwicGFnZSI6MSwidGFpbE9mZnNldCI6MSwiaWF0IjoxNjY2NjgyNTUyfQ.E5DkWYvRTaFnVhgedRuT3IW-rb2V-ikFKwP2cg2Qf78",
"end result": [
{
"token_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
"token_id": "4765809967066625256798886812262830659450023020194524584471225959000376492819",
"amount": "1",
"owner_of": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"token_hash": "ba6d44b5f16be94283cecffeb784b7ca",
"block_number_minted": "15572796",
"block_number": "15573017",
"contract_type": "ERC721",
"name": "Ethereum Name Service",
"symbol": "ENS",
"token_uri": null,
"metadata": null,
"last_token_uri_sync": null,
"last_metadata_sync": "2022-09-20T06:06:08.153Z",
"minter_address": null
},
{
"token_address": "0x57f1887a8bf19b14fc0df6fd9b2acc9af147ea85",
"token_id": "84453794918345416145331514647027903846664455083247396107154093349515123913389",
"amount": "1",
"owner_of": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"token_hash": "7c0212cd3daf1b6b64f193c6dc102fb4",
"block_number_minted": "15572811",
"block_number": "15573017",
"contract_type": "ERC721",
"name": "Ethereum Name Service",
"symbol": "ENS",
"token_uri": null,
"metadata": null,
"last_token_uri_sync": null,
"last_metadata_sync": "2022-09-20T06:09:09.838Z",
"minter_address": null
}
],
"standing": "SYNCED"
}
Congratulations, you now know methods to get a person NFT tokens checklist with Moralis!
From right here, now you can combine this performance into your future tasks and begin constructing extra subtle NFT-based platforms!
Consumer NFT Tokens Checklist – Use Circumstances
The non-fungible attribute of NFTs makes them good for representing possession of distinctive gadgets. NFTs enable individuals to tokenize every thing from digital artwork to actual property. This makes these tokens extremely dynamic, and the know-how is relevant in lots of conditions. However when do you truly have to get all NFT tokens owned by a person deal with? To reply this query, we’ll discover three examples of outstanding use instances when it’s worthwhile to get a person NFT tokens checklist!
Web3 Wallets
Web3 wallets – additionally known as crypto wallets – are digital platforms for storing property like fungible and non-fungible tokens. There are a number of outstanding pockets suppliers, and a few examples embrace MetaMask, Phantom Pockets, and Rainbow.
An excellent pockets wants to provide customers an outline of all their property, that means that these platforms want a straightforward and accessible technique to fetch all tokens owned by a person deal with. Consequently, when constructing a Web3 pockets, an NFT API just like the one Moralis affords can are available in fairly useful.
As an example, an already comfortable person of Moralis’ NFT API is the industry-leading Web3 pockets supplier MetaMask:
DeFi Platforms
Some DeFi platforms – which is an abbreviation for decentralized finance – use NFTs as collateral. On these platforms, customers have the choice to make use of their NFTs to borrow cryptocurrencies like DAI, USDC, and many others. Some DeFi tasks additionally present extra options, such because the fractionalization of NFTs.
If you happen to’d prefer to study extra about this, please try our article on fractional NFTs!
In an effort to present this performance, DeFi platforms have to entry the NFT balances of customers, partly to show the tokens they maintain. But in addition to permit customers to really put up their NFTs as collateral, fractionalize them, and many others. Consequently, when constructing a DeFi platform like this, you want a straightforward technique to get a person NFT tokens checklist.
NFT Marketplaces
NFT marketplaces are digital platforms that enable customers to retailer, promote, purchase, show, and even mint NFTs. Some already present marketplaces embrace Rarible, SuperRare, and OpenSea.
When constructing an NFT market, you need to have the ability to fetch the NFT tokens checklist of a person. It will, as an illustration, will let you seamlessly show all tokens of their pockets so that they know what property they’ll checklist and promote.
To present you a good clearer instance, try the next testimonial from NFTrade – a outstanding NFT market already leveraging the Moralis NFT API:
Abstract: The best way to Get the NFT Tokens Checklist of a Consumer with Moralis
In at the moment’s article, we confirmed you methods to get a person NFT tokens checklist with the Moralis NFT API in three steps:
- Step 1: Arrange Moralis
- Step 2: Name the
getWalletNFTs()Endpoint - Step 3: Run the Code
Consequently, if in case you have adopted alongside this far, you now know methods to get all NFTs owned by a pockets deal with. From right here, you possibly can combine this performance into your future tasks and construct NFT-based functions in a heartbeat!
If you happen to appreciated this information, think about trying out extra content material right here on the Web3 weblog. As an example, find out about OpenSea gasoline charges or dive into the ins and outs of a Linea Goerli faucet.
You may as well discover some extra instruments Moralis affords. For instance, try the {industry}’s main crypto Value API and Web3 Pockets API, or discover ways to arrange Web3 webhooks with the Moralis Streams API!
Additionally, don’t neglect to enroll with Moralis to entry these superb improvement instruments. You’ll be able to create your Moralis account free of charge and begin constructing your subsequent undertaking within the blink of a watch!
