--- title: "Stablecoin historical flows" method: GET path: "/api/v1/defi/stablecoins/charts" tags: ["Digital Economy and Infrastructure"] --- # Stablecoin historical flows `GET /api/v1/defi/stablecoins/charts` Historical stablecoin circulating supply and flows. Daily data since 2019. Shows total stablecoin market cap over time - key indicator of crypto liquidity. Optionally filter by chain (ethereum, bsc, solana, etc.). Returns last 365 days. ## Query parameters - `chain` string — Chain name (e.g. ethereum, bsc, solana). Omit for all chains ## Response `200` Historical stablecoin circulating supply flows (daily, last 365 days). - EnvelopeDefiStablecoinsChartsData - `data` DefiStablecoinsChartsData, required - `chain` string, required — Blockchain identifier. - `count` integer, required — Number of items in this result set. - `charts` Chart[], required — Array of chart records. - `date` string, required — Observation date (YYYY-MM-DD). - `totalCirculating` TotalCirculating, required - `peggedUSD` number, required — Count or amount of stablecoins pegged to USD. - `peggedVAR` number, required — Count or amount of algorithmic (variable-peg) stablecoins. - `peggedEUR` number, required — Count or amount of stablecoins pegged to Euro. - `peggedJPY` number, required — Count or amount of stablecoins pegged to Japanese Yen. - `peggedCNY` integer, required — Count or amount of stablecoins pegged to Chinese Yuan. - `peggedUAH` number, required — Count or amount of stablecoins pegged to Ukrainian Hryvnia. - `peggedARS` number, required — Count or amount of stablecoins pegged to Argentine Peso. - `peggedGBP` number, required — Count or amount of stablecoins pegged to British Pound. - `peggedCAD` number, required — Count or amount of stablecoins pegged to Canadian Dollar. - `peggedCHF` number, required — Count or amount of stablecoins pegged to Swiss Franc. - `peggedAUD` number, required — Count or amount of stablecoins pegged to Australian Dollar. - `peggedREAL` number, required — Count or amount of stablecoins pegged to Brazilian Real. - `peggedRUB` number, nullable — Count or amount of stablecoins pegged to Russian Ruble. - `peggedMXN` integer, nullable — Count or amount of stablecoins pegged to Mexican Peso. - `peggedSGD` number, nullable — Count or amount of stablecoins pegged to Singapore Dollar. - `peggedTRY` number, nullable — Count or amount of stablecoins pegged to Turkish Lira. - `peggedPHP` number, nullable — Count or amount of stablecoins pegged to Philippine Peso. - `peggedCOP` number, nullable — Count or amount of stablecoins pegged to Colombian Peso. - `peggedKES` number, nullable — Count or amount of stablecoins pegged to Kenyan Shilling. - `peggedZAR` number, nullable — Count or amount of stablecoins pegged to South African Rand. - `peggedNGN` number, nullable — Count or amount of stablecoins pegged to Nigerian Naira. - `peggedXOF` number, nullable — Count or amount of stablecoins pegged to West African CFA Franc. - `peggedGHS` number, nullable — Count or amount of stablecoins pegged to Ghanaian Cedi. - `totalUnreleased` TotalUnreleased, required - `peggedUSD` number, required — Count or amount of stablecoins pegged to USD. - `peggedVAR` number, required — Count or amount of algorithmic (variable-peg) stablecoins. - `peggedEUR` number, required — Count or amount of stablecoins pegged to Euro. - `peggedCNY` integer, nullable — Count or amount of stablecoins pegged to Chinese Yuan. - `peggedMXN` integer, nullable — Count or amount of stablecoins pegged to Mexican Peso. - `peggedTRY` number, nullable — Count or amount of stablecoins pegged to Turkish Lira. - `peggedRUB` integer, nullable — Count or amount of stablecoins pegged to Russian Ruble. - `peggedJPY` integer, nullable — Count or amount of stablecoins pegged to Japanese Yen. - `peggedUAH` integer, nullable — Count or amount of stablecoins pegged to Ukrainian Hryvnia. - `peggedARS` integer, nullable — Count or amount of stablecoins pegged to Argentine Peso. - `peggedGBP` integer, nullable — Count or amount of stablecoins pegged to British Pound. - `peggedCAD` integer, nullable — Count or amount of stablecoins pegged to Canadian Dollar. - `peggedCHF` integer, nullable — Count or amount of stablecoins pegged to Swiss Franc. - `peggedAUD` integer, nullable — Count or amount of stablecoins pegged to Australian Dollar. - `peggedREAL` integer, nullable — Count or amount of stablecoins pegged to Brazilian Real. - `peggedSGD` integer, nullable — Count or amount of stablecoins pegged to Singapore Dollar. - `peggedPHP` integer, nullable — Count or amount of stablecoins pegged to Philippine Peso. - `peggedCOP` integer, nullable — Count or amount of stablecoins pegged to Colombian Peso. - `peggedKES` integer, nullable — Count or amount of stablecoins pegged to Kenyan Shilling. - `peggedZAR` integer, nullable — Count or amount of stablecoins pegged to South African Rand. - `peggedNGN` integer, nullable — Count or amount of stablecoins pegged to Nigerian Naira. - `peggedXOF` integer, nullable — Count or amount of stablecoins pegged to West African CFA Franc. - `peggedGHS` integer, nullable — Count or amount of stablecoins pegged to Ghanaian Cedi. - `totalCirculatingUSD` TotalCirculatingUSD, required - `peggedUSD` number, nullable — Count or amount of stablecoins pegged to USD. - `peggedREAL` number, nullable — Count or amount of stablecoins pegged to Brazilian Real. - `peggedRUB` number, nullable — Count or amount of stablecoins pegged to Russian Ruble. - `peggedCNY` integer, nullable — Count or amount of stablecoins pegged to Chinese Yuan. - `peggedSGD` number, nullable — Count or amount of stablecoins pegged to Singapore Dollar. - `peggedCHF` number, nullable — Count or amount of stablecoins pegged to Swiss Franc. - `peggedEUR` number, nullable — Count or amount of stablecoins pegged to Euro. - `peggedVAR` number, nullable — Count or amount of algorithmic (variable-peg) stablecoins. - `peggedUAH` integer, nullable — Count or amount of stablecoins pegged to Ukrainian Hryvnia. - `peggedARS` integer, nullable — Count or amount of stablecoins pegged to Argentine Peso. - `peggedGBP` number, nullable — Count or amount of stablecoins pegged to British Pound. - `peggedCAD` number, nullable — Count or amount of stablecoins pegged to Canadian Dollar. - `peggedTRY` number, nullable — Count or amount of stablecoins pegged to Turkish Lira. - `peggedJPY` number, nullable — Count or amount of stablecoins pegged to Japanese Yen. - `peggedAUD` number, nullable — Count or amount of stablecoins pegged to Australian Dollar. - `peggedMXN` integer, nullable — Count or amount of stablecoins pegged to Mexican Peso. - `totalMintedUSD` TotalBridgedToUSD - `peggedUSD` integer, required — Count or amount of stablecoins pegged to USD. - `peggedVAR` integer, required — Count or amount of algorithmic (variable-peg) stablecoins. - `peggedEUR` integer, required — Count or amount of stablecoins pegged to Euro. - `peggedJPY` integer, required — Count or amount of stablecoins pegged to Japanese Yen. - `peggedCNY` integer, required — Count or amount of stablecoins pegged to Chinese Yuan. - `peggedUAH` integer, required — Count or amount of stablecoins pegged to Ukrainian Hryvnia. - `peggedARS` integer, required — Count or amount of stablecoins pegged to Argentine Peso. - `peggedGBP` integer, required — Count or amount of stablecoins pegged to British Pound. - `peggedCAD` integer, required — Count or amount of stablecoins pegged to Canadian Dollar. - `peggedCHF` integer, required — Count or amount of stablecoins pegged to Swiss Franc. - `peggedAUD` integer, required — Count or amount of stablecoins pegged to Australian Dollar. - `peggedREAL` integer, required — Count or amount of stablecoins pegged to Brazilian Real. - `peggedRUB` integer, required — Count or amount of stablecoins pegged to Russian Ruble. - `peggedMXN` integer, required — Count or amount of stablecoins pegged to Mexican Peso. - `peggedSGD` integer, required — Count or amount of stablecoins pegged to Singapore Dollar. - `peggedPHP` integer, required — Count or amount of stablecoins pegged to Philippine Peso. - `peggedTRY` integer, required — Count or amount of stablecoins pegged to Turkish Lira. - `peggedCOP` integer, required — Count or amount of stablecoins pegged to Colombian Peso. - `peggedKES` integer, required — Count or amount of stablecoins pegged to Kenyan Shilling. - `peggedZAR` integer, required — Count or amount of stablecoins pegged to South African Rand. - `peggedNGN` integer, required — Count or amount of stablecoins pegged to Nigerian Naira. - `peggedXOF` integer, required — Count or amount of stablecoins pegged to West African CFA Franc. - `peggedGHS` integer, required — Count or amount of stablecoins pegged to Ghanaian Cedi. - `totalBridgedToUSD` TotalBridgedToUSD - `peggedUSD` integer, required — Count or amount of stablecoins pegged to USD. - `peggedVAR` integer, required — Count or amount of algorithmic (variable-peg) stablecoins. - `peggedEUR` integer, required — Count or amount of stablecoins pegged to Euro. - `peggedJPY` integer, required — Count or amount of stablecoins pegged to Japanese Yen. - `peggedCNY` integer, required — Count or amount of stablecoins pegged to Chinese Yuan. - `peggedUAH` integer, required — Count or amount of stablecoins pegged to Ukrainian Hryvnia. - `peggedARS` integer, required — Count or amount of stablecoins pegged to Argentine Peso. - `peggedGBP` integer, required — Count or amount of stablecoins pegged to British Pound. - `peggedCAD` integer, required — Count or amount of stablecoins pegged to Canadian Dollar. - `peggedCHF` integer, required — Count or amount of stablecoins pegged to Swiss Franc. - `peggedAUD` integer, required — Count or amount of stablecoins pegged to Australian Dollar. - `peggedREAL` integer, required — Count or amount of stablecoins pegged to Brazilian Real. - `peggedRUB` integer, required — Count or amount of stablecoins pegged to Russian Ruble. - `peggedMXN` integer, required — Count or amount of stablecoins pegged to Mexican Peso. - `peggedSGD` integer, required — Count or amount of stablecoins pegged to Singapore Dollar. - `peggedPHP` integer, required — Count or amount of stablecoins pegged to Philippine Peso. - `peggedTRY` integer, required — Count or amount of stablecoins pegged to Turkish Lira. - `peggedCOP` integer, required — Count or amount of stablecoins pegged to Colombian Peso. - `peggedKES` integer, required — Count or amount of stablecoins pegged to Kenyan Shilling. - `peggedZAR` integer, required — Count or amount of stablecoins pegged to South African Rand. - `peggedNGN` integer, required — Count or amount of stablecoins pegged to Nigerian Naira. - `peggedXOF` integer, required — Count or amount of stablecoins pegged to West African CFA Franc. - `peggedGHS` integer, required — Count or amount of stablecoins pegged to Ghanaian Cedi. - `meta` SugraMeta, required — Metadata attached to every /api/v1/* response envelope. - `endpoint` string, required — Requested endpoint path. - `data_time` string, required — ISO 8601 UTC timestamp of the source data, not of the request. - `response_time` string, required — ISO 8601 UTC timestamp when this response was produced. - `provider` string, required — API name and version. - `source` string, nullable — Identifier of the primary upstream source used for this response. - `attribution` string, nullable — Human-readable attribution mandated by an upstream source (e.g. a securities regulator or self-regulatory organization). Present only on responses whose source requires the owner and source to be clearly identified. Do not remove or alter it when using the response. - `fallback_used` boolean, nullable — True when the primary source failed and a fallback produced the data. - `fallback_chain` string[], nullable — Ordered list of sources attempted, in the order they were tried. - `cached` boolean, nullable — True when this response was served from the internal cache. - `stale` boolean, nullable — True when the cached response was returned after the upstream rate-limited or errored. Clients can use this to detect degraded data. ## Other responses - `401` — Missing or invalid `x-api-key` header. - `422` — Validation Error - `429` — Daily rate limit exceeded. Check `X-RateLimit-Reset` for the next window. - `503` — Upstream source is temporarily unavailable. Retry after a short delay. --- [API](https://skmtc.net/sugra/apis/sugra-api.md) · [All operations](https://skmtc.net/sugra/apis/sugra-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sugra/sugra-api/versions/4e2740743eb4/schema)