Wallet Balance Lookup

Get a wallet's ETH balance on Ethereum mainnet and the ERC-20 tokens it most recently sent or received.

Pay by wallet (x402) wallet-balance-lookup

Example

Example answer

{
  "note": "recent_tokens is derived from the last 100 token transfers, not actual balances.",
  "address": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
  "chain_id": "1",
  "recent_tokens": [
    {
      "name": "HEX",
      "symbol": "HEX",
      "address": "0x2b591e99afe9f32eaa6214f7b7629768c40eeb39"
    },
    {
      "name": "PointZ",
      "symbol": "PTZ",
      "address": "0xb9e9f8de030be4585c65cb4b14af3a3acf1f92b1"
    },
    {
      "name": "Strait of Hormuz",
      "symbol": "HORMUZ",
      "address": "0x9a145c5ef4e045008e3e56566ef80a9739dd5981"
    },
    {
      "name": "Yee Token",
      "symbol": "Yee",
      "address": "0x9ac9468e7e3e1d194080827226b45d0b892c77fd"
    },
    {
      "name": "QAI",
      "symbol": "QAI",
      "address": "0xafc628ae96e4d964222a3c7c4fad92bac72c26cd"
    },
    {
      "name": "AIG",
      "symbol": "AIG",
      "address": "0xbfb5d3e6d835bef660fee47877ad07ff780c88f3"
    },
    {
      "name": "Orbitshield",
      "symbol": "OBS",
      "address": "0x5a52b7c9ee14a6740f6a3563013054b3de4c6f65"
    },
    {
      "name": "星火通证",
      "symbol": "SPARK",
      "address": "0xe92ec83d8ea27f802393f084004491e463209acb"
    },
    {
      "name": "DubAI",
      "symbol": "DubAI",
      "address": "0x60b69a1dfc78a67c72a616f213b3e256e1ecce5b"
    },
    {
      "name": "B Zero X",
      "symbol": "B0x",
      "address": "0x1f8f212540b31b37f40d8c57b5c7d8b55bf25919"
    },
    {
      "name": "Malamute.Finance",
      "symbol": "MALLY",
      "address": "0xa3e7833775a9cc022db2c72eb900378f90ce89b4"
    },
    {
      "name": "Tether USD",
      "symbol": "USDT",
      "address": "0x4c592e723e5adf7ab9227043824d25fc77d6980e"
    },
    {
      "name": "AILife",
      "symbol": "AILife",
      "address": "0xc26cdfca6999d2aa45ab09ae2e4e9458b2fa18a2"
    },
    {
      "name": "Tether USD",
      "symbol": "USDT",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
    },
    {
      "name": "GLOBAL RESERVE SYSTEM",
      "symbol": "GLOB",
      "address": "0x45f2ab0ca2116b2e1a70bf5e13293947b25d0272"
    },
    {
      "name": "Ethereum Hyper",
      "symbol": "eHYPER",
      "address": "0x6396b6eede0af69d8371a7520aee72bd979c3e6d"
    },
    {
      "name": "Nicolas Maduro",
      "symbol": "MADURO",
      "address": "0xf9b09a5f1b34b42a484050ddcf052bec00c5acec"
    },
    {
      "name": "Nexo",
      "symbol": "NEXO",
      "address": "0xb62132e35a6c13ee1ee0f84dc5d40bad8d815206"
    },
    {
      "name": "Binance Wrapped BTC",
      "symbol": "BBTC",
      "address": "0x9be89d2a4cd102d8fecc6bf9da793be995c22541"
    },
    {
      "name": "Life USD",
      "symbol": "LUSD",
      "address": "0xdc53cc918c925beb02ef5eca4d83449913bb7f5a"
    }
  ],
  "native_balance_eth": 10774.450568,
  "native_balance_wei": "10774450567588229957307",
  "token_transfer_count": 100
}

Inputs

Field	Type	Required	What it is
`address`	string	Yes	Wallet address (0x...)
`chain_id`	string	No	Chain ID: 1 (Ethereum), 8453 (Base), 42161 (Arbitrum One), 10 (OP Mainnet) or 137 (Polygon PoS). Default: 1

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`address`	string	Usually (present for most inputs)
`chain_id`	string	Always (present in every successful answer)
`native_symbol`	string	Always (present in every successful answer)
`recent_tokens`	array	Usually (present for most inputs)
`native_balance_eth`	number	Usually (present for most inputs)
`native_balance_wei`	string	Usually (present for most inputs)
`token_transfer_count`	number	Usually (present for most inputs)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "wallet-balance-lookup",
    "inputs": {},
    "max_price_cents": 2
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "wallet-balance-lookup",
    "inputs": {},
    "max_price_cents": 2
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "wallet-balance-lookup",
  inputs: {},
  max_price_cents: 2,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="wallet-balance-lookup",
    inputs={},
    max_price_cents=2,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/wallet-balance-lookup?'

Limitations

Output reflects Alchemy's JSON-RPC and transfer index for the requested chain at query time. Dependent on upstream API availability; may degrade if the provider rate-limits or is temporarily unavailable.
Chains covered
Covers Ethereum (1), Base (8453), Arbitrum One (42161), OP Mainnet (10) and Polygon PoS (137) through Alchemy; other `chain_id` values are refused. Values use the chain’s native coin named in `native_symbol`, including POL on Polygon.