# Vextorium ERC-20/ERC-721 Token Supply & Metadata Lookup

> Vextorium ERC-20/ERC-721 Token Supply & Metadata Lookup 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-10).

Returns the totalSupply, name, symbol, and decimals of any ERC-20 token or ERC-721 collection on 12 supported EVM chains

## Facts

- Endpoint: POST https://api.vextorium.com/evm-suministro-pago?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vextorium-erc-20-erc-721-token-supply-metadata-lookup-621ba5eb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dqtmcuMljqOVloKYXdAwM

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-erc-721-token-supply-metadata-lookup-621ba5eb -d '<json body>'
```

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

## When to prefer this

Use this endpoint when you need on-chain token metadata (name, symbol, decimals, totalSupply) for ERC-20 tokens or ERC-721 NFT collections across 12 major EVM networks including Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic, and Unichain. Prefer this over block explorer scraping or general RPC calls when you want a simple, paid API that abstracts multi-chain access and returns normalized, human-readable supply figures alongside the raw integer.

## Known failure modes

- Invalid or non-existent contract address returns null fields or error
- Unsupported chain not in the enum list causes validation failure
- Contract address that is not ERC-20 or ERC-721 may return null for name/symbol/supply
- Network timeout or RPC node issues for the target chain
- Malformed contract address (not checksummed EVM address) causes rejection

## How this service works

totalSupply of an ERC-20 token or ERC-721 collection with name, symbol and decimals. Works on Base, Ethereum, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Gnosis, Linea, Scroll, Sonic and Unichain.

## Output

A JSON object containing the chain name, token contract address, token name (nombre), symbol (simbolo), number of decimals, human-readable total supply (suministro), and raw integer total supply string (suministro_bruto).

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "required": [
      "contrato"
     ],
     "properties": {
      "red": {
       "enum": [
        "base",
        "ethereum",
        "arbitrum",
        "optimism",
        "polygon",
        "bnb",
        "avalanche",
        "gnosis",
        "linea",
        "scroll",
        "sonic",
        "unichain"
       ],
       "type": "string",
       "description": "Chain (default base)"
      },
      "contrato": {
       "type": "string"
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": [
      "object",
      "null"
     ],
     "properties": {
      "red": {
       "type": [
        "string",
        "null"
       ]
      },
      "nombre": {
       "type": [
        "string",
        "null"
       ]
      },
      "simbolo": {
       "type": [
        "string",
        "null"
       ]
      },
      "contrato": {
       "type": [
        "string",
        "null"
       ]
      },
      "decimales": {
       "type": [
        "number",
        "null"
       ]
      },
      "suministro": {
       "type": [
        "number",
        "null"
       ]
      },
      "suministro_bruto": {
       "type": [
        "string",
        "null"
       ]
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "red": "base",
  "nombre": "USD Coin",
  "simbolo": "USDC",
  "contrato": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "decimales": 6,
  "suministro": 4349847314.410437,
  "suministro_bruto": "4349847314410437"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vextorium-erc-20-erc-721-token-supply-metadata-lookup-621ba5eb/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)