NFTs have revolutionized the idea of art, its access, and ownership. By dividing up ownership rights, they have not only removed art from the four walls of galleries but also reduced the price of pricey works of art. The NFT movement is quickly gaining traction among developers and business people as well as producers and collectors, which is why there are more NFT applications available now than ever before. Additionally, there is a steady rise in the number of people wanting to create NFT apps like NFT games, NFT wallets, and NFT markets. Although NFT applications are very popular with consumers, developers, and organizations, creating NFT applications is still challenging since NFT apps require a substantial quantity of data to function properly. To make NFT apps useful for consumers, a lot of data sourcing must be done, from gathering NFT ownership information to retrieving transaction history. It takes a lot of time and labor to go through each NFT smart contract individually to retrieve data. Different purpose-built NFT APIs can be utilized to address this issue and make the creation of NFT apps faster and easier. These APIs assist in exploring undiscovered prospects in the NFT space by allowing developers to directly access NFT data relating to tokens, metadata, assets, ownership, etc. This article provides information about the Alchemy NFT API and its expanding importance in the development community. Let's touch on the essentials first, though, before going any further. What are NFTs? What are APIs? What are NFTs? Non-fungible tokens, or NFTs, are digital assets that represent ownership of a wide range of tangible and intangible assets, including videos, images, fine art, real estate, music, and so on. Because each token carries a unique identification code and metadata and is verified and secured by a blockchain, these unique cryptographic tokens cannot be destroyed or replicated. An NFT certifies the ownership, origin, uniqueness, and permanence of a digital collectible. NFTs differ from traditional digital currencies such as Bitcoin, Ethereum, and Dogecoin in some ways, such as the fact that they both represent digital assets and operate on top of a blockchain network. Furthermore, non-fungible tokens, like fungible tokens, can be transferred from one wallet to another in a quick, secure, and cost-effective manner. Because NFTs are hosted on a blockchain, their ownership is transparent and verifiable. Unquestionably, one of the most fascinating trends in the blockchain industry is NFT. Everyone is hopping on the NFT bandwagon, from major corporations to celebrities and influencers. Since the first NFT "Quantum" was issued in 2014, the NFT market has likewise experienced tremendous expansion. The global NFT market is anticipated to increase by USD 147.24 billion from 2021 to 2026, at a CAGR of 35.27 percent, according to a recent industry report by Technavio. What are APIs? Let's first define an API before we study NFT APIs. Application Programming Interface, or API, is the mechanism underlying all computer system connectivity and interactivity. Simply put, an API is the messenger that accepts your requests, instructs a system to perform them, and then provides you with the result. You are probably accustomed to the procedure of looking for flights online. You can choose your departure and destination cities, your departure and arrival dates, your chosen cabin class, and other parameters from a menu. In essence, all you do is engage with the website of your preferred airline, access its database, check to see if tickets are available on your preferred dates and find out what the booking fees might be based on various factors. What happens, though, if you use an online travel agency instead of the airline's website, which compiles data from other airlines? The information you require won't reach you immediately in that situation. The travel service will initially interface with the airline's API and request data from the airline's system regarding seats, meals, and baggage options. The travel service receives the request from the API, transmits it to the system, receives the airline's response, and then sends it back to you (the user). Alchemy NFT API You may rapidly obtain all the information you require about NFTs from the blockchain using Alchemy's NFT API (i.e. Ethereum, Polygon, Flow). You can now submit a single request to get specified NFT information for both ERC-721 and ERC-1155 tokens rather than manually searching, indexing, and storing data, such as Metadata and properties for each NFT token controlled by an address Step 1: Create Alchemy Account We must obtain an API Key from Alchemy to use all of the endpoints in the Alchemy NFT API. The simplest method is to register for a free Alchemy account. It's as simple as entering your information and clicking "Sign Up" (Even Gavin can do it). When you are signed in and in your dashboard, click the "+ CREATE APP" button to start developing an app to acquire your API Key. Just give your app a name, then choose a network and chain. We'll be working on the Ethereum Mainnet for this session. Click “Create app” and that’s it! Your app should appear in the table of your app. By clicking on the "View Key" link to the right of the table row for your app, you will be able to find the API_KEY which you can use to access an Ethereum Mainnet node using Alchemy. You can see in our example that our is: API_KEY mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V This is how you go to your node. If you distribute it, others will be free to consume the resources of your application, which will make you feel as sad as Gavin. DO NOT SHARE THIS WITH ANYONE! Copy this down for later, we will use this in our code. Step 2: Set up your Environment Open a terminal and create a new repository for your scripts using the command line. Additionally, we'll set up the repository as a project. npm mkdir alchemy-nft-api
cd alchemy-nft-api
npm init --yes To quickly interact with Alchemy APIs, install the module. Because you also receive WebSocket support, retries, and other advantages without the complexity, we strongly advise utilizing the Alchemy SDK. alchemy-sdk Run the following command to install . alchemy-sdk npm install alchemy-sdk Step 3: Initialize SDK instance In your alchemy-NFT-API directory, you can create a new file called Use your favorite file browser, the code editor and then paste the following code snippet into the file: script.js import { Network, Alchemy } from "alchemy-sdk";

