# x402node Crypto Token Supply Lookup

> x402node Crypto Token Supply Lookup is a paid API for AI agents from api.x402node.dev, paid per call via x402, $0.0022/call, status unknown (last checked 2026-09-14).

Returns circulating, total, and max supply data along with market cap and fully-diluted valuation for one or more cryptocurrency tokens by ticker symbol or CoinGecko ID.

## Facts

- Endpoint: GET https://api.x402node.dev/crypto/supply
- Price: $0.0022/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402node-crypto-token-supply-lookup-0e416e73
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uGwoN7RiX6w-N_t51ngWX

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 x402node-crypto-token-supply-lookup-0e416e73
```

Example prompt: Can you pull the circulating supply, total supply, max supply, and market cap for BTC, ETH, and SOL — I want to compare their circulating ratios and fully-diluted valuations?

## When to prefer this

Use this endpoint when you need token supply and tokenomics data (circulating, total, max supply, circulating ratio, market cap, FDV) for one or more cryptocurrencies by ticker symbol. Prefer it over general crypto price endpoints when supply-side metrics are the primary concern. Use the batch (comma-separated) feature when querying multiple tokens to minimize cost and latency.

## Known failure modes

- Unknown or misspelled ticker symbol returns an error or empty result
- CoinGecko ID not found when using the 'id' parameter returns no data
- Batch request with one invalid symbol may cause partial or full failure
- Rate limiting or upstream CoinGecko downtime returns a 5xx error
- Missing both 'symbol' and 'id' parameters results in a validation error

## How this service works

Token supply data by symbol via CoinGecko. Pass symbol=BTC (or ETH, SOL...) and get circulating, total and max supply, circulating ratio %, market cap and fully-diluted valuation. Batch with commas. For AI agents needing token supply, circulating supply and tokenomics. 代币供应量查询。

## Output

Returns for each requested token: circulating supply, total supply, max supply, circulating ratio as a percentage, market cap in USD, and fully-diluted valuation (FDV) sourced from CoinGecko.

## 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": [
      "symbol",
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "CoinGecko id(s) for coins not in ticker map, e.g. bitcoin. Alias: ids."
      },
      "symbol": {
       "type": "string",
       "description": "Token ticker(s), e.g. BTC or BTC,ETH,SOL (batch). Common tickers auto-mapped. Alias: symbols."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402node-crypto-token-supply-lookup-0e416e73/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.x402node.dev](https://www.zero.xyz/host/api.x402node.dev/llms.txt)