# Vextorium EVM Token Supply

> Vextorium EVM Token Supply is a paid API for AI agents from api.vextorium.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-19).

Returns the name, symbol, decimals, and circulating supply of any ERC-20 token on 12 supported EVM chains given a contract address.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/evm-token-supply?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-evm-token-supply-7ce451ee
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_-QZyvVUxp_VY2hsxj8yCz

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 vextorium-evm-token-supply-7ce451ee -d '<json body>'
```

Example prompt: What is the total circulating supply, symbol, and decimals for the USDC contract at 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Use this endpoint when you need authoritative on-chain ERC-20 token supply data — including name, symbol, decimals, and both human-readable and raw integer supply — from any of 12 supported EVM chains. Prefer it over price-feed APIs when you specifically need supply figures rather than price, and over generic RPC calls when you want a structured JSON response without handling ABI encoding.

## Known failure modes

- Invalid or non-ERC-20 contract address returns null fields or an error
- Unsupported network name results in a validation error
- Contract exists but has no standard totalSupply function returns null supply
- Network congestion may cause RPC timeout
- Malformed contract address (wrong checksum or length) returns an error

## How this service works

558 pay-per-call data APIs for AI agents: Solana and EVM on-chain data, tokenized stocks, DeFi, Hyperliquid, economy and official statistics, FX, validation, web and developer tools. Pay in USDC via x402.

## Output

A JSON object containing the token's name, symbol, decimals, human-readable floating-point supply, raw gross supply string (no decimals applied), the queried contract address, and the network — e.g. {name:'USD Coin', symbol:'USDC', supply:4349847314.41, decimals:6, gross_supply:'4349847314410437', network:'base', contract:'0x833589...'}.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon",
    "bnb",
    "avalanche",
    "gnosis",
    "line",
    "scroll",
    "sonic",
    "unichain"
   ],
   "type": "string",
   "description": "Chain (default base)"
  },
  "contract": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "USD Coin",
  "supply": 4349847314.410437,
  "symbol": "USDC",
  "network": "base",
  "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "decimals": 6,
  "gross_supply": "4349847314410437"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-evm-token-supply-7ce451ee/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.vextorium.com](https://www.zero.xyz/host/api.vextorium.com/llms.txt)