# Stablecoins API
> Live stablecoin supply, peg and dominance data across the whole crypto ecosystem as an API, streamed from the DefiLlama stablecoins feed. For every tracked stablecoin: its circulating supply in USD, current price and peg deviation, peg type and mechanism (fiat-backed, crypto-backed or algorithmic), the chains it lives on, and its share of the total stablecoin market. List the biggest stablecoins with their dominance, drill into one for its peg health and per-chain breakdown, see total stablecoin supply per chain, or search. Built for crypto, risk and dashboard apps. Live, no key. Distinct from TVL, price and yield APIs — this is the stablecoin supply and peg surface.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/stablecoins-api/..."
```

## Pricing
- **Free** (Free) — 250 calls/Mo, 3 req/s
- **Starter** ($13/Mo) — 9,500 calls/Mo, 10 req/s
- **Pro** ($33/Mo) — 46,000 calls/Mo, 25 req/s
- **Business** ($77/Mo) — 235,000 calls/Mo, 45 req/s

## Endpoints

### Stablecoins

#### `GET /v1/chains` — Stablecoin supply per chain

**Parameters:**
- `limit` (query, optional, string) — Max 1-200 Example: `30`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stablecoins-api/v1/chains?limit=30"
```

**Response:**
```json
{
    "data": {
        "count": 30,
        "chains": [
            {
                "chain": "Ethereum",
                "share_pct": 50.845,
                "circulating_usd": 157530702199
            },
            {
                "chain": "Tron",
                "share_pct": 28.896,
                "circulating_usd": 89526927628
            },
            {
                "chain": "Solana",
                "share_pct": 4.947,
                "circulating_usd": 15327739371
            },
            {
                "chain": "BSC",
                "share_pct": 4.472,
                "circulating_usd": 13854592774
            },
            {
                "chain": "Hyperliquid L1",
                "share_pct": 2.184,
                "circulating_usd": 6765038490
            },
            {
                "chain": "Base",
                "share_pct": 1.533,
                "circulating_usd": 4750295164
            },
            {
                "chain": "Arbitrum",
                "share_pct": 1.256,
                "circulating_usd": 3889864510
            },
            {
                "chain": "Polygon",
                "share_pct": 1.126,
                "circulating_usd": 3487316070
            },
            {
                "chain": "Aptos",
                "share_pct": 0.6,
                "circulating_usd": 1858756438
            },
            {
                "chain": "X Layer",
                "share_pct": 0.479,
                "circulating_usd"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/list` — Stablecoins ranked by supply

