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:
- [01]Real-time polling — The Dune DEX Pair Stats API is polled every 30 minutes to capture recent swap activity for each tracked pair.
- [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
| Metric | Frequency | Source |
|---|---|---|
| Supply | Every 5 minutes | On-chain RPC |
| Price | Every 5 minutes | CoinGecko API |
| Volume (real-time) | Every 30 minutes | Dune Analytics API |
| Volume (daily) | Once per day | Dune 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)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Ethereum | 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf | 8 | 0xcbB7C0…ed33Bf |
| Base | 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf | 8 | 0xcbB7C0…ed33Bf |
| Arbitrum | 0xcbB7C0000aB88B473b1f5aFd9ef808440eed33Bf | 8 | 0xcbB7C0…ed33Bf |
| Solana | cbbtcf3aa214zXHbiAZQwf4122FBYbraNdFqgw4iMij | 8 | cbbtcf3a…w4iMij |
Coinbase Wrapped Staked ETH (cbETH)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Ethereum | 0xBe9895146f7AF43049ca1c1AE358B0541Ea49704 | 18 | 0xBe9895…a49704 |
| Base | 0x2Ae3F1Ec7F1F5012CFEab0185bfc7aa3cf0DEc22 | 18 | 0x2Ae3F1…0DEc22 |
Coinbase Wrapped DOGE (cbDOGE)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Base | 0xcbD06E5A2B0C65597161de254AA074E489dEb510 | 8 | 0xcbD06E…dEb510 |
Coinbase Wrapped XRP (cbXRP)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Base | 0xcb585250f852C6c6bf90434AB21A00f02833a4af | 6 | 0xcb5852…33a4af |
Coinbase Wrapped LTC (cbLTC)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Base | 0xcb17C9Db87B595717C857a08468793f5bAb6445F | 8 | 0xcb17C9…b6445F |
Coinbase Wrapped ADA (cbADA)
| Chain | Contract Address | Decimals | Explorer |
|---|---|---|---|
| Base | 0xcbADA732173e39521CDBE8bf59a6Dc85A9fc7b8c | 6 | 0xcbADA7…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.