Circulating supply history for every tracked stablecoin in one call.

Iterates the canonical stablecoin symbol list (USDT, USDC, DAI, TUSD, FDUSD, PYUSD) and returns per-symbol history plus the latest point. Symbols with no ingestion yet come back with `latest: null` and `series: []` — the response shape is stable regardless of coverage.

Query parameters

All query parameters are optional unless marked required.

Response shape

Always wrapped in the standard envelope. Nullable fields are explicitly marked — treat missing numeric data as a real data-source gap, not as an error.

// Wrapped in the standard envelope:
// {
//   data: /* shape below */,
//   meta?: { total?: number; limit?: number; offset?: number; ... }
// }

{
  symbols: Array<{
    symbol: string;
    latest: { ts: number; circulating: number } | null;
    series: Array<{
      ts: number;
      circulating: number;
      minted24h: number | null;
      burned24h: number | null;
    }>;
  }>;
}

Example

Copy the curl, replace YOUR_KEY with a real key from your dashboard, and run.

curl -sS "http://localhost:3000/api/v1/on-chain/stablecoin/supply?days=90" \
  -H "Authorization: Bearer cg_live_YOUR_KEY"

{
  "data": {
    "symbols": [
      {
        "symbol": "USDT",
        "latest": { "ts": 1744761600000, "circulating": 112500000000 },
        "series": [
          { "ts": 1744675200000, "circulating": 112300000000, "minted24h": 200000000, "burned24h": null }
        ]
      }
    ]
  },
  "meta": { "total": 1, "days": 90 }
}

Notes

• Mint/burn are derived from day-over-day supply deltas when the upstream feed doesn't publish them directly.