NFT API Quickstart

Go from zero to hero with the Alchemy NFT API. Learn how to query NFT data, then dive into some fun tutorials!

Don’t have an API key?

Start using the NFT API in your app today.

Get started for free

Getting Started Instructions

Follow along with the steps below to get started with the NFT API:

Choose a package manager
Set up your repo
Choose a library
1. Alchemy SDK (recommended)
2. Node-Fetch
3. Axios

1. Choose a package manager

For this guide, we will be using npm or yarn as our package manager to install either alchemy-sdk, fetch, or axios.

npm

To get started with npm, follow the documentation to install Node.js and npm for your operating system: https://docs.npmjs.com/downloading-and-installing-node-js-and-npm

yarn

To get started with yarn, follow these steps: https://classic.yarnpkg.com/lang/en/docs/install

2. Set up your repo

npm

Open up a terminal, and from the command line, create a new repository to hold your quickstart scripts. We'll also initialize the repo as an npm project.

mkdir alchemy-nft-api
cd alchemy-nft-api
npm init --yes

yarn

mkdir alchemy-nft-api
cd alchemy-nft-api
yarn init --yes

📘
Support Import Syntax
Since we'll be using import syntax to load ES6 modules, add 'type': 'module' to your package.json file:
// package.json
{
  ...
  "type": "module"
}
See this discussion for more context.

3. Choose a Library

a) Alchemy SDK (Recommended)

You can install the alchemy-sdk-js module to easily interact with Alchemy APIs. We highly recommend using the Alchemy SDK because you also get WebSocket support, retries, and other benefits without the complexity!

For full documentation on alchemy-sdk-js, check the GitHub repo:

github.com

GitHub - alchemyplatform/alchemy-sdk-js

Installation

Run the following command to install alchemy-web3 with npm and yarn

npm install alchemy-sdk

yarn add alchemy-sdk

Demo Script

nft-api-javascript-scripts/alchemy-sdk-script.js at main · alchemyplatform/nft-api-javascript-scripts

github.com

nft-api-javascript-scripts/alchemy-sdk-script.js at main · alchemyplatform/nft-api-javascript-scripts

The demo script for the Alchemy SDK

In your alchemy-nft-api directory, you can create a new file called alchemy-sdk-script.js using your favorite file browser, code editor, or just directly in the terminal using the touch command like this:

touch alchemy-sdk-script.js

and then paste the following code snippet into the file:

// This script demonstrates access to the NFT API via the Alchemy SDK.
import { Network, Alchemy } from "alchemy-sdk";

// Optional Config object, but defaults to demo api-key and eth-mainnet.
const settings = {
  apiKey: "demo", // Replace with your Alchemy API Key.
  network: Network.ETH_MAINNET, // Replace with your network.
};

const alchemy = new Alchemy(settings);

// Print owner's wallet address:
const ownerAddr = "vitalik.eth";
console.log("fetching NFTs for address:", ownerAddr);
console.log("...");

// Print total NFT count returned in the response:
const nftsForOwner = await alchemy.nft.getNftsForOwner("vitalik.eth");
console.log("number of NFTs found:", nftsForOwner.totalCount);
console.log("...");

// Print contract address and tokenId for each NFT:
for (const nft of nftsForOwner.ownedNfts) {
  console.log("===");
  console.log("contract address:", nft.contract.address);
  console.log("token ID:", nft.tokenId);
}
console.log("===");

// Fetch metadata for a particular NFT:
console.log("fetching metadata for a Crypto Coven NFT...");
const response = await alchemy.nft.getNftMetadata(
  "0x5180db8F5c931aaE63c74266b211F580155ecac8",
  "1590"
);

// Uncomment this line to see the full api response:
// console.log(response);

// Print some commonly used fields:
console.log("NFT name: ", response.title);
console.log("token type: ", response.tokenType);
console.log("tokenUri: ", response.tokenUri.gateway);
console.log("image url: ", response.rawMetadata.image);
console.log("time last updated: ", response.timeLastUpdated);
console.log("===");

From your command line, you can execute the script with:

node alchemy-sdk-script.js

You should see output like this:

