# clonecho.builda.company On-Chain ERC-20 Read Oracle

> clonecho.builda.company On-Chain ERC-20 Read Oracle is a paid API for AI agents from clonecho.builda.company, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Reads ERC-20 token totalSupply and balanceOf on-chain via RPC for a given chain, token contract, and holder address, returning decimals-adjusted values as JSON.

## Facts

- Endpoint: POST https://clonecho.builda.company/x402/onchain-read
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clonecho-builda-company-on-chain-erc-20-read-oracle-5a4d4b49
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LzxGJ2nNIGvhtZ9lSWj0u

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 clonecho-builda-company-on-chain-erc-20-read-oracle-5a4d4b49 -d '<json body>'
```

Example prompt: What's the USDC balance of wallet 0xAbC...123 on Base, and what's the total supply? The token contract is 0xDef...456 and it uses 6 decimals.

## When to prefer this

Use this endpoint when you need a deterministic, trustless read of on-chain ERC-20 token balances or total supply without running your own Ethereum-compatible node. Ideal for agents that need to verify token holdings, check token supply on Base, or enrich data with real-time on-chain state via a simple HTTP GET call with x402 micropayment.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or zero values
- Unsupported chain parameter returns an error
- Malformed wallet address causes RPC failure
- RPC node unavailability causes timeout or 5xx error
- Missing required query parameters (chain, token, holder) result in bad request error

## How this service works

ON-CHAIN READ: read ERC-20 totalSupply / balanceOf (?chain=base&token=&holder=&decimals=) via RPC — a deterministic oracle. Returns JSON.

## Output

A JSON object containing the ERC-20 totalSupply and balanceOf values for the specified token contract and holder address on the given chain, adjusted by the provided decimals.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clonecho-builda-company-on-chain-erc-20-read-oracle-5a4d4b49/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from clonecho.builda.company](https://www.zero.xyz/host/clonecho.builda.company/llms.txt)