{
  "endpoint": "synternet.cbbtc-dapp.total_supplies",
  "description": "Fetch the total supply and balance information for cbBTC across different blockchain networks and BTC reserves",
  "payload": {},
  "response": {
    "timestamp": {
      "type": "string",
      "format": "datetime",
      "description": "Timestamp of the data collection"
    },
    "chains_data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the blockchain network",
            "enum": ["ethereum", "base", "arbitrum", "solana"]
          },
          "amount": {
            "type": "float",
            "description": "Total cbBTC supply on the network"
          },
          "usd_amount": {
            "type": "float",
            "description": "USD value of total cbBTC supply on the network"
          }
        }
      },
      "description": "Supply information for each supported blockchain network"
    },
    "total_wrapped_supply": {
      "type": "float",
      "description": "Combined total cbBTC supply across all networks"
    },
    "total_wrapped_supply_usd": {
      "type": "float",
      "description": "USD value of combined total cbBTC 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 cbBTC supply"
    },
    "btc_diff_usd": {
      "type": "float",
      "description": "USD value of difference between total BTC and total cbBTC supply"
    }
  },
  "examples": {
    "Request": {
      "payload": {}
    },
    "Response": {
      "timestamp": "2024-03-26T12:34:56Z",
      "chains_data": [
        {
          "name": "ethereum",
          "amount": 250.75,
          "usd_amount": 10804825.75
        },
        {
          "name": "base",
          "amount": 120.5,
          "usd_amount": 5193935.50
        },
        {
          "name": "arbitrum",
          "amount": 85.25,
          "usd_amount": 3673723.25
        },
        {
          "name": "solana",
          "amount": 45.33,
          "usd_amount": 1953572.33
        }
      ],
      "total_wrapped_supply": 501.83,
      "total_wrapped_supply_usd": 21626056.83,
      "btc_total_supply": 520.0,
      "btc_total_supply_usd": 22407800.00,
      "btc_diff": 18.17,
      "btc_diff_usd": 781743.17
    }
  },
  "notes": [
    "All USD values are calculated using current cbBTC price",
    "BTC diff can be positive (excess reserves) or negative (insufficient reserves)",
    "Custodial balances are tracked and updated from Coinbase's Proof of Reserves",
    "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, Base, and Arbitrum networks, supplies are calculated directly from the respective contracts",
    "Solana supply is tracked from the cbBTC SPL token account",
    "BTC total supply represents the sum of balances in verified custodial addresses maintained by Coinbase"
  ],
  "update_frequency": "Data is updated approximately every 15 minutes"
}