# Foundry ERC-20 & Native Token Balance Lookup

> Foundry ERC-20 & Native Token Balance Lookup is a paid API for AI agents from minty-sprout.onrender.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-11-01).

Returns the ERC-20 token balance (and native coin balance) for any wallet address on Base, Ethereum, Arbitrum, Optimism, or Polygon, supporting USDC, USDT, DAI, WETH, or any custom token contract address.

## Facts

- Endpoint: POST https://minty-sprout.onrender.com/v1/erc20-balance?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/foundry-erc-20-native-token-balance-lookup-a2a8bafa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nG1XT-SZpK5lzq-OIRL0u

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 foundry-erc-20-native-token-balance-lookup-a2a8bafa -d '<json body>'
```

Example prompt: What's the USDC balance for wallet 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum, and also show me its native ETH balance?

## When to prefer this

Use this endpoint when you need on-chain ERC-20 or native token balances across the major EVM networks (Base, Ethereum, Arbitrum, Optimism, Polygon) without managing your own RPC infrastructure. Ideal for agents that need to verify wallet holdings, audit DeFi positions, or check stablecoin balances programmatically at low cost ($0.002 per call).

## Known failure modes

- Invalid or malformed wallet address returns an error
- Unsupported chain name causes a lookup failure
- Unknown token symbol with no contract address provided may return zero or error
- Network timeout or RPC node unavailability on the target chain
- Incorrect token contract address returns zero balance or error

## How this service works

ERC-20 token balance for any wallet on Base, Ethereum, Arbitrum, Optimism or Polygon (USDC, USDT, DAI, WETH or any address), plus native balance. Input: 'wallet token chain'.

## Output

A JSON object containing the chain name, token symbol, wallet address, human-readable balance (float), token decimals, raw balance string, token contract address, and the wallet's native coin balance (e.g. ETH on Ethereum/Base/Arbitrum/Optimism, MATIC on Polygon).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "input": {
   "type": "string",
   "maxLength": 8000,
   "description": "'<wallet> <token symbol or address> <chain>'"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "ethereum",
  "token": "USDC",
  "wallet": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "balance": 39.192124,
  "decimals": 6,
  "raw_balance": "39192124",
  "token_address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "native_balance": 5.779567498611001
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/foundry-erc-20-native-token-balance-lookup-a2a8bafa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from minty-sprout.onrender.com](https://www.zero.xyz/host/minty-sprout.onrender.com/llms.txt)