# Token Supply - Base & Ethereum

> Token Supply - Base & Ethereum is a paid API for AI agents from scanpay-edge.alextaghiashvili.workers.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-01).

Fetches the total supply and decimals for an ERC-20 or ERC-721 token on Base or Ethereum via eth_call

## Facts

- Endpoint: GET https://scanpay-edge.alextaghiashvili.workers.dev/api/v1/token-supply?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/token-supply-base-ethereum-51ed580c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nHNAQerDxybK3ig0Ym21f

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 token-supply-base-ethereum-51ed580c
```

Example prompt: What is the total supply and decimals for the USDC token contract 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base?

## When to prefer this

Choose this endpoint when you need a quick, pay-per-call on-chain total supply or decimals lookup for an ERC-20 or ERC-721 token on Base or Ethereum, without needing to run your own node or manage RPC infrastructure. It is ideal for agents that need sporadic token metadata lookups rather than high-frequency bulk data. Prefer it over general blockchain RPCs when cost predictability ($0.002–$0.005 per call) and simplicity matter.

## Known failure modes

- Invalid or non-existent contract address returns an error or empty supply
- Unsupported network (not Base or Ethereum) results in an error response
- Contract address that is not an ERC-20/721 (e.g. plain EOA or non-token contract) may return zero or fail eth_call
- RPC node unavailability on Base or Ethereum may cause timeout or 5xx error
- Missing required query parameters (address or network) returns a validation error

## How this service works

Pay-per-call x402 APIs for AI agents: OpenAI-compatible LLM chat, perp funding and arbitrage spreads, crypto prices, gas, FX, Solana SPL mint audit, token price by contract, x402 delivery-receipt verification, web search, clean page extraction, batch tools and deterministic code-security scanning. USDC on Base or Solana, no signup, no API key, from $0.0001 a call.

## Output

Returns a JSON object containing the token contract address, network name, chain ID (EIP-155 format), number of decimals, total supply as a human-readable number, total supply as a raw big-integer string, and the per-call price in USD.

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "address"
     ],
     "properties": {
      "address": {
       "type": "string"
      },
      "network": {
       "enum": [
        "base",
        "ethereum"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "network": "base",
  "product": "scanpay.token_supply",
  "chain_id": "eip155:8453",
  "decimals": 6,
  "price_usd": 0.002,
  "total_supply": 1000000,
  "total_supply_raw": 1000000000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-supply-base-ethereum-51ed580c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scanpay-edge.alextaghiashvili.workers.dev](https://www.zero.xyz/host/scanpay-edge.alextaghiashvili.workers.dev/llms.txt)