# Delx Base ERC-20 Balance

> Delx Base ERC-20 Balance is a paid API for AI agents from api.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Returns the ERC-20 token balance of a holder address on Base mainnet by executing a balanceOf eth_call, charged at $0.001 USDC per call via x402.

## Facts

- Endpoint: POST https://api.delx.ai/api/v1/x402/base-token-balance
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-base-erc-20-balance-de5293d8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_p30LfDiwSRdTBRgolJFFm

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 delx-base-erc-20-balance-de5293d8 -d '<json body>'
```

Example prompt: What's the ERC-20 token balance of wallet 0xAbC...123 for the token contract 0xDef...456 on Base mainnet?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call on-chain ERC-20 balance lookup on Base mainnet without managing your own RPC node or API keys. It is ideal for agents that need to gate actions on token holdings, verify balances before transactions, or enrich user profiles with live on-chain data on Base L2, especially in x402-compatible payment flows.

## Known failure modes

- Invalid or malformed wallet address returns an error or zero balance
- Invalid token contract address (not an ERC-20) may return an error or empty result
- Network issues with Base mainnet RPC may cause timeouts
- Payment failure via x402 prevents the call from executing
- Non-Base contract addresses (e.g. Ethereum mainnet) will return incorrect or no results

## How this service works

ERC-20 balanceOf for a holder on Base mainnet for $0.001 USDC via eth_call. Call when you need this bounded result without an API key or subscription. Returns machine-readable JSON via x402 on Base or Solana. Limitation: results cover only the supplied input or one bounded public endpoint at request time; callers must verify before acting.

## Output

Returns the raw ERC-20 balanceOf result for the specified holder and token contract on Base mainnet, reflecting the on-chain token amount as returned by the eth_call. Typically includes the balance as a numeric value (likely in the token's smallest unit, e.g. wei-equivalent).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "token": {
   "type": "string"
  },
  "address": {
   "type": "string"
  },
  "decimals": {
   "type": "integer",
   "maximum": 36,
   "minimum": 0
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {},
  "tool_name": "get_base_token_balance"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-base-erc-20-balance-de5293d8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.delx.ai](https://www.zero.xyz/host/api.delx.ai/llms.txt)
