# Financial Data x402 – Ethereum Total Supply

> Financial Data x402 – Ethereum Total Supply is a paid API for AI agents from x402financialdata.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the current total supply of Ether (ETH) on the Ethereum mainnet, in both human-readable decimal and raw wei units

## Facts

- Endpoint: GET https://x402financialdata.com/eth-supply
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/financial-data-x402-ethereum-total-supply-6cbb7cd6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n8N2NMPLKqjn59XlmkBI1

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 financial-data-x402-ethereum-total-supply-6cbb7cd6
```

Example prompt: What is the current total supply of ETH on Ethereum mainnet right now, including the value in wei?

## When to prefer this

Choose this endpoint when you need a quick, no-subscription, pay-per-call lookup of Ethereum's total supply with both decimal and wei precision. Ideal for agents or pipelines that query supply infrequently and want to avoid API key management, or when operating in a crypto-native payment context using USDC on Base or Solana via the x402 protocol.

## Known failure modes

- Payment not received or insufficient USDC balance — returns HTTP 402
- Network or upstream data source unavailability — may return 5xx error
- Stale data if the upstream on-chain indexer has a lag — timestamp may be slightly behind real-time
- Malformed request headers — returns 4xx error

## How this service works

Pay-per-call stock, macro, on-chain, and crypto data over the x402 protocol. USDC on Base or Solana, no API keys, no subscriptions.

## Output

A JSON object containing the chain identifier ('eth'), the total ETH supply as a floating-point decimal (e.g. 122373866.22 ETH), the total supply expressed in wei as a string, and a timestamp indicating when the data was last updated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "as_of": "2026-07-31T03:43:30.000000",
  "chain": "eth",
  "total_supply": 122373866.2178,
  "total_supply_wei": "122373866217800000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/financial-data-x402-ethereum-total-supply-6cbb7cd6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402financialdata.com](https://www.zero.xyz/host/x402financialdata.com/llms.txt)