# AgenticFi Token Supply Lookup

> AgenticFi Token Supply Lookup is a paid API for AI agents from defi-api.agenticfi.wtf, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-15).

Returns the circulating, total, and/or max supply for a given token identified by its CoinGecko token ID.

## Facts

- Endpoint: GET https://defi-api.agenticfi.wtf/api/token/supply/%7Bid%7D
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agenticfi-token-supply-lookup-4136f8f2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZXxcsLA_ToMU51NrtTcEJ

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 agenticfi-token-supply-lookup-4136f8f2
```

Example prompt: What's the current circulating supply of Ethereum — can you pull the token supply data for it using the CoinGecko ID 'ethereum'?

## When to prefer this

Use this endpoint when you need on-chain or market supply data (circulating, total, max) for a specific cryptocurrency identified by its CoinGecko token ID, especially in automated DeFi agent workflows that pay per call via x402 on Base. Prefer this over general crypto APIs when you need programmatic, pay-per-use access without API key management.

## Known failure modes

- Invalid or unrecognized CoinGecko token ID returns a 404 or error response
- Missing required 'id' path parameter causes a 400 bad request
- Token exists on CoinGecko but supply data is unavailable or null
- Payment failure via x402/USDC on Base results in a 402 response
- Rate limiting or upstream CoinGecko API downtime causes 503 or timeout

## How this service works

Circulating, total, max supply + FDV for a token

## Output

Returns supply metrics for the requested token, including circulating supply, total supply, and/or maximum supply, sourced from CoinGecko data via the AgenticFi DeFi API.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "pathParams": {
   "id": "ethereum"
  },
  "queryParams": {
   "id": "ethereum"
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "pathParams",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "title": "id (required)",
       "description": "Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "title": "id (required)",
       "description": "Required. CoinGecko token ID.\nTry one of these 10 examples: bitcoin, ethereum, solana, chainlink, uniswap, aave, maker, dogecoin, pepe, arbitrum"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agenticfi-token-supply-lookup-4136f8f2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defi-api.agenticfi.wtf](https://www.zero.xyz/host/defi-api.agenticfi.wtf/llms.txt)