# Agent402 Stablecoin Supply History

> Agent402 Stablecoin Supply History is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Returns historical circulating supply of stablecoins by peg currency and/or chain over a configurable time window, with summary statistics.

## Facts

- Endpoint: POST https://agent402.tools/api/stablecoin-supply-history
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-stablecoin-supply-history-9b8326c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_kCF9JAVZO3dyJ66fRgEtk

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 agent402-stablecoin-supply-history-9b8326c8 -d '<json body>'
```

Example prompt: Pull the stablecoin supply history for USD-pegged coins across all chains for the last 180 days and give me the min, max, and percentage change.

## When to prefer this

Use this endpoint when you need time-series stablecoin supply data filterable by peg currency and/or blockchain, sourced from DefiLlama, with no API key required and micropayment billing. Prefer this over raw DefiLlama calls when your agent is already operating in an x402 payment context or needs pre-summarized statistics (min/max/mean/changePct) without additional computation.

## Known failure modes

- Invalid chain name not recognized by DefiLlama returns an error or empty data
- Days value exceeding 3650 may be clamped or rejected
- Unknown peg currency code returns no matching data
- Upstream DefiLlama API outage results in fetch failure
- Very short day windows may return sparse or single-point data with no meaningful summary

## How this service works

Daily total stablecoin supply in USD over time, for all chains or one chain, per peg currency, with a window summary. Use it when an agent wants stablecoin supply as a liquidity or risk-appetite signal or needs the history behind a headline supply figure.

## Output

A JSON object containing the peg and chain scope, a chronological array of daily data points (each with a date and circulatingUsd value), a summary block with max, min, mean, first, latest, and changePct fields, the data source attribution (DefiLlama), the fetch timestamp, and the total number of data points available.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "peg": {
   "type": "string",
   "description": "Peg currency: USD (default), EUR, JPY, ... or \"all\" to sum every peg in USD."
  },
  "days": {
   "type": "number",
   "description": "Most recent days to return (default 90, max 3650)."
  },
  "chain": {
   "type": "string",
   "description": "Chain name as DefiLlama spells it, or \"all\" (default)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "peg": "USD",
  "chain": "all",
  "count": 2,
  "points": [
   {
    "date": "2026-08-21",
    "circulatingUsd": 307734935324
   },
   {
    "date": "2026-08-22",
    "circulatingUsd": 308487484274
   }
  ],
  "source": "defillama-stablecoins",
  "summary": {
   "max": 308487484274,
   "min": 307734935324,
   "mean": 308111209799,
   "first": 307734935324,
   "latest": 308487484274,
   "changePct": 0.24
  },
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "totalPoints": 3189
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-stablecoin-supply-history-9b8326c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)