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

/v0/token-metadata

Authorizations

Query parameters

api-keystringrequired

The api key.

Body

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.

mintAccountsstring[]

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 '{"includeOffChain":false,"disableCache":false,"mintAccounts":[null]}'

200

400

401

403

404

429

500

200

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

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