Skip to main content
POST
/
v0
/
token-metadata
Returns all metadata associated with an account, including data from the old token list.
curl --request POST \
  --url 'https://api-mainnet.helius-rpc.com/v0/token-metadata?api-key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mintAccounts": [
    "<string>"
  ],
  "includeOffChain": false,
  "disableCache": false
}
'
[
  {
    "account": "<string>",
    "onChainAccountInfo": {
      "accountInfo": {
        "key": "<string>",
        "isSigner": true,
        "isWritable": true,
        "lamports": 123,
        "data": {
          "parsed": {
            "info": {
              "decimals": 123,
              "freezeAuthority": "<string>",
              "isInitialized": true,
              "mintAuthority": "<string>",
              "supply": "<string>"
            },
            "type": "<string>"
          },
          "program": "<string>",
          "space": 123
        },
        "owner": "<string>",
        "executable": true,
        "rentEpoch": 123
      },
      "error": ""
    },
    "onChainMetadata": {
      "metadata": {
        "key": "<string>",
        "mint": "<string>",
        "updateAuthority": "<string>",
        "data": {
          "name": "<string>",
          "symbol": "<string>",
          "uri": "<string>",
          "sellerFeeBasisPoints": 123,
          "creators": [
            {
              "address": "<string>",
              "share": "<string>",
              "verified": true
            }
          ]
        },
        "tokenStandard": "<string>",
        "primarySaleHappened": true,
        "isMutable": true,
        "editionNonce": 123,
        "collection": {
          "key": "<string>",
          "verified": true
        },
        "collectionDetails": {
          "size": 123
        },
        "uses": {
          "useMethod": "<string>",
          "remaining": 123,
          "total": 123
        }
      },
      "error": ""
    },
    "offChainMetadata": {
      "metadata": {
        "name": "<string>",
        "symbol": "<string>",
        "attributes": [
          {
            "traitType": "<string>",
            "value": "<string>"
          }
        ],
        "sellerFeeBasisPoints": 123,
        "image": "<string>",
        "properties": {
          "category": "<string>",
          "files": [
            {
              "uri": "<string>",
              "type": "<string>"
            }
          ],
          "creators": [
            {
              "address": "<string>",
              "share": "<string>"
            }
          ]
        }
      },
      "uri": "<string>",
      "error": ""
    },
    "legacyMetadata": {
      "chainId": 123,
      "address": "<string>",
      "symbol": "<string>",
      "name": "<string>",
      "decimals": 123,
      "logoURI": "<string>",
      "tags": [
        "<string>"
      ],
      "extensions": {}
    }
  }
]

Documentation Index

Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

Deprecated: This endpoint is deprecated. Use the DAS API instead, which provides richer metadata, better performance, and support for compressed NFTs.

​
Request Parameters

​
mintAccounts
array
​
includeOffChain
boolean
default:"false"
Include offchain data referenced in the uri of the metadata account. Omitting defaults to false.
​
disableCache
boolean
default:"false"
Disable usage of cache, useful for monitoring metadata changes.

Authorizations

​
api-key
string
query
required

Your Helius API key. You can get one for free in the dashboard.

Body

application/json
​
mintAccounts
string[]
Maximum array length: 100

The mint account of the token to retrieve metadata for.

​
includeOffChain
boolean
default:false

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

​
disableCache
boolean
default:false

Disable usage of cache, useful for monitoring metadata changes.

Response

Query result.

​
account
string
​
onChainAccountInfo
object
​
onChainMetadata
object
​
offChainMetadata
object
​
legacyMetadata
object

Data from the old SPL token list.