# Agent402 Stablecoins Market Data

> Agent402 Stablecoins Market Data is a paid API for AI agents from agent402.tools, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Returns filtered and ranked stablecoin market data including circulation, peg type, mechanism, and chain-level breakdown from DefiLlama.

## Facts

- Endpoint: POST https://agent402.tools/api/stablecoins
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-stablecoins-market-data-ea8d6ca1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dfmouEbgZoHLE3dtcWi6b

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-stablecoins-market-data-ea8d6ca1 -d '<json body>'
```

Example prompt: Show me the top 10 fiat-backed USD stablecoins on Ethereum ranked by circulating supply.

## When to prefer this

Choose this endpoint when you need comprehensive, filterable stablecoin market data including chain-level circulation breakdowns, peg mechanism classification, and deviation tracking — especially if you want to query by specific blockchain, peg currency, or mechanism type. Prefer it over generic crypto market APIs when stablecoin-specific fields like pegMechanism, pegDeviationPct, and chain-level distribution are required.

## Known failure modes

- Invalid chain name not matching DefiLlama's naming convention returns empty or unfiltered results
- Limit exceeding 100 is clamped or rejected
- Unknown peg currency filter returns zero matches
- Stale cache may return data up to several minutes old
- Network timeout from upstream DefiLlama API causes failure

## How this service works

Stablecoins ranked by circulating supply: peg currency and mechanism, price and deviation from peg, supply in peg units and USD, 1d, 7d and 30d change and circulation per chain. Use it when an agent is checking a peg, sizing stablecoin flows or finding which chains a stablecoin actually lives on.

## Output

A JSON object containing the total count of stablecoins matched, aggregate circulating USD value, applied filter echo, cache status, data source attribution, and an array of stablecoin records each with rank, name, symbol, price, peg currency, peg mechanism, circulating supply in USD, 1d/7d/30d percentage changes, peg deviation percentage, number of chains, and per-chain circulation breakdown.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "peg": {
   "type": "string",
   "description": "Peg currency filter: USD (default), EUR, JPY, GBP, CHF, VAR, ... or \"all\"."
  },
  "chain": {
   "type": "string",
   "description": "Chain filter as DefiLlama names it (Ethereum, Tron, Solana, Base, BSC, Arbitrum...). Rows are then ranked by circulation on that chain."
  },
  "limit": {
   "type": "number",
   "description": "Rows to return (default 20, max 100)."
  },
  "search": {
   "type": "string",
   "description": "Name/symbol substring filter (case-insensitive)."
  },
  "mechanism": {
   "type": "string",
   "description": "\"fiat-backed\", \"crypto-backed\" or \"algorithmic\"."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "cached": true,
  "source": "defillama-stablecoins",
  "totals": {
   "assetCount": 300,
   "circulatingUsd": 307000000000
  },
  "filters": {
   "peg": "USD",
   "chain": null,
   "search": null,
   "mechanism": null
  },
  "matched": 300,
  "fetchedAt": "2026-08-22T12:00:00.000Z",
  "stablecoins": [
   {
    "id": "1",
    "name": "Tether",
    "rank": 1,
    "price": 0.9998,
    "chains": [
     {
      "chain": "Tron",
      "circulating": 90000000000
     }
    ],
    "symbol": "USDT",
    "geckoId": "tether",
    "pegType": "peggedUSD",
    "chainCount": 120,
    "change1dPct": 0.08,
    "change7dPct": 0.01,
    "circulating": 183181226868,
    "pegCurrency": "USD",
    "change30dPct": 0.01,
    "pegMechanism": "fiat-backed",
    "circulatingUsd": 183181226868,
    "pegDeviationPct": -0.02
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-stablecoins-market-data-ea8d6ca1/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)