node alchemy-sdk-script.js   ✔  4s
fetching NFTs for address: vitalik.eth
...
number of NFTs found: 516
...
===
contract address: 0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3
token ID: 29
===
contract address: 0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3
token ID: 238
===
...........
===
fetching metadata for a Crypto Coven NFT...
NFT name:  balsa vault
token type:  ERC721
tokenUri:  https://alchemy.mypinata.cloud/ipfs/QmaXzZhcYnsisuue5WRdQDH6FDvqkLQX1NckLqBYeYYEfm/1590.json
image url:  https://cryptocoven.s3.amazonaws.com/a7875f5758f85544dcaab79a8a1ca406.png
time last updated:  2022-06-23T06:48:33.229Z
===

For full documentation on the available endpoints for alchemy-sdk, check the github repo:

github.com

GitHub - alchemyplatform/alchemy-sdk-js

b) Node-Fetch

node-fetch is a lightweight, common module that brings the Fetch API to Node.js and allows us to make our HTTP requests.

See the documentation for more info: https://www.npmjs.com/package/node-fetch

Installation

Run the following command to install node-fetch with npm and yarn

npm install node-fetch

yarn add node-fetch

Demo Script

nft-api-javascript-scripts/fetch-script.js at main · alchemyplatform/nft-api-javascript-scripts

github.com

nft-api-javascript-scripts/fetch-script.js at main · alchemyplatform/nft-api-javascript-scripts

In your alchemy-nft-api directory, you can create a new file called fetch-script.js using your favorite file browser, code editor, or just directly in the terminal using the touch command like this:

touch fetch-script.js

and then paste the following code snippet in to explore the getNFTs or getNFTMetadata methods:

// alchemy-nft-api/fetch-script.js
import fetch from 'node-fetch';

// Setup request options:
var requestOptions = {
  method: 'GET',
  redirect: 'follow'
};

// Replace with your Alchemy API key:
const apiKey = "demo";
const baseURL = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTsForOwner/`;
// Replace with the wallet address you want to query:
const ownerAddr = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
const pageSize = 2;
const fetchURL = `${baseURL}?owner=${ownerAddr}&pageSize=${pageSize}`;

// Make the request and print the formatted response:
fetch(fetchURL, requestOptions)
  .then(response => response.json())
  .then(response => JSON.stringify(response, null, 2))
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

import fetch from 'node-fetch';

  var requestOptions = {
    method: 'GET',
    redirect: 'follow'
  };

  const apiKey = "demo"
  const baseURL = `https://eth-mainnet.g.alchemy.com/nft/v3/${demo}/getNFTMetadata`;
  const contractAddr = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d";
  const tokenId = "2";
  const tokenType = "erc721";
  const fetchURL = `${baseURL}?contractAddress=${contractAddr}&tokenId=${tokenId}&tokenType=${tokenType}`;

  fetch(fetchURL, requestOptions)
    .then(response => response.json())
    .then(response => JSON.stringify(response, null, 2))
    .then(result => console.log(result))
    .catch(error => console.log('error', error));

From your command line, you can execute the script with:

node fetch-script.js

Your output should look like the following:

