Stablecoin Supply Lookup (by Chain or by Coin)

omnial/x402-stablecoin-flow-check

Given a blockchain name or a stablecoin symbol, returns stablecoin supply data sourced from DeFi Llama: querying by chain returns that chain's total stablecoin supply with a currency-peg breakdown, while querying by stablecoin returns that coin's total supply, price, the list of chains it is deployed on, and peg metadata (mechanism, type, DeFi Llama gecko id).

activeper callv3

Price

Up to $0.0325 per call; you pay what the call used

You pay the price shown. If a call turns out to cost more than its quote, you pay the actual price, capped at twice the quote. No monthly minimum. Top-ups start at $5.00.

Use it

Your AI assistant does the work: it finds this tool, shows you the price first, runs it, and you are charged when the run finishes. There is nothing to set up for this tool in particular.

Connect once and your AI can find and run this tool, and any other it needs.

Install it Create an account

For developers: the calls your assistant makes

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/x402-stablecoin-flow-check" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/x402-stablecoin-flow-check" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/x402-stablecoin-flow-check", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/x402-stablecoin-flow-check", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Per call	$0.0325

Updated: Oct 27, 2026

Input and output schemas

Input schema

input_schema.json

{
  "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
}

Output schema

output_schema.json

{
  "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 for Ethereum, 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. Usually null."
        },
        "circulating_prev_week": {
          "type": [
            "number",
            "null"
          ],
          "description": "Chain-mode only: supply one week prior. Usually null."
        },
        "circulating_prev_month": {
          "type": [
            "number",
            "null"
          ],
          "description": "Chain-mode only: supply one month prior. Usually null."
        }
      },
      "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. Shape depends on which input was supplied: `query_type: \"chain\"` (queried by `chain`) or `query_type: \"stablecoin\"` (queried by `stablecoin`) -- treat fields not documented for a mode as possibly absent rather than guaranteed.",
  "additionalProperties": true
}