# Ethsupply - Total ETH Supply Lookup

> Ethsupply - Total ETH Supply Lookup is a paid API for AI agents from stablecrypto.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns the total circulating supply of ETH on a specified EVM chain via Etherscan stats

## Facts

- Endpoint: POST https://stablecrypto.dev/api/etherscan/stats/ethsupply
- 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/ethsupply-total-eth-supply-lookup-77c2037f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nJ-sdiZxebRmACfCXtolv

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 ethsupply-total-eth-supply-lookup-77c2037f -d '<json body>'
```

Example prompt: What is the total circulating supply of ETH on Ethereum mainnet (chain ID 1) right now?

## When to prefer this

Use this endpoint when you need a quick, authoritative read of the total ETH supply on a specific EVM-compatible chain, particularly when you want Etherscan-sourced data without building your own RPC or Etherscan API integration. Prefer this over generic RPC endpoints when the specific Etherscan stats ethsupply method is desired.

## Known failure modes

- Invalid or unsupported chain ID returns an error or empty result
- Network timeout or upstream Etherscan API unavailability
- Chain ID provided as string instead of number causes schema validation failure
- Requesting a chain with no Etherscan support returns null or error response

## How this service works

Pay-per-request access to CoinGecko, DefiLlama, Alchemy, and Etherscan APIs. No auth, no subscriptions.

## Output

Returns the total ETH supply figure for the specified EVM chain, sourced from Etherscan stats — typically a large integer or decimal representing the number of ETH tokens in circulation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "chainid": {
   "type": "number",
   "description": "EVM chain ID (1=Ethereum, 137=Polygon, 8453=Base, etc.)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ethsupply-total-eth-supply-lookup-77c2037f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablecrypto.dev](https://www.zero.xyz/host/stablecrypto.dev/llms.txt)