{
	"ownedNfts": [
		{
			"contract": {
				"address": "0x000386E3F7559d9B6a2F5c46B4aD1A9587D59Dc3",
				"name": "Bored Ape Nike Club",
				"symbol": "BANC",
				"totalSupply": null,
				"tokenType": "ERC721",
				"contractDeployer": "0x51D7D428041E23ef51422e110dfEfF906e821CFe",
				"deployedBlockNumber": 14276343,
				"openSeaMetadata": {
					"floorPrice": null,
					"collectionName": "BoredApeNikeClub",
					"collectionSlug": "bored-ape-nike-club-v2",
					"safelistRequestStatus": "not_requested",
					"imageUrl": "https://i.seadn.io/gae/yJ9DgXqjRwgdCkrQmHj7krCbixM8fPVAyYJWJ5NHXap1L0c3QL5MPvrNT0QDINIStGOK857lOvab8MpNQS9X4pkHPktmhVmN82qoVw?w=500&auto=format",
					"description": "COUNTDOWN OVER. MINTING LIVE.\n\n[Mint on the website.](https://nikemetaverse.xyz)\n",
					"externalUrl": "https://nikemetaverse.xyz",
					"twitterUsername": null,
					"discordUrl": null,
					"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format",
					"lastIngestedAt": "2023-10-30T07:13:52.000Z"
				},
				"isSpam": true,
				"spamClassifications": [
					"OwnedByMostHoneyPots",
					"Erc721TooManyOwners",
					"Erc721TooManyTokens",
					"NoSalesActivity",
					"HighAirdropPercent",
					"HighHoneyPotPercent",
					"HoneyPotsOwnMultipleTokens"
				]
			},
			"tokenId": "1",
			"tokenType": "ERC721",
			"name": null,
			"description": null,
			"tokenUri": "http://api.nikeapenft.xyz/ipfs/1",
			"image": {
				"cachedUrl": null,
				"thumbnailUrl": null,
				"pngUrl": null,
				"contentType": null,
				"size": null,
				"originalUrl": null
			},
			"raw": {
				"tokenUri": "http://api.nikeapenft.xyz/ipfs/1",
				"metadata": {},
				"error": null
			},
			"collection": {
				"name": "BoredApeNikeClub",
				"slug": "bored-ape-nike-club-v2",
				"externalUrl": "https://nikemetaverse.xyz",
				"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format"
			},
			"mint": {
				"mintAddress": null,
				"blockNumber": null,
				"timestamp": null,
				"transactionHash": null
			},
			"owners": null,
			"timeLastUpdated": "2023-11-06T04:34:38.880Z",
			"balance": "26",
			"acquiredAt": {
				"blockTimestamp": null,
				"blockNumber": null
			}
		},
		{
			"contract": {
				"address": "0x000386E3F7559d9B6a2F5c46B4aD1A9587D59Dc3",
				"name": "Bored Ape Nike Club",
				"symbol": "BANC",
				"totalSupply": null,
				"tokenType": "ERC721",
				"contractDeployer": "0x51D7D428041E23ef51422e110dfEfF906e821CFe",
				"deployedBlockNumber": 14276343,
				"openSeaMetadata": {
					"floorPrice": null,
					"collectionName": "BoredApeNikeClub",
					"collectionSlug": "bored-ape-nike-club-v2",
					"safelistRequestStatus": "not_requested",
					"imageUrl": "https://i.seadn.io/gae/yJ9DgXqjRwgdCkrQmHj7krCbixM8fPVAyYJWJ5NHXap1L0c3QL5MPvrNT0QDINIStGOK857lOvab8MpNQS9X4pkHPktmhVmN82qoVw?w=500&auto=format",
					"description": "COUNTDOWN OVER. MINTING LIVE.\n\n[Mint on the website.](https://nikemetaverse.xyz)\n",
					"externalUrl": "https://nikemetaverse.xyz",
					"twitterUsername": null,
					"discordUrl": null,
					"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format",
					"lastIngestedAt": "2023-10-30T07:13:52.000Z"
				},
				"isSpam": true,
				"spamClassifications": [
					"OwnedByMostHoneyPots",
					"Erc721TooManyOwners",
					"Erc721TooManyTokens",
					"NoSalesActivity",
					"HighAirdropPercent",
					"HighHoneyPotPercent",
					"HoneyPotsOwnMultipleTokens"
				]
			},
			"tokenId": "2",
			"tokenType": "ERC721",
			"name": null,
			"description": null,
			"tokenUri": "http://api.nikeapenft.xyz/ipfs/2",
			"image": {
				"cachedUrl": null,
				"thumbnailUrl": null,
				"pngUrl": null,
				"contentType": null,
				"size": null,
				"originalUrl": null
			},
			"raw": {
				"tokenUri": "http://api.nikeapenft.xyz/ipfs/2",
				"metadata": {},
				"error": null
			},
			"collection": {
				"name": "BoredApeNikeClub",
				"slug": "bored-ape-nike-club-v2",
				"externalUrl": "https://nikemetaverse.xyz",
				"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format"
			},
			"mint": {
				"mintAddress": null,
				"blockNumber": null,
				"timestamp": null,
				"transactionHash": null
			},
			"owners": null,
			"timeLastUpdated": "2023-11-06T11:46:38.867Z",
			"balance": "31",
			"acquiredAt": {
				"blockTimestamp": null,
				"blockNumber": null
			}
		}
	],
	"totalCount": 26620,
	"validAt": {
		"blockNumber": 18513471,
		"blockHash": "0x49376e3ea0d07b4b557521832ac2f52213b12bf912087ac1fe9f04c9899d221b",
		"blockTimestamp": "2023-11-06T14:15:23Z"
	},
	"pageKey": "MHgwMDAzODZlM2Y3NTU5ZDliNmEyZjVjNDZiNGFkMWE5NTg3ZDU5ZGMzOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMjpmYWxzZQ=="
}

