# Stablecoin Supply Tracker (USDT, USDC, DAI by chain) (`gochujang/stablecoin-supply-tracker`) Actor Live circulating supply for every stablecoin broken down by chain (USDT, USDC, DAI, FDUSD, USDe, sUSD…) with 1d/7d/30d deltas. Detects large mint/burn events. Macro liquidity leading indicator. DefiLlama data, no API key. - **URL**: https://apify.com/gochujang/stablecoin-supply-tracker.md - **Developed by:** [Hojun Lee](https://apify.com/gochujang) (community) - **Categories:** Developer tools, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Stablecoin Supply Tracker > Live circulating supply for every stablecoin broken down by chain, with 1d / 7d / 30d deltas. Detect large mint/burn events. **Free macro liquidity leading indicator. No API key.** --- ### Why this exists Stablecoin supply is the cleanest **leading indicator** for crypto market liquidity: - A **net mint** of $1B+ on Ethereum USDT typically precedes a price move within days - A **net burn** of similar magnitude has historically marked local tops - Paid services charge $30–$300/mo for the same data — this actor returns it for **$0.001 per row** DefiLlama's stablecoin feed is the gold-standard public data source. This actor wraps it with sane defaults, deltas (1d/7d/30d in USD and %), and Telegram alerts. --- ### What you get per row | Field | Example | Notes | |---|---|---| | `symbol` | `USDT` | | | `chain` | `Tron` | DefiLlama chain name | | `circulating_usd` | `88,136,779,090.78` | USD-denominated | | `circulating_units` | `88,202,697,389.28` | base token units | | `delta_24h_usd` | `-25,244,404.74` | net mint (positive) or burn (negative) | | `delta_7d_usd` | `-516,203,629.53` | | | `delta_30d_usd` | `9,457,971.37` | | | `delta_24h_pct` | `-0.0286` | % of circulating supply | | `delta_7d_pct` | `-0.5856` | | | `peg_type` | `peggedUSD` | DefiLlama peg classification | | `price_usd` | `0.9992` | live price | --- ### Use cases 1. **Macro positioning** — Net USDT/USDC mint > $500M in 24h = bullish liquidity signal 2. **Risk-off detection** — Net stablecoin burn = capital leaving the system 3. **Chain rotation** — Where stablecoins are minting reveals which ecosystem is hot 4. **Quant signals** — Add stablecoin delta as a feature to your model 5. **Alerts** — Telegram alert on any single 24h delta ≥ $X USD threshold --- ### Quick start #### Default — top 200 stablecoin/chain combinations by circulating ```json {} ```` #### Track USDT + USDC only across Ethereum, Tron, BSC, Solana ```json { "symbols": ["USDT", "USDC"], "chains": ["Ethereum", "Tron", "BSC", "Solana"], "sortBy": "delta_24h_desc" } ``` #### Watch for $100M+ daily mint/burn events ```json { "alertMintBurnUsd": 100000000, "telegramBotToken": "YOUR_BOT_TOKEN", "telegramChatId": "YOUR_CHAT_ID" } ``` *** ### Pricing **Pay-Per-Event**: `$0.001 per stablecoin/chain row returned.` | Run | Rows | Cost | |---|---|---| | All stablecoins, all chains | ~600 | $0.60 | | Top 5 stablecoins × top 10 chains | 50 | $0.05 | | USDT/USDC only | 30 | $0.03 | | Daily run (default) | 200 | $0.20 | No subscription. No platform fees. You pay only for rows returned. *** ### Output sort options | `sortBy` | Description | |---|---| | `circulating_desc` | Largest stablecoin/chain combos first (default) | | `delta_24h_desc` | Biggest 24h mints first | | `delta_24h_asc` | Biggest 24h burns first | | `delta_7d_desc` | Biggest 7d growth first | *** ### Data source [DefiLlama Stablecoins API](https://stablecoins.llama.fi/stablecoins) — free, no API key, updated continuously. *** ### Related actors (same author) - [Smart Money Wallet Tracker](https://apify.com/gochujang/smart-money-tracker) — Follow the on-chain alpha wallets - [Stablecoin Depeg Monitor](https://apify.com/gochujang/stablecoin-depeg-monitor) — Real-time peg deviation alerts - [Multi-Chain Gas Tracker](https://apify.com/gochujang/multichain-gas-tracker) — Where activity is happening across L1s/L2s - [DeFi Yield APY Scanner](https://apify.com/gochujang/defi-yield-scanner) — Best yield for your stablecoins *** *** ### 🎬 Live Sample Run A real run of this actor with default-ish inputs, executed on 2026-06-10: | Field | Value | |---|---| | Items in dataset | 20 | | Dataset (JSON) | `https://api.apify.com/v2/datasets/O80Ur45VEPb4WXYDe/items?clean=1&format=json` | | Dataset (CSV) | `https://api.apify.com/v2/datasets/O80Ur45VEPb4WXYDe/items?clean=1&format=csv` | | Run summary (KVS) | `https://api.apify.com/v2/key-value-stores/IuZzAzRPwVaPvfjUD/records/SUMMARY` | | Run details | `https://api.apify.com/v2/actor-runs/aTXqtpm5717sZzoe7` | **Try it now**: pop any of the dataset URLs in your browser to see live output, or hit the API endpoints from your code. > Want to reproduce? Click **Try Actor** on the Apify Store page and use the input defaults shown above. ### Feedback A short review helps other traders find it: [Leave a review on Apify Store](https://apify.com/gochujang/stablecoin-supply-tracker#reviews) # Actor input Schema ## `symbols` (type: `array`): Stablecoin tickers to include (USDT, USDC, DAI, FDUSD, USDe, sUSD, …). Empty = all. ## `chains` (type: `array`): Chain names (Ethereum, Tron, BSC, Solana, …). Empty = all chains. ## `minCirculatingUsd` (type: `integer`): Skip stablecoin/chain rows with circulating supply below this. ## `sortBy` (type: `string`): Sort order for rows. ## `limit` (type: `integer`): Max rows to return after filter/sort. ## `alertMintBurnUsd` (type: `integer`): Telegram alert when 24h |delta| ≥ this USD value. 0 = disabled. ## `telegramBotToken` (type: `string`): Telegram bot token. ## `telegramChatId` (type: `string`): Chat ID. ## Actor input object example ```json { "symbols": [ "USDT", "USDC", "DAI", "FDUSD", "USDe", "PYUSD" ], "chains": [], "minCirculatingUsd": 50000000, "sortBy": "circulating_desc", "limit": 200, "alertMintBurnUsd": 0, "telegramChatId": "" } ``` # Actor output Schema ## `dataset` (type: `string`): No description ## `summary` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "symbols": [ "USDT", "USDC", "DAI", "FDUSD", "USDe", "PYUSD" ] }; // Run the Actor and wait for it to finish const run = await client.actor("gochujang/stablecoin-supply-tracker").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "symbols": [ "USDT", "USDC", "DAI", "FDUSD", "USDe", "PYUSD", ] } # Run the Actor and wait for it to finish run = client.actor("gochujang/stablecoin-supply-tracker").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "symbols": [ "USDT", "USDC", "DAI", "FDUSD", "USDe", "PYUSD" ] }' | apify call gochujang/stablecoin-supply-tracker --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=gochujang/stablecoin-supply-tracker", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Stablecoin Supply Tracker (USDT, USDC, DAI by chain)", "description": "Live circulating supply for every stablecoin broken down by chain (USDT, USDC, DAI, FDUSD, USDe, sUSD…) with 1d/7d/30d deltas. Detects large mint/burn events. Macro liquidity leading indicator. DefiLlama data, no API key.", "version": "0.1", "x-build-id": "zqkF2RfL8n5T4qu7v" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/gochujang~stablecoin-supply-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-gochujang-stablecoin-supply-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/gochujang~stablecoin-supply-tracker/runs": { "post": { "operationId": "runs-sync-gochujang-stablecoin-supply-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/gochujang~stablecoin-supply-tracker/run-sync": { "post": { "operationId": "run-sync-gochujang-stablecoin-supply-tracker", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "symbols": { "title": "Stablecoin symbols", "type": "array", "description": "Stablecoin tickers to include (USDT, USDC, DAI, FDUSD, USDe, sUSD, …). Empty = all.", "default": [], "items": { "type": "string" } }, "chains": { "title": "Chains", "type": "array", "description": "Chain names (Ethereum, Tron, BSC, Solana, …). Empty = all chains.", "default": [], "items": { "type": "string" } }, "minCirculatingUsd": { "title": "Min circulating supply (USD)", "minimum": 0, "type": "integer", "description": "Skip stablecoin/chain rows with circulating supply below this.", "default": 50000000 }, "sortBy": { "title": "Sort by", "enum": [ "circulating_desc", "delta_24h_desc", "delta_24h_asc", "delta_7d_desc" ], "type": "string", "description": "Sort order for rows.", "default": "circulating_desc" }, "limit": { "title": "Max rows", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Max rows to return after filter/sort.", "default": 200 }, "alertMintBurnUsd": { "title": "Mint/burn alert ($USD)", "minimum": 0, "type": "integer", "description": "Telegram alert when 24h |delta| ≥ this USD value. 0 = disabled.", "default": 0 }, "telegramBotToken": { "title": "Telegram Bot Token", "type": "string", "description": "Telegram bot token." }, "telegramChatId": { "title": "Telegram Chat ID", "type": "string", "description": "Chat ID.", "default": "" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```