Optimism native balance
Read the native ETH balance of any 0x address on Optimism at the latest block, in wei and in ETH. Use to check whether a wallet can pay gas or a transfer; for ERC-20 tokens use op_token_balance, for all holdings at once use wallet_portfolio. A malformed address is rejected with 400, uncharged.
Inputs
| Name | Type | Description |
|---|---|---|
address (required) | string | 0x wallet or contract address |
Request
Over HTTP, with a card key from /credits:
curl -H "Authorization: Bearer adt_…" "https://agent-data-tools.revmesh2074.workers.dev/op/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
Or one of your 25 free calls, no key:
curl "https://agent-data-tools.revmesh2074.workers.dev/op/balance?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045&trial=1"
Without a key, the same URL answers 402 Payment Required with x402 and MPP terms, so an agent with a wallet pays per call in USDC (Base, Polygon, Arbitrum, Monad, World Chain or Tempo) and retries.
Example result
{
"chain": "Optimism",
"chainId": 10,
"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"balanceWei": "1234500000000000000",
"balance": "1.2345",
"symbol": "ETH",
"block": 123456789
}
From an AI agent (MCP)
Add the MCP server to Claude, Cursor or any MCP client. This tool is op_balance, and the first 25 successful calls are free:
https://agent-data-tools.revmesh2074.workers.dev/mcp