# Greeneris Stablecoins Supply

> Greeneris Stablecoins Supply is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns circulating supply, peg type, and 24h/7d/30d supply deltas for the top stablecoins (optionally filtered by ticker symbol), sourced from DeFiLlama.

## Facts

- Endpoint: GET https://data.greeneris.io/v1/stables/supply
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-stablecoins-supply-814fe885
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l4UdDC47byVdVlmeYzLDN

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 greeneris-stablecoins-supply-814fe885
```

Example prompt: What are the top 10 stablecoins right now by circulating supply, and how much has each one changed over the last 7 days? Show me USDT specifically if you can.

## When to prefer this

Use this endpoint when you need authoritative, real-time stablecoin circulating supply and supply-flow data (24h/7d/30d deltas) sourced from DeFiLlama, at very low cost per call with no account required. Prefer over alternatives when you need DeFiLlama's aggregated stablecoin data programmatically, want commodity pricing with pay-per-call via USDC, or need to filter to a specific ticker like USDT or USDC.

## Known failure modes

- HTTP 402 returned if payment not yet made — agent must pay $0.005 USDC on Base via x402 protocol and retry
- Invalid or unknown symbol returns empty stablecoins array
- top parameter out of range (must be 1–50) returns validation error
- Service unavailable if DeFiLlama upstream is down

## How this service works

Circulating supply per stablecoin from DeFiLlama with computed net flows (delta_24h/delta_7d/delta_30d = net mint minus burn), peg type, peg mechanism and current price. Query: ?symbol=USDT for one asset, or ?top=10 (1-50, default 10) for the largest by supply. Served with a 30min cache.

## Output

A JSON object listing stablecoins with their name, ticker symbol, current price, circulating supply (in USD), peg type (e.g. peggedUSD), peg mechanism (e.g. fiat-backed), and supply deltas for the past 24 hours, 7 days, and 30 days. Also includes a source attribution (DeFiLlama) and result count.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "top": {
       "type": "integer",
       "default": 10,
       "maximum": 50,
       "minimum": 1,
       "description": "Number of largest stablecoins to return"
      },
      "symbol": {
       "type": "string",
       "description": "Stablecoin ticker, e.g. USDT (optional)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "source": "DeFiLlama (stablecoins.llama.fi)",
  "stablecoins": [
   {
    "name": "Tether",
    "price": 1,
    "symbol": "USDT",
    "delta_7d": 512000104.33,
    "peg_type": "peggedUSD",
    "delta_24h": -8993322.02,
    "delta_30d": 2100450900.12,
    "circulating": 184133214409.51,
    "peg_mechanism": "fiat-backed"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-stablecoins-supply-814fe885/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)