# Stablecoin Circulating Supply

> Stablecoin Circulating Supply is a paid API for AI agents from x402.shizu.me, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns a ranked list of tracked stablecoins with circulating supply (USD), peg type, peg mechanism, and current price, ordered by circulating supply.

## Facts

- Endpoint: GET https://x402.shizu.me/llama/stablecoins
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/stablecoin-circulating-supply-d9ed04a4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EbcUq9FMRYh_qYvwVeKZ4

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 stablecoin-circulating-supply-d9ed04a4
```

Example prompt: Show me the top 20 stablecoins ranked by circulating supply, including their peg type, peg mechanism, and current price.

## When to prefer this

Choose this endpoint when you need a broad, ranked overview of the stablecoin market including peg metadata — not just prices. It is ideal when you need to compare peg types and mechanisms across many stablecoins at once, or when building a dashboard that tracks the stablecoin landscape. Prefer this over a general crypto price API when peg mechanism and supply ranking are important to the use case.

## Known failure modes

- limit out of range (below 1 or above 200) may return an error or be clamped
- upstream DefiLlama data unavailability causing stale or empty results
- payment failure (insufficient USDC balance) blocking the request
- network timeout from the proxy service

## How this service works

Every tracked stablecoin with circulating supply (USD), peg type, peg mechanism, and current price. Ranked by circulating. Query: limit (1-200).

## Output

A ranked array of stablecoin entries, each containing the stablecoin name/ticker, circulating supply in USD, peg type (e.g. fiat, crypto, algorithmic), peg mechanism (e.g. overcollateralized, algorithmic, fiat-backed), and current price. Results are sorted descending by circulating supply. The number of results is controlled by the 'limit' parameter (1–200).

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "limit": {
       "type": "string"
      }
     },
     "required": [
      "limit"
     ]
    }
   },
   "required": [
    "method"
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 20,
  "source": "defillama",
  "stablecoins": [
   {
    "name": "Tether",
    "price": 1,
    "symbol": "USDT",
    "peg_type": "peggedUSD",
    "peg_mechanism": "fiat-backed",
    "circulating_usd": 120000000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablecoin-circulating-supply-d9ed04a4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.shizu.me](https://www.zero.xyz/host/x402.shizu.me/llms.txt)