Skip to main content

​
Token Metadata

Query metadata for native token denominations registered on XYZ Chain. This covers the base uxyz denomination and any other registered denoms.

​
List All Denominations

Returns metadata for all registered denominations. 
curl http://67.205.164.156:1317/cosmos/bank/v1beta1/denoms_metadata

{
  "metadatas": [
    {
      "description": "The native staking token of XYZ Chain",
      "denom_units": [
        {
          "denom": "uxyz",
          "exponent": 0,
          "aliases": ["micro-xyz"]
        },
        {
          "denom": "XYZ",
          "exponent": 6,
          "aliases": []
        }
      ],
      "base": "uxyz",
      "display": "XYZ",
      "name": "XYZ",
      "symbol": "XYZ"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "1"
  }
}

​
Key Fields

FieldDescription
baseThe smallest denomination stored on-chain (uxyz)
displayThe human-readable denomination (XYZ)
denom_unitsConversion table between denominations
denom_units[].exponentPower of 10 for conversion. uxyz (exponent 0) → XYZ (exponent 6) means 1 XYZ = 10^6 uxyz

​
Get Specific Denomination

Query metadata for a single denomination. 
curl http://67.205.164.156:1317/cosmos/bank/v1beta1/denoms_metadata/uxyz
Returns the same structure as above for the specified denom.

​
CW20 Token Metadata

CW20 tokens (created via the Launchpad or custom contracts) are not native denominations — they live inside WASM contracts. To query their metadata, use the smart contract query endpoint: 
# Base64 encode the query
QUERY=$(echo -n '{"token_info":{}}' | base64)

curl "http://67.205.164.156:1317/cosmwasm/wasm/v1/contract/xyz1tokencontract.../smart/$QUERY"

{
  "data": {
    "name": "Example Token",
    "symbol": "EXT",
    "decimals": 6,
    "total_supply": "100000000000000"
  }
}

​
CW20 vs Native Tokens

PropertyNative (uxyz)CW20 Tokens
StorageBank module stateWASM contract state
Query/cosmos/bank/v1beta1/.../cosmwasm/wasm/v1/contract/.../smart/...
TransferMsgSendCW20 Transfer execute message
StandardXYZ Chain nativeCW20 standard
Created byGenesis / Bridge moduleLaunchpad contract or manual deploy
For querying CW20 token data in bulk (all launchpad tokens, prices, volumes), use the Launchpad API instead. It provides pre-indexed data that’s much faster than querying individual contracts.