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

> Tokenized real-world-asset metrics summed across every token in one category: chain, deployment, product and issuer counts, 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 category, keyed by its slug. Lending and DEX fields are null where a category has no such activity, so pass selections.

One row per tokenized real-world-asset category (government-debt, commodities, equities, credit), keyed by the category slug: name and sector. The id is the series key of the rwa-by-category timeseries model.

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

## Endpoints

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

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

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

## Metrics

39 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 | float64 | | Number of chains the tokens are deployed on. |
| `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. |
| `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-category timeseries model, the category slug (government-debt). (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The category's display name. |
| `sector` | string | `Eq`, `IsOneOf` | | The RWA category, the token sector (government-debt, commodities, equities, credit). |

## Example

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

See [Get RWA Category timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-category-by-id.md) for the response and the errors.


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