💹(Deprecated) Token Metadata API

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

This is a deprecated method. Please use the new getAsset method in the DAS API for all token metadata queries.

Endpoints

• Mainnet – https://api.helius.xyz/v0/token-metadata

• Devnet – https://api-devnet.helius.xyz/v0/token-metadata

Token Metadata API

This Token Metadata endpoint returns all metadata associated with an account (Token/NFT), including data from the legacy token list. In a single request, you can pass up to 100 mint accounts.

(Deprecated) v0/token-metadata

POSThttps://api.helius.xyz/v0/token-metadata

Query parameters

Body

application/json

mintAccountsarray of string

includeOffChainboolean

Include offchain data referenced in the uri of the metadata account. Omitting defaults to false.

disableCacheboolean

Disable usage of cache, useful for monitoring metadata changes.

Response

200400401403404429500

Query result.

Body

application/json

accountstring

onChainAccountInfoOnChainAccountInfoResult (object)

onChainMetadataOnChainMetadataResult (object)

offChainMetadataOffChainMetadataResult (object)

legacyMetadataLegacyMetadata (object)

Data from the old SPL token list.

Request

JavaScriptCurlPython

const response = await fetch('https://api.helius.xyz/v0/token-metadata?api-key=text', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

200400401403404429500

[
  {
    "account": "text",
    "onChainAccountInfo": {
      "accountInfo": {
        "key": "text",
        "isSigner": false,
        "isWritable": false,
        "lamports": 0,
        "data": {
          "parsed": {
            "info": {
              "decimals": 0,
              "freezeAuthority": "text",
              "isInitialized": false,
              "mintAuthority": "text",
              "supply": "text"
            },
            "type": "text"
          },
          "program": "text",
          "space": 0
        },
        "owner": "text",
        "executable": false,
        "rentEpoch": 0
      },
      "error": ""
    },
    "onChainMetadata": {
      "metadata": {
        "key": "text",
        "mint": "text",
        "updateAuthority": "text",
        "data": {
          "name": "text",
          "symbol": "text",
          "uri": "text",
          "sellerFeeBasisPoints": 0,
          "creators": [
            {
              "address": "text",
              "share": "text",
              "verified": false
            }
          ]
        },
        "tokenStandard": "text",
        "primarySaleHappened": false,
        "isMutable": false,
        "editionNonce": 0,
        "collection": {
          "key": "text",
          "verified": false
        },
        "collectionDetails": {
          "size": 0
        },
        "uses": {
          "useMethod": "text",
          "remaining": 0,
          "total": 0
        }
      },
      "error": ""
    },
    "offChainMetadata": {
      "metadata": {
        "name": "text",
        "symbol": "text",
        "attributes": [
          {
            "traitType": "text",
            "value": "text"
          }
        ],
        "sellerFeeBasisPoints": 0,
        "image": "text",
        "properties": {
          "category": "text",
          "files": [
            {
              "uri": "text",
              "type": "text"
            }
          ],
          "creators": [
            {
              "address": "text",
              "share": "text"
            }
          ]
        }
      },
      "uri": "text",
      "error": ""
    },
    "legacyMetadata": {
      "chainId": 0,
      "address": "text",
      "symbol": "text",
      "name": "text",
      "decimals": 0,
      "logoURI": "text",
      "tags": [
        "text"
      ]
    }
  }
]

Code Example

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();