At this time’s article will present you how one can get a person’s NFT tokens listing with the Moralis NFT API. Because of the ability of this instrument, you solely want a single API name to the getWalletNFTs() endpoint to take action. Under, you’ll find the code displaying 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 some other 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 possibly look one thing like this:
{
“whole”: 1456,
“web page”: 1,
“page_size”: 100,
“cursor”: “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21QYXJhbXMiOnsid2FsbGV0QWRkcmVzcyI6IjB4ZDhkYTZiZjI2OTY0YWY5ZDdlZWQ5ZTAzZTUzNDE1ZDM3YWE5NjA0NSJ9LCJrZXlzIjpbIjE2NjMyMzgxNzUuMDc3Il0sIndoZXJlIjp7Im93bmVyX29mIjoiMHhkOGRhNmJmMjY5NjRhZjlkN2VlZDllMDNlNTM0MTVkMzdhYTk2MDQ1In0sImxpbWl0IjoxMDAsIm9mZnNldCI6MCwib3JkZXIiOltdLCJ0b3RhbCI6MTQ1NiwicGFnZSI6MSwidGFpbE9mZnNldCI6MSwiaWF0IjoxNjY2NjgyNTUyfQ.E5DkWYvRTaFnVhgedRuT3IW-rb2V-ikFKwP2cg2Qf78”,
“outcome”: [
{
“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 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 neglect to enroll in 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 challenge 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 must fetch all NFT tokens owned by your customers. Nonetheless, to get a person NFT tokens listing on a blockchain like Ethereum, you would need to parse the whole community, observe ERC-721 sensible contracts, and get the newest possession information for every token. This requires an enormous quantity of engineering time and sources. Luckily, now you can bypass this by leveraging the Moralis NFT API. As an instance the ability of this instrument, we’ll take right this moment’s article to indicate you how one can get all tokens owned by a person deal with!
Nonetheless, earlier than we dive into the principle matter, we’ll kick issues off by what an NFT API is. From there, we’ll introduce the Moralis NFT API to spotlight why that is the very best instrument to get a person NFT tokens listing. After that, we’ll soar straight into the tutorial and present you how one can get all NFT tokens owned by a person deal with in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
In the event you’re already conversant in 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 distinguished use circumstances the place it is advisable get all NFTs owned by a person deal with.
If this sounds intriguing, be 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 information 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 information and combine it into your initiatives.
NFT APIs typically supply a variety of options, empowering builders to create modern companies and functions revolving round NFTs. You’ll find some frequent capabilities of NFT APIs under:
Get NFTs Owned by Deal with: 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 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 numerous actions inside the NFT area. This consists of every part from new listings to token gross sales. Get Switch Information: With an NFT API, you will get the newest NFT switch information in actual time. These interfaces additionally make it potential to question historic transaction information. Fetch Market Information: Some NFT APIs help integrations with main marketplaces, permitting you to retrieve pricing information, 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 deal with!
Tips on 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 listing. 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 initiatives like CryptoPunks, Pudgy Penguins, and many others., together with NFTs that dropped only a few seconds in the past!
So, what are you able to do with the NFT API?
Because of 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 the event you’d prefer to study extra about this, take a look at our article on how one can 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 verify NFT possession information on the token or assortment degree with ease.
To study extra about how the Moralis NFT API works and why that is the best choice in the marketplace, be part of us within the subsequent part as we present you how one can get a person NFT tokens listing 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 listing, all you want is a number of strains of code and a single API name. To spotlight this accessibility, we’ll present you how one can get all NFTs owned by a person deal with in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
However earlier than we soar into the tutorial, you should take care of a few conditions!
Stipulations
Earlier than you will get a person NFT tokens listing, you initially must have the next put in and prepared:
Moreover, you can even go forward and arrange a brand new challenge and open it along with your built-in growth setting (IDE). From there, open a brand new terminal and run the next command within the challenge’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 soar straight into step one and present you how one can arrange Moralis!
Step 1: Set Up Moralis
Earlier than you may 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 at no cost by clicking on the ”Begin for Free” button on the high proper of the Moralis homepage:
After establishing your account and your Moralis challenge, you’ll 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 may go forward and replica your API key and preserve it for the second half:
That’s it for the preliminary step. Let’s now present you how one can implement the code for getting a person NFT tokens listing!
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 challenge’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 some other 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 certain that to switch YOUR_API_KEY with the API key you copied within the earlier step:
From right here, add the pockets deal with you wish to get the NFTs from to the deal with const and configure chain if you wish to question one other blockchain community:
We then cross 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 listing when working with Moralis!
From right here, we simply must run the code above!
Step 3: Run the Code
Operating the code is easy, and also you solely must 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:
{
“whole”: 1456,
“web page”: 1,
“page_size”: 100,
“cursor”: “eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjdXN0b21QYXJhbXMiOnsid2FsbGV0QWRkcmVzcyI6IjB4ZDhkYTZiZjI2OTY0YWY5ZDdlZWQ5ZTAzZTUzNDE1ZDM3YWE5NjA0NSJ9LCJrZXlzIjpbIjE2NjMyMzgxNzUuMDc3Il0sIndoZXJlIjp7Im93bmVyX29mIjoiMHhkOGRhNmJmMjY5NjRhZjlkN2VlZDllMDNlNTM0MTVkMzdhYTk2MDQ1In0sImxpbWl0IjoxMDAsIm9mZnNldCI6MCwib3JkZXIiOltdLCJ0b3RhbCI6MTQ1NiwicGFnZSI6MSwidGFpbE9mZnNldCI6MSwiaWF0IjoxNjY2NjgyNTUyfQ.E5DkWYvRTaFnVhgedRuT3IW-rb2V-ikFKwP2cg2Qf78”,
“outcome”: [
{
“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 how one can get a person NFT tokens listing 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 good for representing possession of distinctive gadgets. NFTs permit individuals to tokenize every part 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 must get all NFT tokens owned by a person deal with? To reply this query, we’ll discover three examples of distinguished use circumstances when it is advisable get a person NFT tokens listing!
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 distinguished pockets suppliers, and a few examples embrace MetaMask, Phantom Pockets, and Rainbow.
A great pockets wants to offer customers an summary of all their property, which means that these platforms want a straightforward and accessible option to fetch all tokens owned by a person deal with. Consequently, when constructing a Web3 pockets, an NFT API just like the one Moralis presents can are available in fairly useful.
As an example, an already completely happy 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 the event you’d prefer to study extra about this, please take a look at our article on fractional NFTs!
With the intention to present this performance, DeFi platforms must entry the NFT balances of customers, partly to show the tokens they maintain. But in addition to permit customers to truly put up their NFTs as collateral, fractionalize them, and many others. Consequently, when constructing a DeFi platform like this, you want a straightforward option to get a person NFT tokens listing.
NFT Marketplaces
NFT marketplaces are digital platforms that permit 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 should be capable of fetch the NFT tokens listing of a person. This may, as an illustration, will let you seamlessly show all tokens of their pockets in order that they know what property they will listing and promote.
To present you an excellent clearer instance, take a look at the next testimonial from NFTrade – a distinguished NFT market already leveraging the Moralis NFT API:
Abstract: Tips on how to Get the NFT Tokens Checklist of a Consumer with Moralis
In right this moment’s article, we confirmed you how one can get a person NFT tokens listing with the Moralis NFT API in three steps:
Step 1: Arrange MoralisStep 2: Name the getWalletNFTs() EndpointStep 3: Run the Code
Consequently, in case you have adopted alongside this far, you now know how one can get all NFTs owned by a pockets deal with. From right here, you possibly can combine this performance into your future initiatives and construct NFT-based functions in a heartbeat!
In the event you preferred this information, think about testing 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 also discover some further instruments Moralis presents. For instance, take a look at the {industry}’s main crypto Value API and Web3 Pockets API, or learn to arrange Web3 webhooks with the Moralis Streams API!
Additionally, don’t neglect to enroll with Moralis to entry these wonderful growth instruments. You’ll be able to create your Moralis account at no cost and begin constructing your subsequent challenge within the blink of a watch!