At the moment’s article will present you the way to get a person’s NFT tokens checklist with the Moralis NFT API. Due to the ability of this instrument, you solely want a single API name to the getWalletNFTs() endpoint to take action. Beneath, you will discover the code displaying an instance of the way it works in apply:
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 handle = “0xd8da6bf26964af9d7eed9e03e53415d37aa96045”;
const chain = EvmChain.ETHEREUM;
const response = await Moralis.EvmApi.nft.getWalletNFTs({
handle,
chain,
});
console.log(response.toJSON());
};
runApp();
You merely want so as to add your Moralis API key, configure the handle and chain parameters, and execute the code. In return, you’ll obtain a response containing an array of NFTs. And it might probably 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 be taught extra about how this works, be a part of us on this article as we break down the method in additional element. Or take a look at our official get NFTs by pockets documentation!
Additionally, earlier than we proceed, don’t overlook to enroll in free with Moralis to entry the {industry}’s main NFT API. In doing so, you can begin leveraging the complete energy of the Web3 {industry} instantly and construct your subsequent NFT venture in a heartbeat!
Overview
It doesn’t matter if you happen to’re constructing a Web3 pockets, NFT market, or a blockchain-based gaming platform; chances are high you’ll must 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 your complete community, monitor ERC-721 good contracts, and get the newest possession knowledge for every token. This requires an enormous quantity of engineering time and sources. Happily, now you can bypass this by leveraging the Moralis NFT API. As an example the ability of this instrument, we’ll take at the moment’s article to indicate you the way to get all tokens owned by a person handle!
Nonetheless, earlier than we dive into the principle matter, 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 focus on why that is the very best instrument to get a person NFT tokens checklist. After that, we’ll bounce straight into the tutorial and present you the way to get all NFT tokens owned by a person handle in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
In case you’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 prime issues off by exploring some distinguished use instances the place it’s essential get all NFTs owned by a person handle.
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 – quick for utility programming interface – is a set of protocols and guidelines permitting software program programs 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 lets you seamlessly purchase NFT-related knowledge and combine it into your initiatives.
![API to Get User NFT Tokens List Example Graphic Art Image](https://moralis.io/wp-content/uploads/2023/09/API-to-Get-User-NFT-Tokens-List-Example-Graphic-Art-Image.png)
NFT APIs typically supply a variety of options, empowering builders to create modern companies and purposes revolving round NFTs. Yow will discover some widespread capabilities of NFT APIs beneath:
Get NFTs Owned by Tackle: Most NFT API companies will let you seamlessly question the NFT steadiness of any handle. Fetch NFT Metadata: NFTs normally have metadata connected to them. This data features a title, description, and different attributes. With an NFT API, you possibly can seamlessly get this data straight from the blockchain. Occasion Monitoring: NFT APIs usually present real-time occasion monitoring, permitting you to remain up to date concerning varied actions inside the NFT house. This contains every little thing from new listings to token gross sales. Get Switch Information: With an NFT API, you may get the newest NFT switch knowledge in actual time. These interfaces additionally make it doable to question historic transaction knowledge. Fetch Market Information: Some NFT APIs help integrations with main marketplaces, permitting you to retrieve pricing knowledge, details about trending collections, and extra.
However, now that you’ve an summary of NFT APIs, let’s introduce you to the simplest option to get all tokens owned by a person handle!
Find out how 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, your only option 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 contains established initiatives like CryptoPunks, Pudgy Penguins, and many others., together with NFTs that dropped just some seconds in the past!
![NFT API to Get NFT Tokens List from Users Landing Page](https://moralis.io/wp-content/uploads/2023/09/NFT-API-to-Get-NFT-Tokens-List-from-Users-Landing-Page-1024x511.png)
So, what are you able to do with the NFT API?
Due to the accessibility of this instrument, 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 initiatives by effortlessly fetching all NFTs from a given assortment or pockets. Fetch NFT Metadata: Get NFT metadata, together with a token’s identify, description, photographs, traits, and extra, with a single API name. In case you’d prefer to be taught extra about this, take a look at our article on the way to get ERC-721 on-chain metadata! Observe NFT Trades by Market: Keep knowledgeable about NFT market dynamics by monitoring tokens throughout main platforms like OpenSea and Rarible. Retrieve NFT Possession Information: Retrieve and test NFT possession knowledge on the token or assortment stage with ease.
To be taught extra about how the Moralis NFT API works and why that is the most suitable choice available on the market, be a part of us within the subsequent part as we present you the way 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 a couple of strains of code and a single API name. To focus on this accessibility, we’ll present you the way to get all NFTs owned by a person handle in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
However earlier than we bounce into the tutorial, you have to cope with a few conditions!
Conditions
Earlier than you may get a person NFT tokens checklist, you initially must have the next put in and prepared:
Moreover, it’s also possible to go forward and arrange a brand new venture and open it along with your built-in growth atmosphere (IDE). From there, open a brand new terminal and run the next command within the venture’s root folder to put in the Moralis SDK:
npm set up moralis @moralisweb3/common-evm-utils
That’s it for the conditions. 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 the way 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 stated, you possibly can arrange an account without spending a dime by clicking on the ”Begin for Free” button on the prime proper of the Moralis homepage:
![Start for Free button Moralis](https://moralis.io/wp-content/uploads/2023/09/Start-for-Free-button-Moralis-1-1024x339.png)
After establishing your account and your Moralis venture, you will discover your key by going to the ”Web3 APIs” tab and clicking on the ”Get your API keys” button:
![Accessing the NFT Tokens List API key page](https://moralis.io/wp-content/uploads/2023/09/Accessing-the-NFT-Tokens-List-API-key-page-1024x345.png)
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:
![Showing how to copy the API key and paste into code to get user NFT tokens list](https://moralis.io/wp-content/uploads/2023/09/Showing-how-to-copy-the-API-key-and-paste-into-code-to-get-user-NFT-tokens-list-1024x452.png)
That’s it for the preliminary step. Let’s now present you the way 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 handle. As such, you possibly can proceed by creating an ”index.js” file in your venture’s root folder. From there, you possibly can copy and paste the code beneath:
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 handle = “0xd8da6bf26964af9d7eed9e03e53415d37aa96045”;
const chain = EvmChain.ETHEREUM;
const response = await Moralis.EvmApi.nft.getWalletNFTs({
handle,
chain,
});
console.log(response.toJSON());
};
runApp();
Subsequent, ensure that to switch YOUR_API_KEY with the API key you copied within the earlier step:
![Showing where to paste the API key for NFT tokens list](https://moralis.io/wp-content/uploads/2023/09/Showing-where-to-paste-the-API-key-for-NFT-tokens-list-1024x846.png)
From right here, add the pockets handle you need to get the NFTs from to the handle const and configure chain if you wish to question one other blockchain community:
![Showing how to modify address and chain parameters to get NFT tokens from a user](https://moralis.io/wp-content/uploads/2023/09/Showing-how-to-modify-address-and-chain-parameters-to-get-NFT-tokens-from-a-user-1024x846.png)
We then cross the handle and chain constants as parameters when calling the getWalletNFTs() endpoint:
![Calling the GetUserNFTTokensList endpoint](https://moralis.io/wp-content/uploads/2023/09/Calling-the-GetUserNFTTokensList-endpoint-1024x198.png)
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 must run the code above!
Step 3: Run the Code
Working the code is easy, and also you solely must open a brand new terminal, enter the command beneath, and hit enter:
node index.js
While 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 the way to get a person NFT tokens checklist with Moralis!
From right here, now you can combine this performance into your future initiatives and begin constructing extra subtle NFT-based platforms!
Consumer NFT Tokens Checklist – Use Circumstances
The non-fungible attribute of NFTs makes them excellent for representing possession of distinctive objects. NFTs permit individuals to tokenize every little 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 really must get all NFT tokens owned by a person handle? To reply this query, we’ll discover three examples of distinguished use instances when it’s essential get a person NFT tokens checklist!
Web3 Wallets
Web3 wallets – additionally known as crypto wallets – are digital platforms for storing belongings like fungible and non-fungible tokens. There are a number of distinguished pockets suppliers, and a few examples embody MetaMask, Phantom Pockets, and Rainbow.
![Web3 wallets example of what to build using the NFT tokens list API](https://moralis.io/wp-content/uploads/2023/09/Web3-wallets-example-of-what-to-build-using-the-NFT-tokens-list-API-1024x490.png)
An excellent pockets wants to provide customers an summary of all their belongings, that means that these platforms want a simple and accessible option to fetch all tokens owned by a person handle. Consequently, when constructing a Web3 pockets, an NFT API just like the one Moralis affords can are available fairly useful.
For example, an already glad 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 initiatives additionally present further options, such because the fractionalization of NFTs.
In case you’d prefer to be taught extra about this, please take a look at our article on fractional NFTs!
With a purpose to present this performance, DeFi platforms must entry the NFT balances of customers, partly to show the tokens they maintain. But additionally 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 simple option to get a person NFT tokens checklist.
NFT Marketplaces
NFT marketplaces are digital platforms that permit customers to retailer, promote, purchase, show, and even mint NFTs. Some already current marketplaces embody Rarible, SuperRare, and OpenSea.
When constructing an NFT market, you have to be capable of fetch the NFT tokens checklist of a person. It will, as an illustration, will let you seamlessly show all tokens of their pockets in order that they know what belongings they’ll checklist and promote.
To present you a fair clearer instance, take a look at the next testimonial from NFTrade – a distinguished NFT market already leveraging the Moralis NFT API:
Abstract: Find out how to Get the NFT Tokens Checklist of a Consumer with Moralis
In at the moment’s article, we confirmed you the way to get a person NFT tokens checklist with the Moralis NFT API in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
Consequently, if in case you have adopted alongside this far, you now know the way to get all NFTs owned by a pockets handle. From right here, you possibly can combine this performance into your future initiatives and construct NFT-based purposes in a heartbeat!
In case you favored this information, think about testing extra content material right here on the Web3 weblog. For example, find out about OpenSea gasoline charges or dive into the ins and outs of a Linea Goerli faucet.
You can even discover some further instruments Moralis affords. For instance, take a look at 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 overlook to enroll with Moralis to entry these wonderful growth instruments. You’ll be able to create your Moralis account without spending a dime and begin constructing your subsequent venture within the blink of an eye fixed!