# 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:** Business, News, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$1.00 / 1,000 stablecoin/chain trackeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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.**

***

### ⚡ Run in 30 seconds

Click **Start** with default settings — returns live circulating supply for major stablecoins (USDT, USDC, DAI, and more) broken down by chain, with 1-day, 7-day, and 30-day supply deltas to flag large mint or burn events. No API key needed.

***

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `symbols` | array | `[]` | Stablecoin tickers to include (USDT, USDC, DAI, FDUSD, USDe, |
| `chains` | array | `[]` | Chain names (Ethereum, Tron, BSC, Solana, …). Empty = all ch |
| `minCirculatingUsd` | integer | `50000000` | Skip stablecoin/chain rows with circulating supply below thi |
| `sortBy` | string | `circulating_desc` | Sort order for rows. |
| `limit` | integer | `200` | Max rows to return after filter/sort. |
| `alertMintBurnUsd` | integer | `0` | Telegram alert when 24h |delta| ≥ this USD value. 0 = disabl |
| `telegramBotToken` | string | `—` | Telegram bot token. |
| `telegramChatId` | string | \`\` | Telegram chat ID to send alerts to (get it from @userinfobot |

***

### 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)

**Keywords:** stablecoin supply tracker, USDT circulating supply, USDC on-chain data, stablecoin mint burn events, cross-chain stablecoin, crypto liquidity indicator, DefiLlama data

# Actor input Schema

## `mode` (type: `string`):

What to return. 'summary': top stablecoins by market cap with price and change stats. 'chain\_distribution': how each stablecoin is distributed across chains. 'depeg\_monitor': only stablecoins currently deviating from their peg. 'all': summary + chain distribution.

## `top_n` (type: `integer`):

Return data for the top N stablecoins by market cap. Max 423 (all). Only applies to summary and chain\_distribution modes.

## `top_chains` (type: `integer`):

For chain\_distribution mode: how many chains to show per stablecoin.

## `depeg_threshold` (type: `number`):

Minimum peg deviation (%) to include in depeg\_monitor mode. Default 0.5% means stablecoins trading above $1.005 or below $0.995.

## `peg_types` (type: `array`):

Filter to specific peg types. Leave empty for all. Options: USD, EUR, GBP, JPY, SGD, CNY, CAD, AUD, Gold, Variable.

## Actor input object example

```json
{
  "mode": "summary",
  "top_n": 50,
  "top_chains": 10,
  "depeg_threshold": 0.5,
  "peg_types": []
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// 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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# 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(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call gochujang/stablecoin-supply-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gochujang/stablecoin-supply-tracker"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/jI6VcRyhkxgMiguVQ/builds/s4TS6pwUX7dkE1W4l/openapi.json