{
  "endpoint": "synternet.tbtc-dapp.total_supplies",
  "description": "Fetch the total supply and balance information for tBTC across different blockchain networks and BTC reserves",
  "payload": {},
  "response": {
    "timestamp": {
      "type": "string",
      "format": "datetime",
      "description": "Timestamp of the data collection"
    },
    "eth_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Ethereum network"
    },
    "eth_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Ethereum network"
    },
    "arbitrum_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Arbitrum network"
    },
    "arbitrum_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Arbitrum network"
    },
    "base_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Base network"
    },
    "base_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Base network"
    },
    "optimism_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Optimism network"
    },
    "optimism_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Optimism network"
    },
    "polygon_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Polygon network"
    },
    "polygon_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Polygon network"
    },
    "solana_total_supply": {
      "type": "float",
      "description": "Total tBTC supply on Solana network"
    },
    "solana_total_supply_usd": {
      "type": "float",
      "description": "USD value of total tBTC supply on Solana network"
    },
    "total_tbtc_supply": {
      "type": "float",
      "description": "Combined total tBTC supply across all networks"
    },
    "total_tbtc_supply_usd": {
      "type": "float",
      "description": "USD value of combined total tBTC supply"
    },
    "btc_total_supply": {
      "type": "float",
      "description": "Total BTC in all custodial addresses"
    },
    "btc_total_supply_usd": {
      "type": "float",
      "description": "USD value of total BTC in all custodial addresses"
    },
    "btc_diff": {
      "type": "float",
      "description": "Difference between total BTC (custodial) and total tBTC supply"
    },
    "btc_diff_usd": {
      "type": "float",
      "description": "USD value of difference between total BTC and total tBTC supply"
    }
  },
  "examples": {
    "Request": {
      "payload": {}
    },
    "Response": {
      "timestamp": "2024-03-26T12:34:56Z",
      "eth_total_supply": 200.75,
      "eth_total_supply_usd": 8642000.75,
      "arbitrum_total_supply": 150.25,
      "arbitrum_total_supply_usd": 6481500.25,
      "base_total_supply": 75.5,
      "base_total_supply_usd": 3251500.50,
      "optimism_total_supply": 50.25,
      "optimism_total_supply_usd": 2165775.25,
      "polygon_total_supply": 30.12,
      "polygon_total_supply_usd": 1297770.12,
      "solana_total_supply": 25.33,
      "solana_total_supply_usd": 1091210.33,
      "total_tbtc_supply": 532.2,
      "total_tbtc_supply_usd": 22929757.20,
      "btc_total_supply": 560.0,
      "btc_total_supply_usd": 24136800.00,
      "btc_diff": 27.8,
      "btc_diff_usd": 1207042.80
    }
  },
  "notes": [
    "All USD values are calculated using current tBTC price",
    "BTC diff can be positive (excess reserves) or negative (insufficient reserves)",
    "Custodial balances are tracked and updated from blockchain.info",
    "This endpoint requires no parameters",
    "Returns the most recent data from the monitoring database",
    "Supplies are calculated based on mint and burn events on each network",
    "For Ethereum (L1), supply is calculated directly from the contract",
    "For L2 networks (Arbitrum, Base, Optimism, Polygon), supplies are tracked via cross-chain transfer events",
    "Solana supply is tracked from the tBTC SPL token account",
    "BTC total supply represents the sum of balances in verified custodial addresses"
  ],
  "update_frequency": "Data is updated approximately every 15 minutes"
}