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

# RWA by Chain

> Tokenized real-world-asset metrics summed across every token on one blockchain: deployment, product and issuer counts, supply split by category, supply, mints and burns, where the supply sits (CEX, DEX, wrapped, managed, 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. Lending and DEX fields are null where a chain has no such activity, so pass selections.

One row per blockchain with tokenized real-world-asset activity, keyed by the chain slug: name, chain and the mapped network record. The id is the series key of the rwa-by-chain timeseries model.

| | |
| - | - |
| Access | Real-world-assets-dataset |
| Tabular model | `rwa-chains`: primary key `id` |
| Timeseries model | `rwa-by-chain`: intervals `1d`, series key `id` (RWA Chain ID), every series available in one call |

## Endpoints

> **[List RWA Chains](https://docs.blockworks.com/api-reference/data-api/real-world-assets/tabular-rwa-chains.md)**
>
> One page of rows with per-column filters, sorting and pagination.

> **[Batch Get RWA Chain timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-chain.md)**
>
> Every series in one request, or the named ones.

> **[Get RWA Chain timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-chain-by-id.md)**
>
> One series over a time window, keyed by its RWA Chain ID.

## Metrics

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

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `deploymentCount` | Deployment Count | float64 | | Number of token deployments, one per chain and contract address. |
| `productCount` | Product Count | float64 | | Number of RWA products. |
| `issuerCount` | Issuer Count | float64 | | Number of issuers. |
| `circulatingSupplyUSD` | Circulating Supply (USD) | float64 | | Circulating supply in USD. |
| `adjustedSupplyUSD` | Adjusted Supply (USD) | float64 | | Adjusted supply in USD as reported by Blockworks Research. |
| `governmentDebtSupplyUSD` | Government Debt Supply (USD) | float64 | | Circulating supply of government-debt tokens in USD. |
| `commoditiesSupplyUSD` | Commodities Supply (USD) | float64 | | Circulating supply of commodity tokens in USD. |
| `equitiesSupplyUSD` | Equities Supply (USD) | float64 | | Circulating supply of equity tokens in USD. |
| `creditSupplyUSD` | Credit Supply (USD) | float64 | | Circulating supply of credit tokens in USD. |
| `strategiesSupplyUSD` | Strategies Supply (USD) | float64 | | Circulating supply of strategy tokens in USD. |
| `otherSupplyUSD` | Other Supply (USD) | float64 | | Circulating supply of tokens in other RWA categories in USD. |
| `mintAmountUSD` | Mint Amount (USD) | float64 | | Value minted in USD. |
| `burnAmountUSD` | Burn Amount (USD) | float64 | | Value burned in USD. |
| `mintCount` | Mint Count | float64 | | Number of mint events. |
| `burnCount` | Burn Count | float64 | | Number of burn events. |
| `balanceCEXUSD` | Balance on CEXes (USD) | float64 | | Supply held in centralized-exchange wallets in USD. |
| `balancePerpDEXUSD` | Balance on Perp DEXes (USD) | float64 | | Supply held in perpetual-DEX contracts in USD. |
| `balanceSpotDEXUSD` | Balance on Spot DEXes (USD) | float64 | | Supply held in spot-DEX pools in USD. |
| `balanceWrappedUSD` | Balance Wrapped (USD) | float64 | | Supply held in wrapping contracts in USD. |
| `balanceYieldDerivativesUSD` | Balance in Yield Derivatives (USD) | float64 | | Supply held in yield derivative protocols in USD. |
| `balanceManagedUSD` | Balance Managed (USD) | float64 | | Supply held in managed wallets in USD. |
| `balanceBuybackUSD` | Balance in Buybacks (USD) | float64 | | Supply held in buyback wallets in USD. |
| `balanceLendingUSD` | Balance in Lending (USD) | float64 | | Supply held in lending protocols in USD. |
| `balanceUnknownUSD` | Balance Unknown (USD) | float64 | | Supply held in unlabeled wallets in USD. |
| `lendingDepositsUSD` | Lending Deposits (USD) | float64 | | Deposited in lending protocols in USD. |
| `lendingBorrowedUSD` | Lending Borrowed (USD) | float64 | | Borrowed from lending protocols in USD. |
| `lendingNetFlowUSD` | Lending Net Flow (USD) | float64 | | Net lending flow in USD (gross inflow plus gross outflow). |
| `lendingGrossInflowUSD` | Lending Gross Inflow (USD) | float64 | | Gross lending inflow in USD. |
| `lendingGrossOutflowUSD` | Lending Gross Outflow (USD) | float64 | | Gross lending outflow in USD (negative). |
| `lendingSupplyAPY` | Lending Supply APY | float64 | | Average lending supply APY, as a decimal. |
| `lendingBorrowAPY` | Lending Borrow APY | float64 | | Average lending borrow APY, as a decimal. |
| `lendingCollateralSeizedUSD` | Lending Collateral Seized (USD) | float64 | | Collateral seized in lending liquidations in USD. |
| `lendingLiquidationLossUSD` | Lending Liquidation Loss (USD) | float64 | | Lending liquidation losses (bad debt) in USD. |
| `lendingLiquidationCount` | Lending Liquidation Count | float64 | | Number of lending liquidations. |
| `holders` | Holders | float64 | | Number of addresses holding the 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 | float64 | | Number of spot DEX trades. |
| `spotDEXTraders` | Spot DEX Traders | float64 | | Number of unique spot DEX traders. |
| `transferVolumeUSD` | Transfer Volume (USD) | float64 | | Transfer volume in USD. |
| `transferCount` | Transfer Count | float64 | | Number of transfers. |
| `transferUniqueSenders` | Transfer Unique Senders | float64 | | Distinct sending addresses. |
| `transferUniqueReceivers` | Transfer Unique Receivers | float64 | | Distinct receiving addresses. |

## 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 rwa-by-chain timeseries model, the chain slug (ethereum, avalanche-c). (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The chain's display name. |
| `chain` | string | `Eq`, `IsOneOf` | yes | The short name of the chain (ethereum, base, solana). |
| `networkID` | string | `Eq`, `IsOneOf` | | The chain's networkID in the blockchains model; null when unmapped. |
| `networkSlug` | string | `Eq`, `IsOneOf` | | The chain's slug in the blockchains model; null when unmapped. |

## Example

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

See [Get RWA Chain timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-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.