Skip to content
Eden Engine
Get started

Native Token Balance of an Address on an EVM Chain

evmrpc/balance

The native-token balance of an address at the newest block (the chain's own coin, e.g. ETH on Ethereum Mainnet, Base, Arbitrum One, OP Mainnet; BNB on BNB Smart Chain; evmrpc/chain-info lists every chain's symbol). Wei as an exact decimal string and the same figure in whole tokens. Not token (ERC-20) balances; use the call tool for those. 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

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

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

Install itCreate an account
agent
// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "evmrpc/balance" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "evmrpc/balance" })

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

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "chain",
    "address"
  ],
  "properties": {
    "chain": {
      "enum": [
        "ethereum",
        "base",
        "arbitrum",
        "optimism",
        "bsc"
      ],
      "type": "string",
      "description": "chain slug; see evmrpc/chain-info for ids and names"
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "A 20-byte account or contract address: 0x followed by 40 hex digits."
    }
  },
  "additionalProperties": false
}
Output schema
output_schema.json
{
  "type": "object",
  "required": [
    "balance_wei"
  ],
  "properties": {
    "balance_hex": {
      "type": [
        "string",
        "null"
      ]
    },
    "balance_wei": {
      "type": [
        "string",
        "null"
      ],
      "description": "Balance in wei, an exact decimal string (a number would lose precision)."
    },
    "balance_native": {
      "type": [
        "string",
        "null"
      ],
      "description": "The same balance in whole native tokens (wei / 10^18), an exact decimal string."
    }
  },
  "description": "The address's balance at the newest block of one public node.",
  "additionalProperties": false
}