const settings = {
  apiKey: "mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V",
  network: Network.ETH_MAINNET,
};

const alchemy = new Alchemy(settings) Importing the necessary dependencies for using the Alchemy SDK Library is done in the first line of the code above. next, we build a settings object, which has our apikey and the network we want to use to fetch results—in this example, Ethereum Mainnet—and finally, we create a new instance of Alchemy SDK with settings as the parameters. In this tutorial, we will look at three endpoints namely , and . getNFTs getNFTMetadata getNFTsForCollection getNFTs The the method returns all NFTs currently owned by a given address. It takes one parameter which is the address of the NFT owner, the address can be also in ENS Format (e.g. ) getNFTs vitalik.eth import { Network, Alchemy } from "alchemy-sdk";

const settings = {
  apiKey: "mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V",
  network: Network.ETH_MAINNET,
};

const alchemy = new Alchemy(settings);

const owner = "vitalik.eth";

const fetchedNFTs = await alchemy.nft.getNftsForOwner(owner);
console.log(fetchedNFTs.totalCount); // 25219 The the line returns an object that includes all of the NFTs along with their , , , , , , and several other details. The key, which we logged in the next line, is located at the end of the object and contains the total number of NFTs possessed by the owner. fetchedNFTs contact information tokens token type title description balance totalCount getNFTMetadata The the line returns the metadata associated with a given NFT. The Contract Address and the Token ID are the two mandatory arguments. We can also provide the token type, such as ERC-20 or ERC-1155. getNFTMetadata import { Network, Alchemy } from "alchemy-sdk";

const settings = {
  apiKey: "mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V",
  network: Network.ETH_MAINNET,
};

const alchemy = new Alchemy(settings);

const metadata = await alchemy.nft
  .getNftMetadata("0x60E4d786628Fea6478F785A6d7e704777c86a7c6", 14810)
  .then(console.log); This returns an Object containing metadata for the given NFT. {
  contract: {
    address: '0x60E4d786628Fea6478F785A6d7e704777c86a7c6',
    name: 'MutantApeYachtClub',
    symbol: 'MAYC',
    totalSupply: '19426',
    tokenType: 'ERC721'
  },
  tokenId: '14810',
  tokenType: 'ERC721',
  title: '',
  description: '',
  timeLastUpdated: '2022-10-09T20:30:13.968Z',
  metadataError: undefined,
  rawMetadata: {
    image: 'ipfs://QmfNzqEHVFvMv551ThzEQ26Qurzx4L812LDJnJtmUVgqeK',
    attributes: [ [Object], [Object], [Object], [Object], [Object], [Object] ]
  },
  tokenUri: {
    raw: 'https://boredapeyachtclub.com/api/mutants/14810',
    gateway: 'https://boredapeyachtclub.com/api/mutants/14810'
  },
  media: [
    {
      raw: 'ipfs://QmfNzqEHVFvMv551ThzEQ26Qurzx4L812LDJnJtmUVgqeK',
      gateway: 'https://ipfs.io/ipfs/QmfNzqEHVFvMv551ThzEQ26Qurzx4L812LDJnJtmUVgqeK'
    }
  ],
  spamInfo: undefined
} getNFTsForCollection The the method returns all NFTs for a given NFT contract. It takes one argument, the address of the NFT contract. For Example: getNFTsForCollection import { Network, Alchemy } from "alchemy-sdk";

const settings = {
  apiKey: "mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V",
  network: Network.ETH_MAINNET,
};

const alchemy = new Alchemy(settings);

const opts = {
  pageKey: "4756",
  omitMetadata: true,
  pageSize: 3,
  tokenUriTimeoutInMs: 0,
};
const address = "0x60E4d786628Fea6478F785A6d7e704777c86a7c6";

