# ERC-20 Total Supply on Base

> ERC-20 Total Supply on Base is a paid API for AI agents from x402-data-api.sigrunner.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-20).

Returns the total circulating supply of any ERC-20 token on Base, in both raw integer and decimal-adjusted formatted form, along with symbol and decimals.

## Facts

- Endpoint: GET https://x402-data-api.sigrunner.workers.dev/chain/total-supply?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/erc-20-total-supply-on-base-c888f0ce
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_e6U4h2GY-464Q_G71h4Rl

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 erc-20-total-supply-on-base-c888f0ce
```

Example prompt: What's the total supply of USDC on Base — give me both the raw number and the formatted amount with decimals — the contract address is 0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913.

## When to prefer this

Choose this endpoint when you need the total supply of an ERC-20 token specifically on the Base chain, particularly for market cap computation, dilution math, or tokenomics analysis. It returns both raw and decimal-adjusted supply in one call, saving you the need to separately fetch decimals and divide. Prefer it over generic blockchain RPC calls when you want a clean JSON response without manually decoding ABI-encoded output.

## Known failure modes

- Invalid or non-ERC-20 contract address returns an error or empty response
- Non-Base chain addresses will not return valid data (Base-only endpoint)
- Missing 'token' query parameter may return a default or error response
- Contract address with no total supply function (non-standard ERC-20) may fail
- Rate limiting or payment failure ($0.003 USDC per call) blocks the request

## How this service works

ERC-20 total supply on Base, raw + formatted with decimals and symbol. Use when an agent needs a token's circulating-supply base for market-cap or dilution math.

## Output

A JSON object containing the Base chain identifier, the queried token contract address, the token symbol (e.g. 'USDC'), the number of decimals, the formatted total supply as an integer, and the raw total supply as a string (unscaled by decimals). Example: {chain: 'base', token: '0x833...', symbol: 'USDC', decimals: 6, total_supply: 3500000000, total_supply_raw: '3500000000000000'}.

## 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",
     "properties": {
      "token": {
       "type": "string",
       "description": "0x-prefixed ERC-20 contract address on Base"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "token",
      "symbol",
      "decimals",
      "total_supply_raw",
      "total_supply",
      "chain"
     ],
     "properties": {
      "chain": {
       "type": "string"
      },
      "token": {
       "type": "string"
      },
      "symbol": {
       "type": "string"
      },
      "decimals": {
       "type": "integer"
      },
      "total_supply": {
       "type": "integer"
      },
      "total_supply_raw": {
       "type": "string"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "chain": "base",
  "token": "0x833589fCd6eDb6E08f4c7C32D4f71b54bdA02913",
  "symbol": "USDC",
  "decimals": 6,
  "total_supply": 3500000000,
  "total_supply_raw": "3500000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/erc-20-total-supply-on-base-c888f0ce/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-data-api.sigrunner.workers.dev](https://www.zero.xyz/host/x402-data-api.sigrunner.workers.dev/llms.txt)