# three.ws Stablecoin Health API

> three.ws Stablecoin Health API is a paid API for AI agents from three.ws, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-11).

Returns real-time peg status, circulating supply, price, and chain coverage for major stablecoins, filtered by symbol or ranked by supply.

## Facts

- Endpoint: GET https://three.ws/api/x402/stablecoin-health?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-stablecoin-health-api-34a45ebe
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6wE11lxcd2l0yu4xOEZ7S

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 three-ws-stablecoin-health-api-34a45ebe
```

Example prompt: Show me the peg health and circulating supply for the top 5 stablecoins right now, and flag any that are currently off peg.

## When to prefer this

Choose this endpoint when you need real-time stablecoin peg status, deviation metrics, and circulating supply data in a single call — especially when filtering by a specific coin like USDC or needing ranked lists of the largest stablecoins. Prefer it over generic crypto price APIs when peg health (deviation basis points, on-peg/depegged status) and multi-chain coverage data are the primary concern.

## Known failure modes

- Unknown or misspelled symbol returns empty coins array
- limit parameter out of range (1-100) returns validation error
- Payment not included or insufficient USDC causes 402 response
- Service unavailable if upstream price feeds are down
- Stale data if timestamp is significantly behind real-time

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a timestamp, a list of stablecoins sorted by circulating supply (each with symbol, name, price, peg status, deviation in basis points, mechanism, chain count, and 24h/7d/30d price changes), a separate array of any currently depegged coins, and the total stablecoin circulating supply in USD.

## 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",
     "$schema": "https://json-schema.org/draft/2020-12/schema",
     "properties": {
      "limit": {
       "type": "integer",
       "default": 25,
       "maximum": 100,
       "minimum": 1,
       "description": "Coins to return, largest supply first."
      },
      "symbol": {
       "type": "string",
       "description": "Return only this stablecoin symbol, e.g. USDC (case-insensitive)."
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ts": "2026-07-11T10:00:00Z",
  "coins": [
   {
    "name": "USD Coin",
    "price": 0.9998,
    "chains": 34,
    "status": "on-peg",
    "symbol": "USDC",
    "mechanism": "fiat-backed",
    "change_7d_pct": 1.4,
    "deviation_bps": -2,
    "change_24h_pct": 0.21,
    "change_30d_pct": 3.8,
    "circulating_usd": 61200000000
   }
  ],
  "depegged": [],
  "total_circulating_usd": 254000000000
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-stablecoin-health-api-34a45ebe/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)