const nfts = await alchemy.nft.getNftsForContract(address).then(console.log); Output - ...
{
    contract: [Object],
    tokenId: '22',
    tokenType: 'ERC721',
    title: '',
    description: '',
    timeLastUpdated: '2022-10-10T20:15:40.835Z',
    metadataError: undefined,
    rawMetadata: [Object],
    tokenUri: [Object],
    media: [Array],
    spamInfo: undefined
},
{
    contract: [Object],
    tokenId: '23',
    tokenType: 'ERC721',
    title: '',
    description: '',
    timeLastUpdated: '2022-10-10T20:15:41.206Z',
    metadataError: undefined,
    rawMetadata: [Object],
    tokenUri: [Object],
    media: [Array],
    spamInfo: undefined
},
... By default, it returns an object maximum of 100 NFTs for a given NFT contract, but we can set it by using the method to iterate over NFTs getNftsForContractIterator import { Network, Alchemy } from "alchemy-sdk";

const settings = {
  apiKey: "mlkvPMmH_o7K-dkLNTE4viDwuCyc3B3V",
  network: Network.ETH_MAINNET,
};

const alchemy = new Alchemy(settings);

const opts = {
  pageKey: "4756",
  omitMetadata: true,
  pageSize: 3,
  tokenUriTimeoutInMs: 0,
};
const address = "0x60E4d786628Fea6478F785A6d7e704777c86a7c6";

for await (const nft of alchemy.nft.getNftsForContractIterator(address, opts)) {
  console.log(nft);
} Output - ...
{
  contract: { address: '0x60E4d786628Fea6478F785A6d7e704777c86a7c6' },
  tokenId: '5553',
  tokenType: 'UNKNOWN'
}
{
  contract: { address: '0x60E4d786628Fea6478F785A6d7e704777c86a7c6' },
  tokenId: '5554',
  tokenType: 'UNKNOWN'
}
{
  contract: { address: '0x60E4d786628Fea6478F785A6d7e704777c86a7c6' },
  tokenId: '5555',
  tokenType: 'UNKNOWN'
}
...
`` Here is a list of all the endpoints for Alchemy NFT API getNfts Retrieve the NFTs owned by a wallet address getContractsForOwner Retrieve the list of NFT contracts from which a wallet address owns one or more tokens. getOwnersForToken Retrieve the owners of a given token getOwnersForCollection Retrieve all the owners for a given NFT contract or collection, including snapshotting owners at any block numb isHolderOfCollection Check whether a given wallet owns any NFT in a given token getNFTMetadata Retrieve the metadata associated with a given contract or collection getContractMetadata Retrieve the metadata associated with a given contract or collection searchContractMetadata Search the metadata across contracts for specific keywords reingestContract Triggers metadata refresh for an NFT collection/refreshes stale metadata after a reveal getNFTsForCollection Retrieve all the NFTs for a given contract or collection getSpamContracts Retrieve a list of contracts marked as spam isSpamContract Returns whether a specific contract is marked as spam or not getFloorPrice Retrieve the floor price of an NFT collection by the marketplace getNFTSales Retrieve NFT sales data across marketplaces computeRarity Compute the rarity of each attribute of an NFT. summarizeNFTAttributes Generate a summary of attribute prevalence for an NFT collection. Also Published here

This story contains new, firsthand information uncovered by the writer.

Ethereum

Dogecoin

Polygon

Algorand

Flow

Chain

Fetch

Read My Stories

Too Long; Didn't Read

Boost your HackerNoon story @ $159.99! 🚀

Exploring the Alchemy NFT API

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Untitled Story

The Alchemy of the Web: Transforming Ideas Into Reality With HTML/CSS and JavaScript

Alchemy Partners With Cross Finance To Power dApp Development

How Blockchain APIs and RPC Nodes Work

100 Days of AI Day 1: From Newsletter to Podcast, Leveraging AI for Audio Transformation

10 Threats to an Open API Ecosystem

The Alchemy of the Web: Transforming Ideas Into Reality With HTML/CSS and JavaScript

Alchemy Partners With Cross Finance To Power dApp Development

How Blockchain APIs and RPC Nodes Work

100 Days of AI Day 1: From Newsletter to Podcast, Leveraging AI for Audio Transformation

10 Threats to an Open API Ecosystem

Light-Mode

Classic

Newspaper

Dark-Mode

Neon Noir

Minty

HN StartUps