> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt > Use this file to discover all available pages before exploring further. # Bridged Bitcoin by Chain > Bridged bitcoin (wrapped and bridged BTC tokens such as WBTC and cbBTC) metrics summed across all products on a chain: token addresses, products and issuers, circulating supply, mints and burns, where the supply sits (CEX, perp and spot DEX, wrapped, yield derivatives, managed, buybacks, lending, unlabeled wallets), lending deposits, borrows, flows, APYs and liquidations, holders, spot DEX volume and transfers. Each series is one chain, keyed by its chain slug. One row per blockchain with bridged bitcoin activity, keyed by the short chain name: name, the chain's slug and its network id. The id is the series key of the bridged-bitcoin-by-chain timeseries model. | | | | - | - | | Access | Stablecoins-dataset | | Tabular model | `bridged-bitcoin-chains`: primary key `id` | | Timeseries model | `bridged-bitcoin-by-chain`: intervals `1d`, series key `id` (Chain ID), series must be named (up to 10 per call) | ## Endpoints > [card] [List Bridged Bitcoin Chains](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/tabular-bridged-bitcoin-chains.md) > > One page of rows with per-column filters, sorting and pagination. > [card] [Batch Get Bridged Bitcoin Chain timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-chain.md) > > Up to 10 series in one request, named by Chain ID in `series`. > [card] [Get Bridged Bitcoin Chain timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-chain-by-id.md) > > One series over a time window, keyed by its Chain ID. ## Metrics 37 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order. | Field | Name | Type | Unit | Description | | - | - | - | - | - | | `tokenAddressCount` | Token Address Count | int64 | | Number of distinct token addresses. | | `productCount` | Product Count | int64 | | Number of distinct bridged bitcoin products. | | `issuerCount` | Issuer Count | int64 | | Number of distinct issuers. | | `circulatingSupplyUSD` | Circulating Supply (USD) | float64 | | Circulating supply in USD. | | `mintAmountUSD` | Mint Amount (USD) | float64 | | Amount minted in USD. | | `burnAmountUSD` | Burn Amount (USD) | float64 | | Amount burned in USD. | | `mintCount` | Mint Count | int64 | | Number of mints. | | `burnCount` | Burn Count | int64 | | Number of burns. | | `balanceCEXUSD` | Balance on CEXes (USD) | float64 | | Supply held on centralized exchanges in USD. | | `balancePerpDEXUSD` | Balance on Perp DEXes (USD) | float64 | | Supply held by perp DEXes in USD. | | `balanceSpotDEXUSD` | Balance on Spot DEXes (USD) | float64 | | Supply held by spot DEXes in USD. | | `balanceWrappedUSD` | Balance Wrapped (USD) | float64 | | Supply held by wrapper contracts in USD. | | `balanceYieldDerivativesUSD` | Balance in Yield Derivatives (USD) | float64 | | Supply held by yield derivative protocols in USD. | | `balanceManagedUSD` | Balance Managed (USD) | float64 | | Supply held by managed vaults in USD. | | `balanceBuybackUSD` | Balance in Buybacks (USD) | float64 | | Supply held by buyback contracts in USD. | | `balanceLendingUSD` | Balance in Lending (USD) | float64 | | Supply held by lending protocols in USD. | | `balanceUnknownUSD` | Balance Unknown (USD) | float64 | | Supply held by unlabeled holders in USD. | | `lendingDepositsUSD` | Lending Deposits (USD) | float64 | | Lending deposits in USD. | | `lendingBorrowedUSD` | Lending Borrowed (USD) | float64 | | Lending borrows in USD. | | `lendingNetFlowUSD` | Lending Net Flow (USD) | float64 | | Lending net flow in USD. | | `lendingGrossInflowUSD` | Lending Gross Inflow (USD) | float64 | | Lending gross inflow in USD. | | `lendingGrossOutflowUSD` | Lending Gross Outflow (USD) | float64 | | Lending gross outflow in USD. | | `lendingSupplyAPY` | Lending Supply APY | float64 | | Deposit-weighted lending supply APY. | | `lendingBorrowAPY` | Lending Borrow APY | float64 | | Borrow-weighted lending borrow APY. | | `lendingCollateralSeizedUSD` | Lending Collateral Seized (USD) | float64 | | Lending collateral seized in USD. | | `lendingLiquidationLossUSD` | Lending Liquidation Loss (USD) | float64 | | Lending liquidation losses in USD. | | `lendingLiquidationCount` | Lending Liquidation Count | int64 | | Number of lending liquidations. | | `holders` | Holders | int64 | | Holder count (summed across tokens). | | `spotDEXBuyVolumeUSD` | Spot DEX Buy Volume (USD) | float64 | | Spot DEX buy volume in USD. | | `spotDEXSellVolumeUSD` | Spot DEX Sell Volume (USD) | float64 | | Spot DEX sell volume in USD. | | `spotDEXVolumeUSD` | Spot DEX Volume (USD) | float64 | | Spot DEX volume in USD. | | `spotDEXTradeCount` | Spot DEX Trade Count | int64 | | Number of spot DEX trades. | | `spotDEXTraders` | Spot DEX Traders | int64 | | Spot DEX traders (summed across tokens). | | `transferVolumeUSD` | Transfer Volume (USD) | float64 | | Transfer volume in USD. | | `transferCount` | Transfer Count | int64 | | Number of transfers. | | `transferUniqueSenders` | Transfer Unique Senders | int64 | | Unique transfer senders (summed across tokens). | | `transferUniqueReceivers` | Transfer Unique Receivers | int64 | | Unique transfer receivers (summed across tokens). | ## Columns Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes). | Field | Type | Filters | Sort | Description | | - | - | - | - | - | | `id` | string | `Eq`, `IsOneOf` | | The series key of the bridged-bitcoin-by-chain timeseries model, the short chain name. (primary key) | | `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the chain. | | `slug` | string | `Eq`, `IsOneOf` | yes | The chain's slug in the blockchains model; null when unmapped. | | `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. | ## Example ```bash curl theme={null} curl "https://api.blockworks.com/query/timeseries/bridged-bitcoin-by-chain/1d/?timeframe=7d&selections=tokenAddressCount,productCount" \ -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY" ``` See [Get Bridged Bitcoin Chain timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-chain-by-id.md) for the response and the errors. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.