{
	"contract": {
		"address": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",
		"name": "World Of Women",
		"symbol": "WOW",
		"totalSupply": "10000",
		"tokenType": "ERC721",
		"contractDeployer": "0xc9b6321dc216D91E626E9BAA61b06B0E4d55bdb1",
		"deployedBlockNumber": 12907782,
		"openSeaMetadata": {
			"floorPrice": 0.7899,
			"collectionName": "World of Women",
			"collectionSlug": "world-of-women-nft",
			"safelistRequestStatus": "verified",
			"imageUrl": "https://i.seadn.io/gcs/files/8604de2d9aaec98dd389e3af1b1a14b6.gif?w=500&auto=format",
			"description": "World of Women is a collection of 10,000 NFTs that gives you full access to our network of artists, creators, entrepreneurs, and executives who are championing diversity and equal opportunity on the blockchain.\n\nCreated and illustrated by Yam Karkai (@ykarkai), World of Women has made prominent appearances at Christie's, The New Yorker and Billboard.\n\nJoin us to receive exclusive access to NFT drops, experiences, and much more.\n\nThe Time is WoW.",
			"externalUrl": "http://worldofwomen.art",
			"twitterUsername": "worldofwomennft",
			"discordUrl": "https://discord.gg/worldofwomen",
			"bannerImageUrl": "https://i.seadn.io/gae/GHhptRLebBOWOy8kfXpYCVqsqdes-1-6I_jbuRnGTHHW6TD63CtciH75Dotfu2u8v6EmkWt-tjhkFRVLxRUwgMfKqqy5W24AolJayeo?w=500&auto=format",
			"lastIngestedAt": "2023-11-06T05:54:50.000Z"
		},
		"isSpam": null,
		"spamClassifications": []
	},
	"tokenId": "2",
	"tokenType": "ERC721",
	"name": "WoW #2",
	"description": null,
	"tokenUri": "https://alchemy.mypinata.cloud/ipfs/QmTNBQDbggLZdKF1fRgWnXsnRikd52zL5ciNu769g9JoUP/2",
	"image": {
		"cachedUrl": "https://nft-cdn.alchemy.com/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"thumbnailUrl": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"pngUrl": "https://res.cloudinary.com/alchemyapi/image/upload/convert-png/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"contentType": "image/png",
		"size": 192785,
		"originalUrl": "https://ipfs.io/ipfs/QmSTBRrNGPvQssSWenMiBQj7ZYue7DEwajAF4z5HDrLFV6"
	},
	"raw": {
		"tokenUri": "ipfs://QmTNBQDbggLZdKF1fRgWnXsnRikd52zL5ciNu769g9JoUP/2",
		"metadata": {
			"name": "WoW #2",
			"image": "ipfs://QmSTBRrNGPvQssSWenMiBQj7ZYue7DEwajAF4z5HDrLFV6",
			"attributes": [
				{
					"value": "Purple Pink",
					"trait_type": "Background"
				},
				{
					"value": "Deep Bronze",
					"trait_type": "Skin Tone"
				},
				{
					"value": "Green Straight",
					"trait_type": "Eyes"
				},
				{
					"value": "Cyber Warrior",
					"trait_type": "Facial Features"
				},
				{
					"value": "Curly Ponytail",
					"trait_type": "Hairstyle"
				},
				{
					"value": "Psychedelic Sunglasses",
					"trait_type": "Face Accessories"
				},
				{
					"value": "Sun Keeper",
					"trait_type": "Necklace"
				},
				{
					"value": "Striped Tee",
					"trait_type": "Clothes"
				},
				{
					"value": "Stern",
					"trait_type": "Mouth"
				},
				{
					"value": "Burgundy",
					"trait_type": "Lips Color"
				}
			]
		},
		"error": null
	},
	"collection": {
		"name": "World of Women",
		"slug": "world-of-women-nft",
		"externalUrl": "http://worldofwomen.art",
		"bannerImageUrl": "https://i.seadn.io/gae/GHhptRLebBOWOy8kfXpYCVqsqdes-1-6I_jbuRnGTHHW6TD63CtciH75Dotfu2u8v6EmkWt-tjhkFRVLxRUwgMfKqqy5W24AolJayeo?w=500&auto=format"
	},
	"mint": {
		"mintAddress": null,
		"blockNumber": null,
		"timestamp": null,
		"transactionHash": null
	},
	"owners": null,
	"timeLastUpdated": "2023-10-30T14:36:39.767Z"
}

