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

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

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

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

## Endpoints

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

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

> **[Get RWA Issuer timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-issuer-by-id.md)**
>
> One series over a time window, keyed by its RWA Issuer 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 |
| - | - | - | - | - |
| `chainCount` | Chain Count | float64 | | Number of chains the tokens are deployed on. |
| `productCount` | Product Count | float64 | | Number of RWA products. |
| `categoryCount` | Category Count | float64 | | Number of RWA categories. |
| `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-issuer timeseries model, the issuer slug. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The issuer's display name. |
| `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. |
| `projectSlug` | string | `Eq`, `IsOneOf` | | The slug of the issuer's project record; null when unmapped. |

## Example

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

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


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