Get Token Metadata by Asset Types

POST

Retrieves token metadata for the specified asset types.

Path Parameters

chainstringrequired

Parameter specifying the target chain to query.

networkstringrequired

Parameter specifying the network of the target chain.

Request Body

assetTypesarrayrequired

Enter the Asset Types to query as an array.

Responses

assetTypestring

A field that represents the unique identifier of the asset.Provided in one of two formats:

Coin: Asset ID in Move struct format (e.g., 0x1::aptos_coin::AptosCoin)
Fungible Asset: Object address that owns the metadata of the asset

tokenStandardstring

A field that represents the standard the asset follows.

v1: Assets following the Coin standard
v2: Assets following the Fungible Asset standard

namestringrequired

A field that represents the name of the asset.The official name of the asset displayed in the user interface; used to identify and distinguish assets.

symbolstringrequired

A field that represents the symbol of the asset.The abbreviated identifier of the asset used in exchanges and wallets.

decimalsintegerrequired

A field that represents the decimal places of the asset.Defines the number of decimal places applied when displaying the actual asset quantity.For example, if decimals is 8, 100000000 (10^8) is displayed as 1.0.

totalSupplystringrequired

A field that represents the total circulating supply.Provided as an integer value before decimals are applied.The asset's decimals must be considered when calculating the actual circulating supply.

maximumSupplystringrequired

A field that represents the maximum supply that can be minted.Provided as an integer value before decimals are applied.An empty string ("") means there is no maximum supply limit.

creatorAddressstringrequired

A field that represents the address of the account that created the asset.Provided as a 64-character hexadecimal string prefixed with 0x; identifies the asset creator.Used to track asset management authority and ownership.

projectURIstringrequired

A field that represents the URI that provides project-related information.A URL is provided where you can find detailed information about the project such as website, whitepaper, and documentation.Used to obtain additional information related to the asset.

iconURIstringrequired

A field that represents the icon image URL of the asset.The URL of an image that allows visual identification of the asset is provided.

codestringrequired

Code identifying the cause of the failed request.

messagestringrequired

Detailed message including the name and value of the invalid parameter.

{
  "code": "MISSING_REQUIRED_PARAMETER",
  "message": "Missing required parameter: { PARAMETER_NAME }"
}

X-API-KEY

cURL

curl -X POST 'https://web3.nodit.io/v1/aptos/mainnet/token/getTokenMetadataByAssetTypes' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: nodit-demo' \
  -d '{
    "assetTypes": [
      "0x1::aptos_coin::AptosCoin",
      "0x000000000000000000000000000000000000000000000000000000000000000a"
    ]
  }'