c) Axios

axios is a promise-based HTTP client for the browser and Node.js, which allows us to make a raw request to the Alchemy API.

See the documentation for more info: https://www.npmjs.com/package/axios

Installation

Run the following command to install axios with npm and `yarn

npm install axios

yarn add axios

Demo Script

nft-api-javascript-scripts/axios-script.js at main · alchemyplatform/nft-api-javascript-scripts

github.com

nft-api-javascript-scripts/axios-script.js at main · alchemyplatform/nft-api-javascript-scripts

In your alchemy-nft-api directory, you can create a new file called axios-script.js using your favorite file browser, code editor, or just directly in the terminal using the touch command.

touch axios-script.js

and then paste the following code snippet in to explore the getNFTs or getNFTMetadata methods:

// alchemy-nft-api/axios-script.js
import axios from 'axios';

// Replace with your Alchemy API key:
const apiKey = "demo";
const baseURL = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTsForOwner/`;
// Replace with the wallet address you want to query for NFTs:
const ownerAddr = "0xF5FFF32CF83A1A614e15F25Ce55B0c0A6b5F8F2c";
const pageSize = 2;

// Construct the axios request:
var config = {
  method: 'get',
  url: `${baseURL}?owner=${ownerAddr}&pageSize=${pageSize}`
};

// Make the request and print the formatted response:
axios(config)
.then(response => console.log(JSON.stringify(response.data, null, 2)))
.catch(error => console.log(error));

import axios from 'axios';

// replace with your Alchemy api key
const apiKey = "demo";
const baseURL = `https://eth-mainnet.g.alchemy.com/nft/v3/${apiKey}/getNFTMetadata`;
const contractAddr = "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d";
const tokenId = "2";
const tokenType = "erc721";

var config = {
  method: 'get',
  url: `${baseURL}?contractAddress=${contractAddr}&tokenId=${tokenId}&tokenType=${tokenType}`,
  headers: { }
};

axios(config)
.then(response => console.log(JSON.stringify(response.data, null, 2)))
.catch(error => console.log(error));

From your command line, you can execute the script with:

node axios-script.js

Your output should look like the following:

alchemy-nft-api % node axios-script.js
{
	"ownedNfts": [
		{
			"contract": {
				"address": "0x000386E3F7559d9B6a2F5c46B4aD1A9587D59Dc3",
				"name": "Bored Ape Nike Club",
				"symbol": "BANC",
				"totalSupply": null,
				"tokenType": "ERC721",
				"contractDeployer": "0x51D7D428041E23ef51422e110dfEfF906e821CFe",
				"deployedBlockNumber": 14276343,
				"openSeaMetadata": {
					"floorPrice": null,
					"collectionName": "BoredApeNikeClub",
					"collectionSlug": "bored-ape-nike-club-v2",
					"safelistRequestStatus": "not_requested",
					"imageUrl": "https://i.seadn.io/gae/yJ9DgXqjRwgdCkrQmHj7krCbixM8fPVAyYJWJ5NHXap1L0c3QL5MPvrNT0QDINIStGOK857lOvab8MpNQS9X4pkHPktmhVmN82qoVw?w=500&auto=format",
					"description": "COUNTDOWN OVER. MINTING LIVE.\n\n[Mint on the website.](https://nikemetaverse.xyz)\n",
					"externalUrl": "https://nikemetaverse.xyz",
					"twitterUsername": null,
					"discordUrl": null,
					"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format",
					"lastIngestedAt": "2023-10-30T07:13:52.000Z"
				},
				"isSpam": true,
				"spamClassifications": [
					"OwnedByMostHoneyPots",
					"Erc721TooManyOwners",
					"Erc721TooManyTokens",
					"NoSalesActivity",
					"HighAirdropPercent",
					"HighHoneyPotPercent",
					"HoneyPotsOwnMultipleTokens"
				]
			},
			"tokenId": "1",
			"tokenType": "ERC721",
			"name": null,
			"description": null,
			"tokenUri": "http://api.nikeapenft.xyz/ipfs/1",
			"image": {
				"cachedUrl": null,
				"thumbnailUrl": null,
				"pngUrl": null,
				"contentType": null,
				"size": null,
				"originalUrl": null
			},
			"raw": {
				"tokenUri": "http://api.nikeapenft.xyz/ipfs/1",
				"metadata": {},
				"error": null
			},
			"collection": {
				"name": "BoredApeNikeClub",
				"slug": "bored-ape-nike-club-v2",
				"externalUrl": "https://nikemetaverse.xyz",
				"bannerImageUrl": "https://i.seadn.io/gae/i84LsC2dtbF5I3YiuaXzzfvSijlBI-ZJ8UEta04Ukl4V57Uoj0ZGw8tNyuPdwrF7N5pclyzdqSJjxHZ65z4G5jQrVRK_DHUMVrzTYQ?w=500&auto=format"
			},
			"mint": {
				"mintAddress": null,
				"blockNumber": null,
				"timestamp": null,
				"transactionHash": null
			},
			"owners": null,
			"timeLastUpdated": "2023-11-06T04:34:38.880Z",
			"balance": "26",
			"acquiredAt": {
				"blockTimestamp": null,
				"blockNumber": null
			}
		},
	],
	"totalCount": 26620,
	"validAt": {
		"blockNumber": 18513471,
		"blockHash": "0x49376e3ea0d07b4b557521832ac2f52213b12bf912087ac1fe9f04c9899d221b",
		"blockTimestamp": "2023-11-06T14:15:23Z"
	},
	"pageKey": "MHgwMDAzODZlM2Y3NTU5ZDliNmEyZjVjNDZiNGFkMWE5NTg3ZDU5ZGMzOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMjpmYWxzZQ=="
}

