{"openapi":"3.1.0","info":{"title":"Stablecoin Supply API","version":"1.0.0","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 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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/stablecoinsupply-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":"Per-chain circulating breakdown for a stablecoin","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Stablecoin id","schema":{"type":"string"},"example":"1"},{"name":"limit","in":"query","required":false,"description":"Max chains (1-200, default 50)","schema":{"type":"string"},"example":"50"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"chain":"Polygon","change_1d_pct":0.13,"change_7d_pct":-0.23,"circulating_usd":881667810.16},{"chain":"TON","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":630515693.69},{"chain":"Avalanche","change_1d_pct":0,"change_7d_pct":-4.63,"circulating_usd":412387067.94},{"chain":"Mantle","change_1d_pct":-0.19,"change_7d_pct":5.71,"circulating_usd":374534634.02},{"chain":"Hyperliquid L1","change_1d_pct":0.16,"change_7d_pct":-8.23,"circulating_usd":192718711.43},{"chain":"OP Mainnet","change_1d_pct":0.4,"change_7d_pct":-8.09,"circulating_usd":187707541.93},{"chain":"Kaia","change_1d_pct":0,"change_7d_pct":-10.59,"circulating_usd":168863850.01},{"chain":"Celo","change_1d_pct":0,"change_7d_pct":-2.27,"circulating_usd":128867654.17},{"chain":"X Layer","change_1d_pct":0.4,"change_7d_pct":1.53,"circulating_usd":107482519.82},{"chain":"Fantom","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":82922266.32},{"chain":"Omni","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":80007470.75},{"chain":"Ink","change_1d_pct":-4.06,"change_7d_pct":-38.03,"circulating_usd":65314408.16},{"chain":"Near","change_1d_pct":-0.02,"change_7d_pct":0,"circulating_usd":64678076.74},{"chain":"Kava","change_1d_pct":-0.07,"change_7d_pct":-0.06,"circulating_usd":60184965.03},{"chain":"Monad","change_1d_pct":-0.11,"change_7d_pct":-35.25,"circulating_usd":55689592.7},{"chain":"Tezos","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":42259673.28},{"chain":"Polkadot","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":36981645.46},{"chain":"Berachain","change_1d_pct":-0.27,"change_7d_pct":1.09,"circulating_usd":36656162.11},{"chain":"Mixin","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":31930792.17},{"chain":"Flare","change_1d_pct":-0.46,"change_7d_pct":-0.19,"circulating_usd":23081123.13},{"chain":"Stable","change_1d_pct":0.15,"change_7d_pct":26.57,"circulating_usd":19805844.51},{"chain":"Sui","change_1d_pct":-1.72,"change_7d_pct":-0.19,"circulating_usd":13124233.49},{"chain":"Injective","change_1d_pct":0.06,"change_7d_pct":-8.53,"circulating_usd":10978395.08},{"chain":"Katana","change_1d_pct":22.07,"change_7d_pct":21.52,"circulating_usd":9969577.54},{"chain":"OKTChain","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":8980663.24},{"chain":"KCC","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":8763377.23},{"chain":"Tempo","change_1d_pct":-0.92,"change_7d_pct":17.71,"circulating_usd":8694302.42},{"chain":"Linea","change_1d_pct":0,"change_7d_pct":-0.15,"circulating_usd":7749170.37},{"chain":"Unichain","change_1d_pct":-0.09,"change_7d_pct":-0.79,"circulating_usd":6463628.73},{"chain":"Conflux","change_1d_pct":0.3,"change_7d_pct":-0.76,"circulating_usd":5748416.32},{"chain":"Morph","change_1d_pct":-0.02,"change_7d_pct":-2.93,"circulating_usd":5140283.54},{"chain":"PulseChain","change_1d_pct":0.06,"change_7d_pct":0.32,"circulating_usd":4360720.71},{"chain":"Scroll","change_1d_pct":0,"change_7d_pct":-0.02,"circulating_usd":4224171.33},{"chain":"NEO","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":3858261.18},{"chain":"Zilliqa","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":3779636.15},{"chain":"Starknet","change_1d_pct":-0.31,"change_7d_pct":1.92,"circulating_usd":3585092.36},{"chain":"MegaETH","change_1d_pct":-0.2,"change_7d_pct":-35.45,"circulating_usd":3283508.62},{"chain":"Sei","change_1d_pct":-0.32,"change_7d_pct":-2.16,"circulating_usd":2978784.55},{"chain":"CORE","change_1d_pct":0.02,"change_7d_pct":-2.72,"circulating_usd":2787035.73},{"chain":"ZKsync Era","change_1d_pct":0,"change_7d_pct":-1.92,"circulating_usd":2736047.28},{"chain":"Manta","change_1d_pct":0,"change_7d_pct":0,"circulating_usd":2659101.29},{"chain":"Rootstock","change_1d_pct":1.54,"change_7d_pct":5.1,"circulating_usd":2401938.67},{"chain":"ICP","change_1d_pct":-0.01,"change_7d_pct":0.04,"circulating_usd":2364978.65}],"source":"DeFiLlama","symbol":"USDT","chain_count":115},"meta":{"timestamp":"2026-06-14T08:04:14.720Z","request_id":"f343e543-8f21-4814-8e9b-6f14be7c60f1"},"status":"ok","message":"Chain breakdown 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/history":{"get":{"operationId":"get_v1_history","tags":["Stablecoins"],"summary":"Circulating supply over time, whole asset or one chain","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Stablecoin id","schema":{"type":"string"},"example":"1"},{"name":"chain","in":"query","required":false,"description":"Chain name (e.g. Ethereum), or all (default)","schema":{"type":"string"},"example":"all"},{"name":"limit","in":"query","required":false,"description":"Days of history (1-730, default 90)","schema":{"type":"string"},"example":"90"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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},{"date":1774656000,"circulating_usd":184026240217},{"date":1774742400,"circulating_usd":184026578528},{"date":1774828800,"circulating_usd":184016535221},{"date":1774915200,"circulating_usd":184028745852},{"date":1775001600,"circulating_usd":184159950539},{"date":1775088000,"circulating_usd":184118772798},{"date":1775174400,"circulating_usd":183911609411},{"date":1775260800,"circulating_usd":184121482443},{"date":1775347200,"circulating_usd":184071591160},{"date":1775433600,"circulating_usd":184114071471},{"date":1775520000,"circulating_usd":184048975184},{"date":1775606400,"circulating_usd":184581326840},{"date":1775692800,"circulating_usd":184090007364},{"date":1775779200,"circulating_usd":184161605086},{"date":1775865600,"circulating_usd":184303056042},{"date":1775952000,"circulating_usd":184369546310},{"date":1776038400,"circulating_usd":184473344541},{"date":1776124800,"circulating_usd":184783169539},{"date":1776211200,"circulating_usd":185489007357},{"date":1776297600,"circulating_usd":185475308322},{"date":1776384000,"circulating_usd":185821418387},{"date":1776470400,"circulating_usd":186635325383},{"date":1776556800,"circulating_usd":186894729169},{"date":1776643200,"circulating_usd":187236297938},{"date":1776729600,"circulating_usd":187923234519},{"date":1776816000,"circulating_usd":188803849201},{"date":1776902400,"circulating_usd":188819383286},{"date":1776988800,"circulating_usd":189676027713},{"date":1777075200,"circulating_usd":189667328061},{"date":1777161600,"circulating_usd":189796007280},{"date":1777248000,"circulating_usd":189728350178},{"date":1777334400,"circulating_usd":189677443846},{"date":1777420800,"circulating_usd":189585888350},{"date":1777507200,"circulating_usd":189473893602},{"date":1777593600,"circulating_usd":189505305839},{"date":1777680000,"circulating_usd":189523141424},{"date":1777766400,"circulating_usd":189520130983},{"date":1777852800,"circulating_usd":189518223893},{"date":1777939200,"circulating_usd":189516819950},{"date":1778025600,"circulating_usd":189516730271},{"date":1778112000,"circulating_usd":189598356788},{"date":1778198400,"circulating_usd":189659039254},{"date":1778284800,"circulating_usd":189626653913},{"date":1778371200,"circulating_usd":189607901586},{"date":1778457600,"circulating_usd":189607901586},{"date":1778544000,"circulating_usd":189750569539},{"date":1778630400,"circulating_usd":189698522645},{"date":1778716800,"circulating_usd":189778927182},{"date":1778803200,"circulating_usd":189712008952},{"date":1778889600,"circulating_usd":189704860767},{"date":1778976000,"circulating_usd":189681810030},{"date":1779062400,"circulating_usd":189651127199},{"date":1779148800,"circulating_usd":189646051796},{"date":1779235200,"circulating_usd":190240489246},{"date":1779321600,"circulating_usd":189623712705},{"date":1779408000,"circulating_usd":189588520426},{"date":1779494400,"circulating_usd":189444911276},{"date":1779580800,"circulating_usd":189456166223},{"date":1779667200,"circulating_usd":189425056560},{"date":1779753600,"circulating_usd":189332397121},{"date":1779840000,"circulating_usd":189274715004},{"date":1779926400,"circulating_usd":189142623561},{"date":1780012800,"circulating_usd":188687496658},{"date":1780099200,"circulating_usd":188167164090},{"date":1780185600,"circulating_usd":188163969962},{"date":1780272000,"circulating_usd":187951044487},{"date":1780358400,"circulating_usd":187957633953},{"date":1780444800,"circulating_usd":187818735409},{"date":1780531200,"circulating_usd":187297618360},{"date":1780617600,"circulating_usd":187144996251},{"date":1780704000,"circulating_usd":187205889430},{"date":1780790400,"circulating_usd":186829201995},{"date":1780876800,"circulating_usd":186852587734},{"date":1780963200,"circulating_usd":186792477102},{"date":1781049600,"circulating_usd":186744890704},{"date":1781136000,"circulating_usd":186716465781},{"date":1781222400,"circulating_usd":186767756189},{"date":1781308800,"circulating_usd":186473369522},{"date":1781395200,"circulating_usd":186465415650.97}]},"meta":{"timestamp":"2026-06-14T08:04:14.854Z","request_id":"0195acdc-196f-40a6-b9bf-84ad02c54dc2"},"status":"ok","message":"Supply history 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/search":{"get":{"operationId":"get_v1_search","tags":["Stablecoins"],"summary":"Find stablecoins by name or symbol","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Name or symbol text","schema":{"type":"string"},"example":"usdc"},{"name":"limit","in":"query","required":false,"description":"Results (1-100, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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":"Supply, peg, price, change and dominance for one stablecoin","description":"","parameters":[{"name":"id","in":"query","required":true,"description":"Stablecoin id (1 = USDT, 2 = USDC, 5 = DAI; from /v1/search)","schema":{"type":"string"},"example":"1"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"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 & live sample","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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 cache. The single-stablecoin supply layer for treasury, risk, research and dashboard apps. Distinct from whole-ecosystem stablecoin feeds — one stablecoin in depth.","upstream_status":"ok"},"meta":{"timestamp":"2026-06-14T08:04:15.103Z","request_id":"2c503c8f-e9a5-4452-a2d6-25728c085c43"},"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":3100,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":1480,"monthly_call_quota":72000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":4900,"monthly_call_quota":460000,"rps_limit":20,"hard_limit":true},{"slug":"business","name":"Business","price_cents_month":15100,"monthly_call_quota":3000000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/stablecoinsupply-api"}