# ERC20 Token Snapshot (Balance, Supply & Allowance)

> ERC20 Token Snapshot (Balance, Supply & Allowance) is a paid API for AI agents from the-stall.intuitek.ai, paid per call via x402, $0.007/call, status unknown (last checked 2026-09-15).

Fetches a snapshot of an ERC20 token contract including total supply, decimals, name, symbol, and optionally a wallet's balance and spender allowance.

## Facts

- Endpoint: GET https://the-stall.intuitek.ai/cap/erc20-snapshot
- Price: $0.007/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc20-token-snapshot-balance-supply-allowance-e5f47b1f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Dt7jDXrFybsZGLr6e5RqT

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 erc20-token-snapshot-balance-supply-allowance-e5f47b1f
```

Example prompt: Pull a snapshot of the ERC20 token at contract 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 on Ethereum — give me the name, symbol, total supply, and also check the token balance for wallet 0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe.

## When to prefer this

Use this endpoint when you need on-chain ERC20 token data (supply, balance, allowance, metadata) across major EVM chains without requiring an API key or account — ideal for AI agents making microtransaction-priced blockchain data queries via x402/USDC payment on Base mainnet.

## Known failure modes

- Invalid or malformed contract address returns an error
- Contract address is not an ERC20 token (e.g. ERC721) — may return zero or error
- Unsupported network value returns validation error
- Wallet address required when checking allowance but not provided — returns error
- RPC node unavailability may cause timeouts or empty responses

## How this service works

Complete ERC20 token state in one call: name, symbol, decimals, total supply (raw + formatted), wallet balance, and allowance. Collapses four onesource chain calls (total-supply + erc20-balance + allowance + contract — 155–229 payers each) into one $0.007 payment — 36% below the $0.011 combined chain. Supports Ethereum (default), Base, Polygon, Arbitrum. No API key required.

## Output

Returns ERC20 token metadata (name, symbol, decimals, total supply) for the given contract. If a wallet address is provided, also returns the wallet's token balance. If both wallet and spender addresses are provided, also returns the allowance the spender has on the wallet's tokens.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "wallet": "0xde0B295669a9FD93d5F28D9Ec85E40f4cb697BAe",
   "network": "ethereum",
   "contract": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc20-token-snapshot-balance-supply-allowance-e5f47b1f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from the-stall.intuitek.ai](https://www.zero.xyz/host/the-stall.intuitek.ai/llms.txt)