{"openapi":"3.1.0","info":{"title":"Stablecoins API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stablecoins-api","description":"oanor gateway"}],"tags":[{"name":"Stablecoins"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/chains":{"get":{"operationId":"get_v1_chains","tags":["Stablecoins"],"summary":"Stablecoin supply per chain","description":"","parameters":[{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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":1484965965},{"chain":"Avalanche","share_pct":0.46,"circulating_usd":1426702336},{"chain":"Plasma","share_pct":0.294,"circulating_usd":911973651},{"chain":"TON","share_pct":0.259,"circulating_usd":802236321},{"chain":"Stellar","share_pct":0.259,"circulating_usd":800908763},{"chain":"XRPL","share_pct":0.246,"circulating_usd":762609817},{"chain":"MegaETH","share_pct":0.207,"circulating_usd":640922457},{"chain":"OP Mainnet","share_pct":0.179,"circulating_usd":554721327},{"chain":"Mantle","share_pct":0.174,"circulating_usd":540199976},{"chain":"Sui","share_pct":0.156,"circulating_usd":484848142},{"chain":"Monad","share_pct":0.136,"circulating_usd":422250396},{"chain":"Fantom","share_pct":0.109,"circulating_usd":338637294},{"chain":"Sei","share_pct":0.101,"circulating_usd":313995711},{"chain":"Ink","share_pct":0.075,"circulating_usd":230933160},{"chain":"Starknet","share_pct":0.061,"circulating_usd":188657122},{"chain":"Kaia","share_pct":0.06,"circulating_usd":187345275},{"chain":"Cronos","share_pct":0.058,"circulating_usd":179675527},{"chain":"Celo","share_pct":0.055,"circulating_usd":171110147},{"chain":"Saga","share_pct":0.05,"circulating_usd":154319394},{"chain":"Unichain","share_pct":0.046,"circulating_usd":142911675},{"chain":"Provenance","share_pct":0.045,"circulating_usd":139907034}],"total_usd":309822443284},"meta":{"timestamp":"2026-06-09T03:03:25.187Z","request_id":"882d456d-38cd-4ef8-b76d-66670ccbf599"},"status":"ok","message":"Chains retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/list":{"get":{"operationId":"get_v1_list","tags":["Stablecoins"],"summary":"Stablecoins ranked by supply","description":"","parameters":[{"name":"peg_mechanism","in":"query","required":false,"description":"fiat-backed | crypto-backed | algorithmic","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max 1-200","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","peg_type":"peggedUSD","chains_count":8,"dominance_pct":1.467,"peg_mechanism":"fiat-backed","circulating_usd":4636964271,"peg_deviation_pct":-0.1407},{"id":"146","name":"Ethena USDe","price":0.999484,"symbol":"USDe","peg_type":"peggedUSD","chains_count":28,"dominance_pct":1.42,"peg_mechanism":"crypto-backed","circulating_usd":4488445252,"peg_deviation_pct":-0.0516},{"id":"5","name":"Dai","price":0.99953,"symbol":"DAI","peg_type":"peggedUSD","chains_count":49,"dominance_pct":1.406,"peg_mechanism":"crypto-backed","circulating_usd":4442371711,"peg_deviation_pct":-0.047},{"id":"173","name":"BlackRock USD","price":1,"symbol":"BUIDL","peg_type":"peggedUSD","chains_count":8,"dominance_pct":0.954,"peg_mechanism":"fiat-backed","circulating_usd":3015959335,"peg_deviation_pct":0},{"id":"237","name":"Circle USYC","price":1.127497,"symbol":"USYC","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.92,"peg_mechanism":"fiat-backed","circulating_usd":2906876355,"peg_deviation_pct":12.7497},{"id":"120","name":"PayPal USD","price":1.000011,"symbol":"PYUSD","peg_type":"peggedUSD","chains_count":17,"dominance_pct":0.882,"peg_mechanism":"fiat-backed","circulating_usd":2786822346,"peg_deviation_pct":0.0011},{"id":"286","name":"Global Dollar","price":1.000254,"symbol":"USDG","peg_type":"peggedUSD","chains_count":5,"dominance_pct":0.808,"peg_mechanism":"fiat-backed","circulating_usd":2554392029,"peg_deviation_pct":0.0254},{"id":"129","name":"Ondo US Dollar Yield","price":1.133274,"symbol":"USDY","peg_type":"peggedUSD","chains_count":15,"dominance_pct":0.678,"peg_mechanism":"fiat-backed","circulating_usd":2143912715,"peg_deviation_pct":13.3274},{"id":"250","name":"Ripple USD","price":0.999785,"symbol":"RLUSD","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.529,"peg_mechanism":"fiat-backed","circulating_usd":1671928557,"peg_deviation_pct":-0.0215},{"id":"14","name":"USDD","price":0.999798,"symbol":"USDD","peg_type":"peggedUSD","chains_count":4,"dominance_pct":0.432,"peg_mechanism":"crypto-backed","circulating_usd":1364020702,"peg_deviation_pct":-0.0202},{"id":"246","name":"Falcon USD","price":0.995675,"symbol":"USDf","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.41,"peg_mechanism":"crypto-backed","circulating_usd":1296705938,"peg_deviation_pct":-0.4325},{"id":"221","name":"Ethena USDtb","price":0.999719,"symbol":"USDTB","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.334,"peg_mechanism":"fiat-backed","circulating_usd":1055881480,"peg_deviation_pct":-0.0281},{"id":"336","name":"United Stables","price":0.9998,"symbol":"U","peg_type":"peggedUSD","chains_count":3,"dominance_pct":0.316,"peg_mechanism":"crypto-backed","circulating_usd":999658955,"peg_deviation_pct":-0.02},{"id":"214","name":"USDX Money USDX","symbol":"USDX","peg_type":"peggedUSD","chains_count":3,"dominance_pct":0.216,"peg_mechanism":"crypto-backed","circulating_usd":683442224},{"id":"118","name":"GHO","price":0.99939,"symbol":"GHO","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.185,"peg_mechanism":"crypto-backed","circulating_usd":583643812,"peg_deviation_pct":-0.061},{"id":"195","name":"Usual USD","price":0.998517,"symbol":"USD0","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.175,"peg_mechanism":"fiat-backed","circulating_usd":552556931,"peg_deviation_pct":-0.1483},{"id":"272","name":"YLDS","price":0.999606,"symbol":"YLDS","peg_type":"peggedUSD","chains_count":4,"dominance_pct":0.167,"peg_mechanism":"fiat-backed","circulating_usd":527489065,"peg_deviation_pct":-0.0394},{"id":"310","name":"Solstice USX","price":0.999578,"symbol":"USX","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.155,"peg_mechanism":"crypto-backed","circulating_usd":490422831,"peg_deviation_pct":-0.0422},{"id":"7","name":"TrueUSD","price":0.999625,"symbol":"TUSD","peg_type":"peggedUSD","chains_count":10,"dominance_pct":0.153,"peg_mechanism":"fiat-backed","circulating_usd":484303001,"peg_deviation_pct":-0.0375},{"id":"354","name":"apxUSD","price":0.963201,"symbol":"apxUSD","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.124,"peg_mechanism":"crypto-backed","circulating_usd":392935413,"peg_deviation_pct":-3.6799},{"id":"347","name":"USDGO","price":1.00016,"symbol":"USDGO","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.117,"peg_mechanism":"fiat-backed","circulating_usd":370682342,"peg_deviation_pct":0.016},{"id":"340","name":"rwaUSDi","price":0.999667,"symbol":"rwaUSDi","peg_type":"peggedUSD","chains_count":4,"dominance_pct":0.114,"peg_mechanism":"crypto-backed","circulating_usd":359890131,"peg_deviation_pct":-0.0333}],"total_market_usd":316035374285,"total_stablecoins":380},"meta":{"timestamp":"2026-06-09T03:03:25.359Z","request_id":"171baf5c-9452-4f50-946b-4c3d88d073d0"},"status":"ok","message":"Stablecoins listed successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Stablecoins"],"summary":"Search stablecoins","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search term","schema":{"type":"string"},"example":"USD"},{"name":"limit","in":"query","required":false,"description":"Max 1-100","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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.998593,"symbol":"USD1","peg_type":"peggedUSD","chains_count":8,"dominance_pct":1.467,"peg_mechanism":"fiat-backed","circulating_usd":4636964271,"peg_deviation_pct":-0.1407},{"id":"146","name":"Ethena USDe","price":0.999484,"symbol":"USDe","peg_type":"peggedUSD","chains_count":28,"dominance_pct":1.42,"peg_mechanism":"crypto-backed","circulating_usd":4488445252,"peg_deviation_pct":-0.0516},{"id":"173","name":"BlackRock USD","price":1,"symbol":"BUIDL","peg_type":"peggedUSD","chains_count":8,"dominance_pct":0.954,"peg_mechanism":"fiat-backed","circulating_usd":3015959335,"peg_deviation_pct":0},{"id":"120","name":"PayPal USD","price":1.000011,"symbol":"PYUSD","peg_type":"peggedUSD","chains_count":17,"dominance_pct":0.882,"peg_mechanism":"fiat-backed","circulating_usd":2786822346,"peg_deviation_pct":0.0011},{"id":"286","name":"Global Dollar","price":1.000254,"symbol":"USDG","peg_type":"peggedUSD","chains_count":5,"dominance_pct":0.808,"peg_mechanism":"fiat-backed","circulating_usd":2554392029,"peg_deviation_pct":0.0254},{"id":"129","name":"Ondo US Dollar Yield","price":1.133274,"symbol":"USDY","peg_type":"peggedUSD","chains_count":15,"dominance_pct":0.678,"peg_mechanism":"fiat-backed","circulating_usd":2143912715,"peg_deviation_pct":13.3274},{"id":"250","name":"Ripple USD","price":0.999785,"symbol":"RLUSD","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.529,"peg_mechanism":"fiat-backed","circulating_usd":1671928557,"peg_deviation_pct":-0.0215},{"id":"14","name":"USDD","price":0.999798,"symbol":"USDD","peg_type":"peggedUSD","chains_count":4,"dominance_pct":0.432,"peg_mechanism":"crypto-backed","circulating_usd":1364020702,"peg_deviation_pct":-0.0202},{"id":"246","name":"Falcon USD","price":0.995675,"symbol":"USDf","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.41,"peg_mechanism":"crypto-backed","circulating_usd":1296705938,"peg_deviation_pct":-0.4325},{"id":"221","name":"Ethena USDtb","price":0.999719,"symbol":"USDTB","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.334,"peg_mechanism":"fiat-backed","circulating_usd":1055881480,"peg_deviation_pct":-0.0281},{"id":"214","name":"USDX Money USDX","symbol":"USDX","peg_type":"peggedUSD","chains_count":3,"dominance_pct":0.216,"peg_mechanism":"crypto-backed","circulating_usd":683442224},{"id":"195","name":"Usual USD","price":0.998517,"symbol":"USD0","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.175,"peg_mechanism":"fiat-backed","circulating_usd":552556931,"peg_deviation_pct":-0.1483},{"id":"7","name":"TrueUSD","price":0.999625,"symbol":"TUSD","peg_type":"peggedUSD","chains_count":10,"dominance_pct":0.153,"peg_mechanism":"fiat-backed","circulating_usd":484303001,"peg_deviation_pct":-0.0375},{"id":"354","name":"apxUSD","price":0.963201,"symbol":"apxUSD","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.124,"peg_mechanism":"crypto-backed","circulating_usd":392935413,"peg_deviation_pct":-3.6799},{"id":"347","name":"USDGO","price":1.00016,"symbol":"USDGO","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.117,"peg_mechanism":"fiat-backed","circulating_usd":370682342,"peg_deviation_pct":0.016},{"id":"340","name":"rwaUSDi","price":0.999667,"symbol":"rwaUSDi","peg_type":"peggedUSD","chains_count":4,"dominance_pct":0.114,"peg_mechanism":"crypto-backed","circulating_usd":359890131,"peg_deviation_pct":-0.0333},{"id":"119","name":"First Digital USD","price":0.9977,"symbol":"FDUSD","peg_type":"peggedUSD","chains_count":6,"dominance_pct":0.107,"peg_mechanism":"fiat-backed","circulating_usd":338908607,"peg_deviation_pct":-0.23},{"id":"306","name":"Gate USD","price":1.000033,"symbol":"GUSD","peg_type":"peggedUSD","chains_count":1,"dominance_pct":0.101,"peg_mechanism":"fiat-backed","circulating_usd":320010714,"peg_deviation_pct":0.0033},{"id":"220","name":"Avalon USDa","symbol":"USDA","peg_type":"peggedUSD","chains_count":19,"dominance_pct":0.086,"peg_mechanism":"crypto-backed","circulating_usd":270844395},{"id":"153","name":"Binance Peg BUSD","price":1.000965,"symbol":"BUSD","peg_type":"peggedUSD","chains_count":27,"dominance_pct":0.074,"peg_mechanism":"crypto-backed","circulating_usd":233148594,"peg_deviation_pct":0.0965},{"id":"342","name":"MegaUSD","symbol":"USDM","peg_type":"peggedUSD","chains_count":2,"dominance_pct":0.064,"peg_mechanism":"crypto-backed","circulating_usd":200788936},{"id":"309","name":"USD.AI","price":0.988372,"symbol":"USDai","peg_type":"peggedUSD","chains_count":3,"dominance_pct":0.063,"peg_mechanism":"crypto-backed","circulating_usd":198654809,"peg_deviation_pct":-1.1628}]},"meta":{"timestamp":"2026-06-09T03:03:25.512Z","request_id":"81adc8df-79bc-43a0-89f0-3494994d7b62"},"status":"ok","message":"Search results retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/stablecoin":{"get":{"operationId":"get_v1_stablecoin","tags":["Stablecoins"],"summary":"One stablecoin: peg + per-chain","description":"","parameters":[{"name":"symbol","in":"query","required":false,"description":"Symbol (preferred)","schema":{"type":"string"},"example":"USDT"},{"name":"name","in":"query","required":false,"description":"Name, e.g. Tether","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"chain":"Mantle","circulating_usd":350347750},{"chain":"Hyperliquid L1","circulating_usd":213234035},{"chain":"OP Mainnet","circulating_usd":182569332},{"chain":"Kaia","circulating_usd":168864973},{"chain":"Celo","circulating_usd":131867236}],"chains_count":127,"chains_total":115,"dominance_pct":59.121,"peg_mechanism":"fiat-backed","circulating_usd":186844172425,"peg_deviation_pct":-0.0425}},"meta":{"timestamp":"2026-06-09T03:03:25.655Z","request_id":"06845bf5-9e36-4d53-a468-8d436d36cabd"},"status":"ok","message":"Stablecoin retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":250,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1300,"monthly_call_quota":9500,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":3300,"monthly_call_quota":46000,"rps_limit":25,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":7700,"monthly_call_quota":235000,"rps_limit":45,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stablecoins-api"}