# signals.edge.report Wallet Balance

> signals.edge.report Wallet Balance is a paid API for AI agents from signals.edge.report, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns live ETH balance, USDC ERC20 balance, and transaction nonce for an EVM wallet address on Base (with optional Ethereum mainnet support).

## Facts

- Endpoint: GET https://signals.edge.report/v1/wallet
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/signals-edge-report-wallet-balance-cfd40e99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qK_3Jboabv0PmdvTfN_Vd

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability signals-edge-report-wallet-balance-cfd40e99
```

Example prompt: What's the live ETH and USDC balance on Base for wallet 0x1234...abcd, and what's its current transaction nonce?

## When to prefer this

Choose this endpoint when you need a single, real-time snapshot of both native ETH and USDC ERC20 balances plus the transaction nonce for a wallet on Base. It is especially useful for agents that need to verify funds before executing transactions, monitor wallet state in DeFi workflows, or resolve nonce issues, all in one API call rather than making separate RPC requests.

## Known failure modes

- Invalid or malformed EVM address returns an error
- Address not found on Base returns zero balances
- Missing required `address` query parameter returns a 400-level error
- Network or RPC connectivity issues may cause timeouts or 5xx errors
- Ethereum mainnet balances unavailable if mainnet RPC is not configured

## How this service works

Live wallet balance on Base: native ETH, USDC ERC20 balanceOf, and transaction nonce. Optional Ethereum mainnet balances when ETH RPC is configured.

## Output

Returns the native ETH balance, USDC ERC20 balance (via balanceOf), and the transaction nonce for the specified EVM address on Base. If an Ethereum mainnet RPC is configured, equivalent balances on mainnet are also returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string",
       "description": "EVM address for live wallet balance (ETH + USDC) and nonce"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "base": {
   "eth": "0.01",
   "usdc": "12.5",
   "nonce": 3
  },
  "address": "0x0000000000000000000000000000000000000001",
  "product": "wallet-scan",
  "ethereum": null
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/signals-edge-report-wallet-balance-cfd40e99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from signals.edge.report](https://www.zero.xyz/host/signals.edge.report/llms.txt)