# DefiLlama Stablecoins — Circulating Supply & Peg Prices

> DefiLlama Stablecoins — Circulating Supply & Peg Prices is a paid API for AI agents from defillama.use.x402atlas.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-13).

Returns all stablecoins tracked by DefiLlama with their circulating supply, and optionally their current peg prices.

## Facts

- Endpoint: GET https://defillama.use.x402atlas.com/stablecoins
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/defillama-stablecoins-circulating-supply-peg-prices-c0fa274f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CiMwrEQEHzbKImY6VP5tK

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 defillama-stablecoins-circulating-supply-peg-prices-c0fa274f
```

Example prompt: Pull me the full list of stablecoins tracked by DefiLlama with their circulating supplies — and include the current peg prices too.

## When to prefer this

Use this endpoint when you need a comprehensive, up-to-date list of all stablecoins with their circulating supply figures, especially when tracking overall stablecoin market health or monitoring peg stability. Prefer this over token price endpoints when the focus is specifically on stablecoins and their supply metrics rather than arbitrary token prices.

## Known failure modes

- Upstream DefiLlama API unavailable — returns 5xx or empty response
- Payment not processed correctly — returns 402 Payment Required
- Invalid query parameter value for includePrices — may be silently ignored or cause a 400 error
- Stale data if DefiLlama has not recently updated its stablecoin index

## How this service works

Stablecoins by DefiLlama — all tracked stablecoins with circulating supply (optionally current peg prices).

## Output

A list of all stablecoins tracked by DefiLlama, each with its name, symbol, and circulating supply. When includePrices=true is set, each entry also includes the current peg price of the stablecoin.

## 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",
     "properties": {
      "includePrices": {
       "type": "string",
       "maxLength": 200,
       "description": "Set to true to include current peg prices (e.g. true)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "queried_at",
      "data"
     ],
     "properties": {
      "data": {
       "type": "object",
       "properties": {
        "peggedAssets": {
         "type": "array",
         "items": {
          "type": "object",
          "properties": {
           "name": {
            "type": "string"
           },
           "symbol": {
            "type": "string"
           },
           "circulating": {
            "type": "object",
            "description": "Current circulating supply, keyed by peg type (e.g. peggedUSD)"
           }
          }
         }
        }
       }
      },
      "queried_at": {
       "type": "string",
       "format": "date-time",
       "description": "Time the upstream was queried"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "peggedAssets": [
    {
     "name": "Tether",
     "symbol": "USDT",
     "circulating": {
      "peggedUSD": 110000000000
     }
    }
   ]
  },
  "queried_at": "2026-07-01T12:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/defillama-stablecoins-circulating-supply-peg-prices-c0fa274f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from defillama.use.x402atlas.com](https://www.zero.xyz/host/defillama.use.x402atlas.com/llms.txt)