Stablecoin Supply Lookup (by Chain or by Coin)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "chain"
      ]
    },
    {
      "required": [
        "stablecoin"
      ]
    }
  ],
  "properties": {
    "chain": {
      "type": "string",
      "description": "Chain name (e.g., 'Ethereum', 'Base', 'Solana')"
    },
    "stablecoin": {
      "type": "string",
      "description": "Stablecoin name (e.g., 'USDC', 'USDT')"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Stablecoin-mode only: the coin's public display name, e.g. 'USD Coin' for USDC."
    },
    "_meta": {
      "type": "object",
      "properties": {
        "provenance": {
          "type": "object",
          "properties": {
            "source": {
              "type": "string",
              "description": "The underlying data source, e.g. 'stablecoins.llama.fi' (DeFi Llama)."
            },
            "fetched_at": {
              "type": "string",
              "description": "ISO-8601 timestamp of when the upstream data was fetched."
            }
          },
          "additionalProperties": true
        }
      },
      "description": "Data-source attribution for this response.",
      "additionalProperties": true
    },
    "chain": {
      "type": "string",
      "description": "Chain-mode only: the chain name, echoed back from the input."
    },
    "price": {
      "type": "number",
      "description": "Stablecoin-mode only: the coin's current price in USD (its peg quote)."
    },
    "chains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Stablecoin-mode only: every chain the coin is deployed on. Observed with 180+ entries for USDC -- do not assume a short or fixed-length list."
    },
    "details": {
      "type": "object",
      "properties": {
        "gecko_id": {
          "type": "string",
          "description": "Stablecoin-mode only: the coin's DeFi Llama / CoinGecko id."
        },
        "peg_type": {
          "type": "string",
          "description": "Stablecoin-mode only: what currency the coin is pegged to, e.g. 'peggedUSD'."
        },
        "peg_mechanism": {
          "type": "string",
          "description": "Stablecoin-mode only: how the peg is maintained, e.g. 'fiat-backed'."
        },
        "circulating_usd": {
          "type": "object",
          "description": "Chain-mode only: total circulating supply broken out by currency peg, keyed by peg code (e.g. 'peggedUSD', 'peggedEUR', 'peggedJPY' -- 20 peg codes observed on the Ethereum fixture, not an exhaustive or fixed list). Every value observed was a USD-denominated number.",
          "additionalProperties": {
            "type": "number"
          }
        },
        "circulating_prev_day": {
          "type": [
            "number",
            "null"
          ],
          "description": "Chain-mode only: supply one day prior. Observed null on the one fixture captured."
        },
        "circulating_prev_week": {
          "type": [
            "number",
            "null"
          ],
          "description": "Chain-mode only: supply one week prior. Observed null on the one fixture captured."
        },
        "circulating_prev_month": {
          "type": [
            "number",
            "null"
          ],
          "description": "Chain-mode only: supply one month prior. Observed null on the one fixture captured."
        }
      },
      "description": "Chain-mode and stablecoin-mode populate different sub-fields here: chain-mode holds a currency-peg supply breakdown and prior-period totals; stablecoin-mode holds peg metadata for the coin itself.",
      "additionalProperties": true
    },
    "query_type": {
      "type": "string",
      "description": "'chain' or 'stablecoin', matching which input parameter was supplied."
    },
    "stablecoin": {
      "type": "string",
      "description": "Stablecoin-mode only: the stablecoin symbol, echoed back from the input."
    },
    "total_supply_usd": {
      "type": "number",
      "description": "Total stablecoin supply in USD, for the queried chain or the queried coin."
    }
  },
  "description": "The stablecoin-flow result, as returned at routing.responseResultPath ($.output). Shape depends on which input was supplied: `query_type: \"chain\"` (queried by `chain`) or `query_type: \"stablecoin\"` (queried by `stablecoin`) -- only one fixture of each mode has been observed, so treat fields not present in that mode's fixture as possibly absent rather than guaranteed.",
  "additionalProperties": true
}