💹Token Metadata API

Get both on-chain and off-chain metadata API for Solana tokens.

NEW — For all token metadata queries, please use the new DAS API Get Asset method.

(DEPRECATED) v0/token-metadata

You can pass up to 100 mint accounts.

Use https://api-devnet.helius.xyz/v0/token-metadata for devnet metadata.

Example Use Cases

Arguably the most interesting parts of the NFT such as image URL and attributes/traits are stored on the metadata. The NFT metadata endpoint can be used to either bulk fetch multiple NFTs' metadata or a single one. Some example use cases:

  • NFT Photo Gallery

  • Rarity calculator/analysis

  • Dynamic/evolving NFTs

Code Samples

getMetadata.js
const url = "https://api.helius.xyz/v0/token-metadata?api-key=<your-key>";
const nftAddresses = [
  "BAAzgRGWY2v5AJBNZNFd2abiRXAUo56UxywKEjoCZW2",
  "8s6kQUZfdm7GSaThAcsmSs56wMinXrbk6SdNVngutrz5"
]; // Monkes
const getMetadata = async () => {
  const response = await fetch(url, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      mintAccounts: nftAddresses,
      includeOffChain: true,
      disableCache: false,
    }),
  });

  const data = await response.json();
  console.log("metadata: ", data);
};

getMetadata();

Last updated