**Parameters:**
- `peg_mechanism` (query, optional, string) — fiat-backed | crypto-backed | algorithmic
- `limit` (query, optional, string) — Max 1-200 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stablecoins-api/v1/list?limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "stablecoins": [
            {
                "id": "1",
                "name": "Tether",
                "price": 0.999575,
                "symbol": "USDT",
                "peg_type": "peggedUSD",
                "chains_count": 127,
                "dominance_pct": 59.121,
                "peg_mechanism": "fiat-backed",
                "circulating_usd": 186844172425,
                "peg_deviation_pct": -0.0425
            },
            {
                "id": "2",
                "name": "USD Coin",
                "price": 0.999706,
                "symbol": "USDC",
                "peg_type": "peggedUSD",
                "chains_count": 151,
                "dominance_pct": 24.063,
                "peg_mechanism": "fiat-backed",
                "circulating_usd": 76046549673,
                "peg_deviation_pct": -0.0294
            },
            {
                "id": "209",
                "name": "Sky Dollar",
                "price": 0.99974,
                "symbol": "USDS",
                "peg_type": "peggedUSD",
                "chains_count": 7,
                "dominance_pct": 2.699,
                "peg_mechanism": "crypto-backed",
                "circulating_usd": 8531341863,
                "peg_deviation_pct": -0.026
            },
            {
                "id": "262",
                "name": "World Liberty Financial USD",
                "price": 0.998593,
                "symbol": "USD1",
         
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search stablecoins

**Parameters:**
- `q` (query, required, string) — Search term Example: `USD`
- `limit` (query, optional, string) — Max 1-100 Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stablecoins-api/v1/search?q=USD&limit=25"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "usd",
        "total": 212,
        "stablecoins": [
            {
                "id": "1",
                "name": "Tether",
                "price": 0.999575,
                "symbol": "USDT",
                "peg_type": "peggedUSD",
                "chains_count": 127,
                "dominance_pct": 59.121,
                "peg_mechanism": "fiat-backed",
                "circulating_usd": 186844172425,
                "peg_deviation_pct": -0.0425
            },
            {
                "id": "2",
                "name": "USD Coin",
                "price": 0.999706,
                "symbol": "USDC",
                "peg_type": "peggedUSD",
                "chains_count": 151,
                "dominance_pct": 24.063,
                "peg_mechanism": "fiat-backed",
                "circulating_usd": 76046549673,
                "peg_deviation_pct": -0.0294
            },
            {
                "id": "209",
                "name": "Sky Dollar",
                "price": 0.99974,
                "symbol": "USDS",
                "peg_type": "peggedUSD",
                "chains_count": 7,
                "dominance_pct": 2.699,
                "peg_mechanism": "crypto-backed",
                "circulating_usd": 8531341863,
                "peg_deviation_pct": -0.026
            },
            {
                "id": "262",
                "name": "World Liberty Financial USD",
                "price": 0.99859
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/stablecoin` — One stablecoin: peg + per-chain

**Parameters:**
- `symbol` (query, optional, string) — Symbol (preferred) Example: `USDT`
- `name` (query, optional, string) — Name, e.g. Tether

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stablecoins-api/v1/stablecoin?symbol=USDT"
```

**Response:**
```json
{
    "data": {
        "stablecoin": {
            "id": "1",
            "name": "Tether",
            "price": 0.999575,
            "symbol": "USDT",
            "peg_type": "peggedUSD",
            "top_chains": [
                {
                    "chain": "Tron",
                    "circulating_usd": 88231135146
                },
                {
                    "chain": "Ethereum",
                    "circulating_usd": 79963862441
                },
                {
                    "chain": "BSC",
                    "circulating_usd": 9179769124
                },
                {
                    "chain": "Solana",
                    "circulating_usd": 2919050512
                },
                {
                    "chain": "Arbitrum",
                    "circulating_usd": 970284731
                },
                {
                    "chain": "Aptos",
                    "circulating_usd": 913989297
                },
                {
                    "chain": "Polygon",
                    "circulating_usd": 885254367
                },
                {
                    "chain": "Plasma",
                    "circulating_usd": 804707807
                },
                {
                    "chain": "TON",
                    "circulating_usd": 630519888
                },
                {
                    "chain": "Avalanche",
                    "circulating_usd": 382418189
                },
                {
        
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/stablecoins-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "DefiLlama stablecoins (live)",
        "service": "stablecoins-api",
        "endpoints": {
            "GET /v1/list": "Stablecoins ranked by circulating supply with dominance (peg_mechanism= filter, limit).",
            "GET /v1/meta": "This document.",
            "GET /v1/chains": "Total stablecoin supply per chain, ranked (limit).",
            "GET /v1/search": "Search stablecoins by symbol or name (q=).",
            "GET /v1/stablecoin": "One stablecoin: peg health + per-chain breakdown (symbol=USDT or name=)."
        },
        "description": "Live stablecoin supply, peg and dominance data from DefiLlama (stablecoins.llama.fi): circulating supply USD, price and peg deviation, peg type/mechanism (fiat-backed, crypto-backed, algorithmic), per-chain breakdown and market dominance. List the biggest, drill into one, see supply per chain, or search. Live, no key. Distinct from TVL, price and yield APIs.",
        "total_market_usd": 316035374285,
        "total_stablecoins": 380
    },
    "meta": {
        "timestamp": "2026-06-09T03:03:25.808Z",
        "request_id": "0c5f9a12-ccae-4bd2-a623-5b6c4dc2f148"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/stablecoins-api
OpenAPI spec: https://www.oanor.com/api/stablecoins-api/openapi.json