# Stablecoin Supply API > Live circulating supply, chain distribution and supply history for any stablecoin, keyless. For one stablecoin (USDT, USDC, DAI, USDe) get its total circulating supply, peg type and mechanism, price, 1d/7d/30d supply change and market dominance; the per-chain breakdown of where that supply actually lives; and the circulating-supply history over time, for the whole asset or a single chain. Search 370+ stablecoins to find an id. Live, nothing stored. The single-stablecoin supply layer for treasury, risk, research and dashboard apps — distinct from whole-ecosystem stablecoin feeds, this is one stablecoin in depth. ## 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/stablecoinsupply-api/..." ``` ## Pricing - **Free** (Free) — 3,100 calls/Mo, 3 req/s - **Starter** ($15/Mo) — 72,000 calls/Mo, 8 req/s - **Pro** ($49/Mo) — 460,000 calls/Mo, 20 req/s - **Business** ($151/Mo) — 3,000,000 calls/Mo, 50 req/s ## Endpoints ### Stablecoins #### `GET /v1/chains` — Per-chain circulating breakdown for a stablecoin **Parameters:** - `id` (query, required, string) — Stablecoin id Example: `1` - `limit` (query, optional, string) — Max chains (1-200, default 50) Example: `50` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stablecoinsupply-api/v1/chains?id=1&limit=50" ``` **Response:** ```json { "data": { "id": "1", "note": "Where this stablecoin's supply lives, per chain, by current circulating USD.", "count": 50, "chains": [ { "chain": "Tron", "change_1d_pct": 0, "change_7d_pct": -0.57, "circulating_usd": 87845445169.51 }, { "chain": "Ethereum", "change_1d_pct": -0.02, "change_7d_pct": 0.04, "circulating_usd": 80082586124.08 }, { "chain": "BSC", "change_1d_pct": 0, "change_7d_pct": 0, "circulating_usd": 9179724786.87 }, { "chain": "Solana", "change_1d_pct": 0, "change_7d_pct": 5.97, "circulating_usd": 2659099195.36 }, { "chain": "Arbitrum", "change_1d_pct": 0.87, "change_7d_pct": -1.05, "circulating_usd": 1006784250.06 }, { "chain": "Aptos", "change_1d_pct": 0, "change_7d_pct": 2.41, "circulating_usd": 976909425.69 }, { "chain": "Plasma", "change_1d_pct": -0.02, "change_7d_pct": 5.61, "circulating_usd": 882309360.14 }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/history` — Circulating supply over time, whole asset or one chain **Parameters:** - `id` (query, required, string) — Stablecoin id Example: `1` - `chain` (query, optional, string) — Chain name (e.g. Ethereum), or all (default) Example: `all` - `limit` (query, optional, string) — Days of history (1-730, default 90) Example: `90` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stablecoinsupply-api/v1/history?id=1&chain=all&limit=90" ``` **Response:** ```json { "data": { "id": "1", "note": "Circulating supply over time (USD), for the whole stablecoin or a single chain. date is a unix timestamp.", "chain": "all", "count": 90, "source": "DeFiLlama", "history": [ { "date": 1773705600, "circulating_usd": 184062612412 }, { "date": 1773792000, "circulating_usd": 184062143960 }, { "date": 1773878400, "circulating_usd": 183313214438 }, { "date": 1773964800, "circulating_usd": 184133852683 }, { "date": 1774051200, "circulating_usd": 184124130284 }, { "date": 1774137600, "circulating_usd": 184172718587 }, { "date": 1774224000, "circulating_usd": 184095403242 }, { "date": 1774310400, "circulating_usd": 184059715705 }, { "date": 1774396800, "circulating_usd": 184128331053 }, { "date": 1774483200, "circulating_usd": 184071158214 }, { "date": 1774569600, "circulating_usd": 184053953191 }, …(truncated, see openapi.json for full schema) ``` #### `GET /v1/search` — Find stablecoins by name or symbol **Parameters:** - `q` (query, required, string) — Name or symbol text Example: `usdc` - `limit` (query, optional, string) — Results (1-100, default 25) Example: `25` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stablecoinsupply-api/v1/search?q=usdc&limit=25" ``` **Response:** ```json { "data": { "count": 3, "query": "usdc", "source": "DeFiLlama", "matched": 3, "stablecoins": [ { "id": "2", "name": "USD Coin", "symbol": "USDC", "peg_type": "peggedUSD", "circulating_usd": 74950875208.41 }, { "id": "307", "name": "USD CoinVertible", "symbol": "USDCV", "peg_type": "peggedUSD", "circulating_usd": 12589971.95 }, { "id": "164", "name": "USDCB", "symbol": "USDCB", "peg_type": "peggedUSD", "circulating_usd": 225172.36 } ] }, "meta": { "timestamp": "2026-06-14T08:04:14.929Z", "request_id": "fcc8d3d1-7eff-478f-8a2f-dd420c2fb721" }, "status": "ok", "message": "Stablecoins retrieved successfully", "success": true } ``` #### `GET /v1/stablecoin` — Supply, peg, price, change and dominance for one stablecoin **Parameters:** - `id` (query, required, string) — Stablecoin id (1 = USDT, 2 = USDC, 5 = DAI; from /v1/search) Example: `1` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stablecoinsupply-api/v1/stablecoin?id=1" ``` **Response:** ```json { "data": { "id": "1", "name": "Tether", "note": "Total circulating supply, peg and dominance for one stablecoin. dominance_pct is its share of all stablecoin supply.", "price": 1, "source": "DeFiLlama", "symbol": "USDT", "peg_type": "peggedUSD", "chain_count": 127, "change_1d_pct": 0, "change_7d_pct": -0.2, "dominance_pct": 59.32, "peg_mechanism": "fiat-backed", "change_30d_pct": -1.73, "circulating_usd": 186465415650.96 }, "meta": { "timestamp": "2026-06-14T08:04:15.013Z", "request_id": "3d96b842-e925-4125-ba1b-5dedda62759f" }, "status": "ok", "message": "Stablecoin retrieved successfully", "success": true } ``` ### Meta #### `GET /v1/meta` — Service metadata & live sample **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/stablecoinsupply-api/v1/meta" ``` **Response:** ```json { "data": { "note": "search takes q (e.g. usdc) and optional limit. stablecoin, chains and history take a required id (1 = USDT, 2 = USDC, 5 = DAI; find via search). history also takes optional chain (e.g. Ethereum, default all) and limit (1-730 days). Money values are USD.", "sample": { "symbol": "USDT", "dominance_pct": 59.32, "circulating_usd": 186465415650.96 }, "source": "DeFiLlama open stablecoins API (stablecoins.llama.fi), live", "service": "stablecoinsupply-api", "endpoints": { "GET /v1/meta": "This document.", "GET /v1/chains": "Per-chain circulating breakdown for a stablecoin (id=1).", "GET /v1/search": "Find stablecoins by name or symbol (q=usdc).", "GET /v1/history": "Circulating supply over time, whole asset or one chain (id=1, chain).", "GET /v1/stablecoin": "Supply, peg, price, change and dominance for one stablecoin (id=1)." }, "description": "Live circulating supply, chain distribution and supply history for any stablecoin, keyless. For one stablecoin (USDT, USDC, DAI, USDe…) get its total circulating supply, peg type and mechanism, price, 1d/7d/30d supply change and market dominance; the per-chain breakdown of where that supply lives; and the circulating-supply history over time, for the whole asset or a single chain. Search 370+ stablecoins to find an id. Live, nothing stored beyond a short ca …(truncated, see openapi.json for full schema) ``` --- Marketplace page: https://www.oanor.com/api/stablecoinsupply-api OpenAPI spec: https://www.oanor.com/api/stablecoinsupply-api/openapi.json