# three.ws Stablecoin Market Data

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

Returns real-time stablecoin market data including total market cap, individual stablecoin prices, circulating supply, peg mechanism, and chain counts.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-stablecoins?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-stablecoin-market-data-9e84a5c5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eGtkAs9ouk0HhYiPB8z9o

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-market-data-9e84a5c5
```

Example prompt: Can you pull the latest stablecoin market data — I want to see the total market cap and which stablecoins are biggest, along with their prices and how many chains they're on?

## When to prefer this

Choose this endpoint when you need a broad stablecoin market overview including cross-chain deployment counts and peg mechanism classification in a single call. It is especially useful for DeFi dashboards, research tools, or agents that need to reason about stablecoin liquidity and risk across chains. Prefer this over generic crypto price APIs when peg mechanism metadata and chain coverage are specifically needed.

## Known failure modes

- Payment not provided or insufficient USDC (HTTP 402 — payment required)
- Upstream data provider unavailable (HTTP 503 — service unavailable)
- Empty or partial stablecoin list if data is being refreshed
- Rate limiting if requests are made too frequently

## 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

A JSON object containing the total stablecoin market cap in USD and an array of stablecoins, each with an ID, name, symbol, current price, circulating supply in USD, number of chains deployed on, and peg mechanism type.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "total_mcap": 254000000000,
  "stablecoins": [
   {
    "id": "1",
    "name": "Tether",
    "price": 0.9998,
    "symbol": "USDT",
    "chain_count": 94,
    "peg_mechanism": "fiat-backed",
    "circulating_usd": 156000000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-stablecoin-market-data-9e84a5c5/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)