# AllTheBot ERC-20 Token Info (Base)

> AllTheBot ERC-20 Token Info (Base) 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-12).

Returns the name, symbol, decimals, and total supply of any ERC-20 token contract deployed on the Base network, read live on-chain.

## Facts

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

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-token-info-base-645ceb1d
```

Example prompt: Can you look up the on-chain info for the Base token at address 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 — I need its name, symbol, decimals, and total supply before I accept it as payment.

## When to prefer this

Use this endpoint when you need live, authoritative on-chain ERC-20 metadata specifically on the Base network — not a cached or third-party price feed. It is ideal for due-diligence checks before accepting tokens, verifying token identity against a contract address, or populating token metadata in a wallet or DeFi application. Prefer it over price APIs when you need decimals or total supply rather than price, and over Ethereum equivalents when the token is deployed on Base.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error (address must match ^0x[0-9a-fA-F]{40}$)
- Address is a wallet (EOA) rather than a token contract — no ERC-20 interface available
- Token contract exists but does not implement standard ERC-20 metadata (name/symbol/decimals may be missing)
- Network congestion or RPC issues may cause delayed or failed on-chain reads
- Malformed address format (wrong length, missing 0x prefix) rejected before the call

## 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 contract address, its human-readable name, ticker symbol, number of decimals, the network ('base'), the formatted total supply as a decimal string, and the raw total supply as an integer string — all read live from the Base blockchain.

## 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": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "network": "base",
  "decimals": 6,
  "total_supply": "4380511974.486329",
  "total_supply_raw": "4380511974486329"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/allthebot-erc-20-token-info-base-645ceb1d/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)
