# Money Reactor ERC-20 Balance Lookup (Base Network)

> Money Reactor ERC-20 Balance Lookup (Base Network) is a paid API for AI agents from mr-river3.makar52nn2016.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-19).

Returns the ERC-20 token balance for a given wallet address and token contract on the Base network, paid per call in USDC via x402.

## Facts

- Endpoint: GET https://mr-river3.makar52nn2016.workers.dev/api/erc20-balance?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/money-reactor-erc-20-balance-lookup-base-network-137c26fb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pBgvAHj2qtV36YUVTqRxu

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 money-reactor-erc-20-balance-lookup-base-network-137c26fb
```

Example prompt: What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Base — use the USDC contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913?

## When to prefer this

Use this endpoint when you need to query a specific ERC-20 token balance for any wallet on the Base network without setting up API keys or accounts. It is ideal for AI agents operating autonomously that need on-chain token data with pay-per-call economics via x402. Prefer this over node provider SDKs when you want zero-setup, micro-payment-based access to Base blockchain state.

## Known failure modes

- Invalid or malformed wallet address returns an error response
- Invalid or non-existent contract address may return zero balance or an error
- Token contract not deployed on Base returns an error or empty result
- Insufficient USDC payment for x402 settlement causes a 402 Payment Required response
- Network congestion or RPC outage on Base may cause timeouts or errors

## How this service works

60+ agent-native micro APIs paid per call in USDC on Base via x402: fresh market data every call (market cap, top movers, funding rates, orderbook, RSI trading checklist, volatility, cycle position), funded bounty radar, honeypot trust scoring, token safety verdicts, AI chat (Llama 3.1), web reader, ERC-20 balances. No accounts, no API keys — instant on-chain settlement.

## Output

A JSON object containing the token symbol, human-readable balance (float), raw balance string, number of decimals, wallet address, token contract address, and the network name ('base').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "queryParams": {
     "type": "object",
     "properties": {
      "address": {
       "type": "string",
       "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
       "description": "Wallet address 0x... (alias: wallet)"
      },
      "contract": {
       "type": "string",
       "example": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
       "description": "Token contract address 0x... (alias: token)"
      }
     }
    }
   }
  },
  "output": {
   "type": "object",
   "properties": {
    "example": {
     "symbol": "USDC",
     "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
     "balance": 42.5,
     "network": "base",
     "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
     "decimals": 6,
     "balanceRaw": "42500000"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "symbol": "USDC",
  "address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "balance": 42.5,
  "network": "base",
  "contract": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "decimals": 6,
  "balanceRaw": "42500000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/money-reactor-erc-20-balance-lookup-base-network-137c26fb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mr-river3.makar52nn2016.workers.dev](https://www.zero.xyz/host/mr-river3.makar52nn2016.workers.dev/llms.txt)
