# EVM Token Info and Total Supply

> EVM Token Info and Total Supply is a paid API for AI agents from apexfaucet.xyz, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-30).

Returns metadata and total supply for an ERC20 token on Ethereum, Base, Arc, or BNB Chain

## Facts

- Endpoint: GET https://apexfaucet.xyz/api/x402/evm-token-info?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/evm-token-info-and-total-supply-ec85a439
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SmX6siRT8ENOPRpD9Obyq

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 evm-token-info-and-total-supply-ec85a439
```

Example prompt: What's the name, symbol, decimals, and total supply of the token at contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Choose this endpoint when you need on-chain ERC20 token metadata (name, symbol, decimals, total supply) directly from the blockchain across Ethereum, Base, Arc, or BNB Chain. It is ideal for DeFi agents that need to verify a token's identity before executing a trade, for token screeners that need to enrich contract addresses with metadata, or for any workflow that requires authoritative on-chain supply figures rather than cached off-chain data.

## Known failure modes

- Invalid or non-ERC20 contract address returns an error or empty data
- Unsupported chain value results in a validation error
- Token contract exists but has no standard name/symbol/decimals (non-standard ERC20) may return partial data
- Payment of 0.001 USDC not provided results in 402 Payment Required
- Network latency or RPC issues on the target chain may cause timeouts

## How this service works

Token info and total supply for any ERC20 on Ethereum, Base, Arc or BNB Chain: name, symbol, decimals and total supply (raw and in token units), read at a named block. A contract that is not an ERC20 is refused before any charge.

## Output

Returns a JSON object with ok status, and a data object containing the token name, symbol, decimals, total supply (as a human-readable string), total supply as a raw integer, the block number at which the data was read, the block timestamp, and the chain and contract address queried. Also includes the amount paid in USDC for the 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",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "ethereum",
        "base",
        "arc",
        "bnb"
       ],
       "type": "string",
       "description": "Chain to read: ethereum, base, arc or bnb. Default ethereum."
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "ERC20 token contract."
      }
     }
    }
   }
  },
  "output": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "properties": {
   "ok": {
    "type": "boolean"
   },
   "data": {
    "type": "object"
   },
   "paid": {
    "type": "number"
   }
  }
 },
 "example": {
  "ok": true,
  "data": {
   "ok": true,
   "name": "USD Coin",
   "block": 52560086,
   "chain": "base",
   "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
   "symbol": "USDC",
   "decimals": 6,
   "blockTime": "2026-10-13T16:38:39.000Z",
   "totalSupply": "4403027971.940867",
   "totalSupplyRaw": "4403027971940867"
  },
  "paid": 0.001
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/evm-token-info-and-total-supply-ec85a439/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apexfaucet.xyz](https://www.zero.xyz/host/apexfaucet.xyz/llms.txt)