💹(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

post

Authorizations

Query parameters

api-keystringrequired

The api key.

Body

mintAccountsstring[] · max: 100optional

The mint account of the token to retrieve metadata for.

includeOffChainboolean · default: falseoptional

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

disableCacheboolean · default: falseoptional

Disable usage of cache, useful for monitoring metadata changes.

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.helius.xyz/v0/token-metadata?api-key=text' \
  --header 'Authorization: Basic username:password' \
  --header 'Content-Type: application/json' \
  --data '{
    "mintAccounts": [
      "text"
    ],
    "includeOffChain": true,
    "disableCache": true
  }'

200

400

401

403

404

429

500

200

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

Query result.

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