{
	"contract": {
		"address": "0xe785E82358879F061BC3dcAC6f0444462D4b5330",
		"name": "World Of Women",
		"symbol": "WOW",
		"totalSupply": "10000",
		"tokenType": "ERC721",
		"contractDeployer": "0xc9b6321dc216D91E626E9BAA61b06B0E4d55bdb1",
		"deployedBlockNumber": 12907782,
		"openSeaMetadata": {
			"floorPrice": 0.7899,
			"collectionName": "World of Women",
			"collectionSlug": "world-of-women-nft",
			"safelistRequestStatus": "verified",
			"imageUrl": "https://i.seadn.io/gcs/files/8604de2d9aaec98dd389e3af1b1a14b6.gif?w=500&auto=format",
			"description": "World of Women is a collection of 10,000 NFTs that gives you full access to our network of artists, creators, entrepreneurs, and executives who are championing diversity and equal opportunity on the blockchain.\n\nCreated and illustrated by Yam Karkai (@ykarkai), World of Women has made prominent appearances at Christie's, The New Yorker and Billboard.\n\nJoin us to receive exclusive access to NFT drops, experiences, and much more.\n\nThe Time is WoW.",
			"externalUrl": "http://worldofwomen.art",
			"twitterUsername": "worldofwomennft",
			"discordUrl": "https://discord.gg/worldofwomen",
			"bannerImageUrl": "https://i.seadn.io/gae/GHhptRLebBOWOy8kfXpYCVqsqdes-1-6I_jbuRnGTHHW6TD63CtciH75Dotfu2u8v6EmkWt-tjhkFRVLxRUwgMfKqqy5W24AolJayeo?w=500&auto=format",
			"lastIngestedAt": "2023-11-06T05:54:50.000Z"
		},
		"isSpam": null,
		"spamClassifications": []
	},
	"tokenId": "2",
	"tokenType": "ERC721",
	"name": "WoW #2",
	"description": null,
	"tokenUri": "https://alchemy.mypinata.cloud/ipfs/QmTNBQDbggLZdKF1fRgWnXsnRikd52zL5ciNu769g9JoUP/2",
	"image": {
		"cachedUrl": "https://nft-cdn.alchemy.com/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"thumbnailUrl": "https://res.cloudinary.com/alchemyapi/image/upload/thumbnailv2/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"pngUrl": "https://res.cloudinary.com/alchemyapi/image/upload/convert-png/eth-mainnet/4d6f68252d08e3383e627f8ddd80a1ea",
		"contentType": "image/png",
		"size": 192785,
		"originalUrl": "https://ipfs.io/ipfs/QmSTBRrNGPvQssSWenMiBQj7ZYue7DEwajAF4z5HDrLFV6"
	},
	"raw": {
		"tokenUri": "ipfs://QmTNBQDbggLZdKF1fRgWnXsnRikd52zL5ciNu769g9JoUP/2",
		"metadata": {
			"name": "WoW #2",
			"image": "ipfs://QmSTBRrNGPvQssSWenMiBQj7ZYue7DEwajAF4z5HDrLFV6",
			"attributes": [
				{
					"value": "Purple Pink",
					"trait_type": "Background"
				},
				{
					"value": "Deep Bronze",
					"trait_type": "Skin Tone"
				},
				{
					"value": "Green Straight",
					"trait_type": "Eyes"
				},
				{
					"value": "Cyber Warrior",
					"trait_type": "Facial Features"
				},
				{
					"value": "Curly Ponytail",
					"trait_type": "Hairstyle"
				},
				{
					"value": "Psychedelic Sunglasses",
					"trait_type": "Face Accessories"
				},
				{
					"value": "Sun Keeper",
					"trait_type": "Necklace"
				},
				{
					"value": "Striped Tee",
					"trait_type": "Clothes"
				},
				{
					"value": "Stern",
					"trait_type": "Mouth"
				},
				{
					"value": "Burgundy",
					"trait_type": "Lips Color"
				}
			]
		},
		"error": null
	},
	"collection": {
		"name": "World of Women",
		"slug": "world-of-women-nft",
		"externalUrl": "http://worldofwomen.art",
		"bannerImageUrl": "https://i.seadn.io/gae/GHhptRLebBOWOy8kfXpYCVqsqdes-1-6I_jbuRnGTHHW6TD63CtciH75Dotfu2u8v6EmkWt-tjhkFRVLxRUwgMfKqqy5W24AolJayeo?w=500&auto=format"
	},
	"mint": {
		"mintAddress": null,
		"blockNumber": null,
		"timestamp": null,
		"transactionHash": null
	},
	"owners": null,
	"timeLastUpdated": "2023-10-30T14:36:39.767Z"
}

