Skip to content
Eden Engine

Token Denoms Metadata of a Cosmos Chain

cosmos-rest/denoms-metadata

Token metadata a Cosmos-SDK chain registers on-chain, a page at a time (at most 100): base denom, display unit, name, symbol, description and the exponent of the display unit (its decimals). Only denoms the chain registered appear; many tokens, such as most IBC ones, have no entry. Read from public nodes that offer no SLA and can be slow, throttled or a block behind; a failing node is replaced by another operator's automatically. Served by Eden Engine; not an official product of any chain or node operator.

activeper callv1

Price

$0.0026 per call

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $0.50.

Data source

Public blockchains

On-chain data read from public blockchain nodes; no licence or credit is required. Served by Eden Engine; not an official product of any chain or node operator.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

For developers: the calls your assistant makes
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "cosmos-rest/denoms-metadata" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "cosmos-rest/denoms-metadata" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "cosmos-rest/denoms-metadata", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "cosmos-rest/denoms-metadata", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

ChargePrice
Per call
$0.0026
Updated
Oct 28, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "chain"
  ],
  "properties": {
    "chain": {
      "enum": [
        "turkchain",
        "unification",
        "neutaro",
        "oraichain",
        "pundi-x-chain",
        "aioz-network",
        "akash",
        "althea",
        "amitis-network",
        "archway",
        "arkeo",
        "aura-network",
        "axelar",
        "axiome",
        "axone",
        "babylon-genesis",
        "beezee",
        "bitbadges",
        "bitcanna",
        "bitsong",
        "nibiru",
        "celestia",
        "cheqd",
        "cifer",
        "firmachain",
        "terra-classic",
        "tx",
        "cosmos-hub",
        "cronos-pos-chain",
        "cysic",
        "desmos",
        "dungeon-chain",
        "dydx-protocol",
        "dymension-hub",
        "empowerchain",
        "epix",
        "fetch-ai",
        "genesisl1",
        "gitopia",
        "gnodi",
        "gonka",
        "haqq-network",
        "hipercapital-finance",
        "hippo-protocol",
        "humans-ai",
        "injective",
        "impact-hub",
        "jackal",
        "juno",
        "kiichain",
        "kyve",
        "band-protocol",
        "lava",
        "likecoin",
        "loyal",
        "lumen",
        "lumera",
        "lumiwave-protocol",
        "decentr",
        "mantra",
        "maya-protocol",
        "mirage",
        "mtgbp",
        "mucoin",
        "neutron",
        "noble",
        "nvnm-chain",
        "nym",
        "optio",
        "osmosis",
        "sei",
        "medibloc",
        "paxi",
        "c4e",
        "nolus",
        "quantum-financial-systems",
        "qorechain",
        "realio-network",
        "regen",
        "safrochain",
        "secret-network",
        "seda",
        "sentinel",
        "shentu",
        "shido",
        "sovren",
        "saga",
        "sto-chain",
        "stride",
        "taketitan",
        "the-jay-network",
        "union",
        "uptick",
        "dora-vota",
        "warden",
        "wolochain",
        "xrpl-evm",
        "zetachain",
        "zigchain"
      ],
      "type": "string",
      "description": "chain slug (for example cosmos-hub, osmosis, celestia); cosmos-rpc/status returns the chain_id, staking denom and decimals"
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page, at most 100."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "maximum": 1000000,
      "minimum": 0,
      "description": "Items to skip, for the next page."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "denoms",
    "has_more"
  ],
  "properties": {
    "total": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The node's count of all items, null when it sent none."
    },
    "denoms": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [],
        "properties": {
          "base": {
            "type": [
              "string",
              "null"
            ],
            "description": "The base denom."
          },
          "name": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token name."
          },
          "symbol": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token symbol."
          },
          "display": {
            "type": [
              "string",
              "null"
            ],
            "description": "The display unit's denom."
          },
          "denom_units": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [],
              "properties": {
                "denom": {
                  "type": [
                    "string",
                    "null"
                  ],
                  "description": "Unit denom."
                },
                "exponent": {
                  "type": [
                    "integer",
                    "null"
                  ],
                  "description": "Exponent from the base unit."
                }
              },
              "description": "One unit.",
              "additionalProperties": false
            },
            "description": "At most 10 units."
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Description, at most 300 characters."
          },
          "display_decimals": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Exponent of the display unit: base units per display unit is 10 to this power; null when the chain does not say."
          }
        },
        "description": "One token.",
        "additionalProperties": false
      },
      "description": "Up to 100 tokens of the page."
    },
    "has_more": {
      "type": "boolean",
      "description": "True when more items follow: raise offset, or narrow the question."
    }
  },
  "description": "A page of token metadata.",
  "additionalProperties": false
}