# AllTheBot ERC-20 Info (ETH)

> AllTheBot ERC-20 Info (ETH) is a paid API for AI agents from api.zkrobotics.fr, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-13).

Returns the name, symbol, decimals, and total supply of any ERC-20 token contract on Ethereum mainnet via live eth_call.

## Facts

- Endpoint: GET https://api.zkrobotics.fr/x402/eth/token?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/allthebot-erc-20-info-eth-b6c59924
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZlbVNTla2dA8mch7OuSwK

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 allthebot-erc-20-info-eth-b6c59924
```

Example prompt: What are the name, symbol, decimals, and total supply of the ERC-20 token at Ethereum contract address 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48?

## When to prefer this

Use this endpoint when you need live, on-chain ERC-20 token metadata (name, symbol, decimals, total supply) for any token on Ethereum mainnet specifically. It reads directly via eth_call so data is always current, unlike indexed APIs that may lag. Prefer it over blockchain explorer scraping or general-purpose RPC calls when you want a structured, pay-per-call response without managing your own Ethereum node.

## Known failure modes

- Invalid or malformed contract address (not matching 0x + 40 hex chars) returns a validation error
- Address is a wallet or non-ERC-20 contract — eth_call may return zero/empty values or an error
- Contract deployed on a non-Ethereum network will not be found on mainnet
- Network congestion or RPC node unavailability may cause timeouts
- Proxy or upgradeable contracts may return unexpected metadata

## How this service works

Pay-per-call APIs for AI agents over x402: token safety reports, Base and Ethereum on-chain reads, crypto prices, domain checks (DNS, WHOIS, SSL, email), finance data (FX, SEC), worldwide weather forecasts, France alerts, text AI, fun content. USDC on Base, no account, no API key.

## Output

A JSON object containing the token's contract address, human-readable name, symbol, decimal precision, formatted total supply as a string, and raw total supply as an integer string — all read live from Ethereum mainnet via eth_call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "token": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "symbol": "USDC",
  "network": "ethereum",
  "decimals": 6,
  "total_supply": "48993471495.266895",
  "total_supply_raw": "48993471495266895"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allthebot-erc-20-info-eth-b6c59924/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.zkrobotics.fr](https://www.zero.xyz/host/api.zkrobotics.fr/llms.txt)