← All tools

base-wallet-balance

Read a wallet's live native ETH balance on Base at the latest block without an API key.

Price

$0.01 USDC equivalent

Endpoint

POST /v1/base-wallet-balance

Network

Base mainnet · eip155:8453

Asset

USDC

MCP tool

base-wallet-balance

External payability

PASS · 2026-10-08T19:55:01.298Z

When an agent should use it

• Base wallet balance API
• read native ETH balance on Base
• live wallet state for an autonomous agent

Input schema

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    }
  },
  "required": [
    "address"
  ],
  "additionalProperties": false
}

Example request

{
  "address": "0x0000000000000000000000000000000000000001"
}

Example output

{
  "balance_wei": "0",
  "balance_eth": "0",
  "block_number": 12345678,
  "network": "eip155:8453"
}

x402 flow

POST /v1/base-wallet-balance
→ HTTP 402 + PAYMENT-REQUIRED
→ buyer authorizes locally
→ retry same request with PAYMENT-SIGNATURE
→ one governed execution + machine-readable JSON

Discovery: OpenAPI · x402 · llms.txt

A valid 402/payability probe is operational evidence, not proof of independent demand, future settlement, or semantic correctness.