Available Tutorials

How to Create NFT Token-Gated Communities: Learn how to use the Alchemy NFT API to verify ownership of an NFT, or grab a complete ownership snapshot for a collection!
How to Filter Out Spam NFTs: Learn how to identify and filter spam NFTs using the Alchemy API.
How to Get NFT Owners at a Specific Block Height: Learn how to get snapshot of all the owners of an NFT collection at a particular point in time or block height using the NFT API.
How to Check the Owner of an NFT: Learn how to find the owner of an NFT (ERC-721 or ERC-155) on Ethereum and Polygon in one request using the NFT API.
How to Get All NFTs in a Collection: Learn how to get all NFTs that belong to a particular collection using the Alchemy NFT API.
How to Get All NFTs Owned by an Address: Learn how to get all NFTs (and their metadata) owned by an address using the Alchemy NFT API.
How to Get a List of NFT Holders for a Given Collection: Learn how to get a list of all wallets that own a specific NFT collection.
How to Resolve ENS Domains Given a Wallet Address: This tutorial uses Alchemy’s NFT API to fetch all ENS Domain Names owned by a user.

Each tutorial includes step-by-step instructions and code examples to help you follow along and build your own app.

Thank you for using the NFT API, and happy coding!

NFT API Quickstart

Don’t have an API key?

Getting Started Instructions

1. Choose a package manager

npm

yarn

2. Set up your repo

npm

yarn

📘
Support Import Syntax

3. Choose a Library

a) Alchemy SDK (Recommended)

Installation

Demo Script

b) Node-Fetch

Installation

Demo Script

c) Axios

Installation

Demo Script

Available Tutorials

APIs

DEVELOPERS

Company

CONTACT

Don’t have an API key?

Getting Started Instructions

1. Choose a package manager

npm

yarn

2. Set up your repo

npm

yarn

📘Support Import Syntax

3. Choose a Library

a) Alchemy SDK (Recommended)

Installation

Demo Script

b) Node-Fetch

Installation

Demo Script

c) Axios

Installation

Demo Script

Available Tutorials

APIs

DEVELOPERS

Company

CONTACT

📘
Support Import Syntax