Account Balances on a Cosmos Chain

cosmos-rest/balances

Every token balance of an account on a Cosmos-SDK chain, as base-unit integer strings with their denoms (the first 100 denominations), plus the node's total count and whether more follow. Amounts are never converted: use the denoms metadata tool for decimals. 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.

Install it Create an account

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/balances" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "cosmos-rest/balances", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "cosmos-rest/balances", 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.

Charge	Price
Per call	$0.0026

Updated: Oct 28, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "chain",
    "address"
  ],
  "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"
    },
    "address": {
      "type": "string",
      "pattern": "^[!-~]{1,83}1[02-9ac-hj-np-z]{6,90}$",
      "description": "A bech32 account address of the chosen chain, lowercase, e.g. cosmos1... or osmo1... The prefix must be the chain's own."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "required": [
    "balances",
    "has_more"
  ],
  "properties": {
    "total": {
      "type": [
        "integer",
        "null"
      ],
      "description": "The node's count of all items, null when it sent none."
    },
    "balances": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [],
        "properties": {
          "denom": {
            "type": [
              "string",
              "null"
            ],
            "description": "Token denom, e.g. uatom or an ibc/ hash."
          },
          "amount": {
            "type": [
              "string",
              "null"
            ],
            "description": "Amount in the denom's base unit, an exact digit string."
          }
        },
        "description": "One coin.",
        "additionalProperties": false
      },
      "description": "Up to 100 coins."
    },
    "has_more": {
      "type": "boolean",
      "description": "True when more items follow: raise offset, or narrow the question."
    }
  },
  "description": "An account's coins.",
  "additionalProperties": false
}