# Vextorium ERC-20 Token Supply & Concentration

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

Returns total minted, burned, approximate circulating supply, and contract owner balance/share for any ERC-20 token — a concentration and issuer-control signal.

## Facts

- Endpoint: POST https://api.vextorium.com/v1/token-supply?utm_source=zero.xyz
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-erc-20-token-supply-concentration-0ee83fce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2331GiIMDVNnADVz_fJSm

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-erc-20-token-supply-concentration-0ee83fce -d '<json body>'
```

Example prompt: What's the total supply, burned amount, and owner concentration for the PEPE token at 0x6982508145454Ce325dDbE47a25d4ec3d2311933 on Ethereum?

## When to prefer this

Use this endpoint when you need a quick on-chain snapshot of an ERC-20 token's supply economics — especially total vs. circulating supply, burn metrics, and owner concentration risk — across the five major EVM networks (Ethereum, Base, Arbitrum, Optimism, Polygon). Prefer it over generic block explorer lookups when you want a pre-computed, structured concentration signal without writing custom RPC calls.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty result
- Unsupported network (not base, ethereum, arbitrum, optimism, or polygon) returns a validation error
- Contract exists but has no detectable owner (owner field returns null)
- Dead-address burn detection is approximate and may miss non-standard burn mechanisms
- RPC latency on the target chain may cause timeout or stale data

## 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, network, decimals, total supply, burned amount (tokens sent to dead addresses), burned percentage, approximate circulating supply, and — if applicable — the contract owner's address and balance/share, all as numeric and string fields.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "network": {
   "enum": [
    "base",
    "ethereum",
    "arbitrum",
    "optimism",
    "polygon"
   ],
   "type": "string"
  },
  "contract": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "name": "Pepe",
  "owner": null,
  "token": "0x6982508145454Ce325dDbE47a25d4ec3d2311933",
  "burned": 6917544537127.74,
  "symbol": "PEPE",
  "network": "ethereum",
  "decimals": 18,
  "burned_pct": 1.6443,
  "total_supply": 420689899645071.7,
  "circulating_approx": 413772355107943.9
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-erc-20-token-supply-concentration-0ee83fce/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)