Methodology

> cbwrapped tracks the circulating supply of Coinbase wrapped assets across multiple blockchains using publicly verifiable on-chain data. This page explains our data sources, calculation methods, and update frequencies.

> Data_Sources

All data displayed on cbwrapped comes from three sources:

  • >On-chain RPC — Supply data is read directly from public blockchain smart contracts by calling totalSupply() on each token contract. No internal Coinbase APIs are used.
  • >Dune Analytics — DEX trading volume is sourced from Dune Analytics, which indexes and aggregates on-chain swap events.
  • >CoinGecko — Price data is sourced from the CoinGecko API to display USD-denominated values.

> Supply_Calculation

For each wrapped asset, we call totalSupply() on the token’s smart contract on every chain where it is deployed. The per-chain values are summed to produce the total circulating supply.

On EVM chains (Ethereum, Base, Arbitrum), this is a standard ERC-20 totalSupply() read call. On Solana, we read the mint account’s supply field.

Each contract’s decimals value is used to convert the raw integer response into a human-readable token amount. The poller runs every 5 minutes via Vercel Cron and stores each reading in PostgreSQL with a timestamp for historical tracking.

> Price_Data

USD prices are fetched from the CoinGecko /api/v3/simple/price endpoint. Requests are batched (all asset IDs in a single call) to minimize API usage. Prices are cached in Redis with a 5-minute TTL, so displayed prices may lag the market by up to 5 minutes.

Price data is used solely for display purposes (e.g., converting supply counts to USD market cap estimates) and does not affect the underlying supply calculations.

> Volume_Data

Volume data is collected through two mechanisms:

  1. [01]Real-time polling — The Dune DEX Pair Stats API is polled every 30 minutes to capture recent swap activity for each tracked pair.
  2. [02]Daily batch — A daily SQL query runs against Dune to aggregate 24-hour volume totals. This provides a more complete picture that accounts for any gaps in real-time polling.

> Update_Frequency

MetricFrequencySource
SupplyEvery 5 minutesOn-chain RPC
PriceEvery 5 minutesCoinGecko API
Volume (real-time)Every 30 minutesDune Analytics API
Volume (daily)Once per dayDune SQL batch query

> Known_Limitations

  • !RPC failures — If an RPC provider is unavailable, the most recent successful reading is displayed with a “stale” indicator. Supply data is never estimated or interpolated.
  • !Dune lag — Dune Analytics indexes on-chain data with an approximate 30-minute delay. Volume figures may not reflect the very latest trades.
  • !CoinGecko rate limits — The free tier of the CoinGecko API has rate limits. During periods of high traffic, price updates may be temporarily delayed.
  • !Solana supply — On Solana, the supply figure reflects the mint account supply and may not account for tokens that have been burned to addresses other than the zero address.

> Tracked_Assets

cbwrapped currently monitors 6 Coinbase wrapped assets. The table below lists each asset, its deployments, and links to the relevant block explorers where the contract can be independently verified.

Coinbase Wrapped BTC (cbBTC)

ChainDecimalsExplorer
Ethereum80xcbB7C0…ed33Bf
Base80xcbB7C0…ed33Bf
Arbitrum80xcbB7C0…ed33Bf
Solana8cbbtcf3a…w4iMij

Coinbase Wrapped Staked ETH (cbETH)

ChainDecimalsExplorer
Ethereum180xBe9895…a49704
Base180x2Ae3F1…0DEc22

Coinbase Wrapped DOGE (cbDOGE)

ChainDecimalsExplorer
Base80xcbD06E…dEb510

Coinbase Wrapped XRP (cbXRP)

ChainDecimalsExplorer
Base60xcb5852…33a4af

Coinbase Wrapped LTC (cbLTC)

ChainDecimalsExplorer
Base80xcb17C9…b6445F

Coinbase Wrapped ADA (cbADA)

ChainDecimalsExplorer
Base60xcbADA7…fc7b8c

> For informational purposes only. cbwrapped is an independent, open-source project. The data presented is sourced from public blockchains and third-party APIs and is provided without warranty. Always verify on-chain data independently before making any decisions.