Skip to main content

Public API

Three read-only JSON endpoints over the same data that powers this site. No API key, no signup, CORS open to any origin. Attribution required.

Base URL
https://usd.net/api/public/v1
Rate limit
60 requests / minute / IP
Cache
60s browser, 300s edge
GET

/api/public/v1/assets

Every tracked dollar asset — stablecoins, tokenized Treasuries, gold and stocks — with price, peg deviation, supply, yield and safety score, plus the per-chain supply split.

  • limit — 1–500, default 200
  • category — stablecoin | rwa
  • chain — chain name, e.g. ethereum, tron, base
Request
curl -s "https://usd.net/api/public/v1/assets?limit=2"
Response (trimmed)
{
  "updatedAt": "2026-08-18T15:05:01.141+00:00",
  "count": 2,
  "assets": [
    {
      "slug": "usdt",
      "ticker": "USDT",
      "name": "Tether",
      "category": "stablecoin",
      "assetClass": "pegged",
      "issuer": "Tether",
      "price": 0.9991524857,
      "pegTarget": 1,
      "pegDeviationPct": -0.08475143,
      "marketCap": 182941887682.28,
      "change7dPct": 0.52980971,
      "change30dPct": -0.59484690,
      "liquidityUsd": 3510635011,
      "yieldApy": 17.67304,
      "vettedYieldApy": 4.27,
      "safetyScore": 75,
      "chains": [{ "chain": "Tron", "supply": 81234567890, "sharePct": 44.4 }],
      "url": "https://usd.net/asset/usdt"
    }
  ],
  "attribution": { "source": "usd.net" }
}
GET

/api/public/v1/chains

Stablecoin market cap per chain with 7d/30d change, the dominant asset on that chain and how many distinct dollar assets it hosts. Sorted by supply.

Request
curl -s "https://usd.net/api/public/v1/chains"
Response (trimmed)
{
  "updatedAt": "2026-08-18T15:05:01.141+00:00",
  "count": 133,
  "chains": [
    {
      "slug": "ethereum",
      "name": "Ethereum",
      "stablecoinMcap": 146705364297.04,
      "change7dPct": -0.55970981,
      "change30dPct": -2.76078425,
      "dominantAsset": "USDT",
      "dominancePct": 50.54311927,
      "assetCount": 161,
      "url": "https://usd.net/chain/ethereum"
    }
  ],
  "attribution": { "source": "usd.net" }
}
GET

/api/public/v1/stats

One-call market summary: total on-chain dollar assets, the stablecoin/RWA split, average peg deviation and the current list of off-peg assets (≥0.5% away from target).

Request
curl -s "https://usd.net/api/public/v1/stats"
Response (trimmed)
{
  "updatedAt": "2026-08-18T15:05:01.141+00:00",
  "stats": {
    "totalDollarAssetsUsd": 328465115796.84,
    "stablecoinSupplyUsd": 301551282794.31,
    "rwaSupplyUsd": 26913833002.53,
    "assetCount": 214,
    "chainCount": 133,
    "avgPegDeviationPct": 0.09467444,
    "change7dPct": 0.43122674,
    "offPegCount": 23,
    "offPegAssets": [{ "ticker": "FRAX", "pegDeviationPct": -0.87565483 }],
    "largestChain": "Ethereum"
  },
  "attribution": { "source": "usd.net" }
}

Notes

  • Every response carries updatedAt — the timestamp of the underlying data refresh, not of your request.
  • Rate limit headers: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset. Exceeding it returns HTTP 429 with a JSON error body.
  • Free for any use, including commercial, with visible attribution: “Source: usd.net” linking back to this site.
  • Data is aggregated from public sources and provided as-is, with no warranty of accuracy. Do not use it as the sole input for settlement or custody decisions.