> ## 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 Product

> Bridged bitcoin (wrapped and bridged BTC tokens such as WBTC and cbBTC) metrics for one product summed across its chains: chains and token addresses, 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 product, keyed by its token id.

One row per bridged bitcoin product, keyed by token id: name, symbol, the token it is a bridged copy of, its issuer and the issuer's project record. The id is the series key of the bridged-bitcoin-by-product timeseries model.

| | |
| - | - |
| Access | Stablecoins-dataset |
| Tabular model | `bridged-bitcoin-products`: primary key `id` |
| Timeseries model | `bridged-bitcoin-by-product`: intervals `1d`, series key `id` (Token ID), series must be named (up to 10 per call) |

## Endpoints

> [card] [List Bridged Bitcoin Products](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/tabular-bridged-bitcoin-products.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get Bridged Bitcoin Product timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-product.md)
>
> Up to 10 series in one request, named by Token ID in `series`.

> [card] [Get Bridged Bitcoin Product timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-product-by-id.md)
>
> One series over a time window, keyed by its Token ID.

## Metrics

36 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `chainCount` | Chain Count | int64 | | Number of chains. |
| `tokenAddressCount` | Token Address Count | int64 | | Number of distinct token addresses. |
| `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-product timeseries model, the token slug. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The display name of the token, its ticker symbol. |
| `slug` | string | `Eq`, `IsOneOf` | yes | The issuer's project slug; null when unmapped. |
| `symbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The token's ticker symbol. |
| `underlyingTokenID` | string | `Eq`, `IsOneOf` | | The token id of the original token for a bridged copy (for example bitgo-wbtc), otherwise bitcoin. |
| `issuerID` | string | `Eq`, `IsOneOf` | | The identifier of the issuing company. |
| `projectID` | string | `Eq`, `IsOneOf` | | The identifier of the issuer's project record; null when unmapped. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/bridged-bitcoin-by-product/1d/<id>?timeframe=7d&selections=chainCount,tokenAddressCount" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get Bridged Bitcoin Product timeseries](https://docs.blockworks.com/api-reference/data-api/bridged-bitcoin/timeseries-bridged-bitcoin-by-product-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.