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

Response

{
  "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

Field	Description
`base`	The smallest denomination stored on-chain (`uxyz`)
`display`	The human-readable denomination (`XYZ`)
`denom_units`	Conversion table between denominations
`denom_units[].exponent`	Power 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"

Response

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

CW20 vs Native Tokens

Property	Native (`uxyz`)	CW20 Tokens
Storage	Bank module state	WASM contract state
Query	`/cosmos/bank/v1beta1/...`	`/cosmwasm/wasm/v1/contract/.../smart/...`
Transfer	`MsgSend`	CW20 `Transfer` execute message
Standard	XYZ Chain native	CW20 standard
Created by	Genesis / Bridge module	Launchpad 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.

Getting Started

Chain

Products

Developer Tools

Token Operations

Smart Contracts

Local Development

Chain API

Launchpad API

Token Metadata

Token Metadata

List All Denominations

Key Fields

Get Specific Denomination

CW20 Token Metadata

CW20 vs Native Tokens

​Token Metadata

​List All Denominations

​Key Fields

​Get Specific Denomination

​CW20 Token Metadata

​CW20 vs Native Tokens

Token Metadata

List All Denominations

Key Fields

Get Specific Denomination

CW20 Token Metadata

CW20 vs Native Tokens