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

> Tokenized real-world-asset metrics for one token contract on one chain: price, 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 deployment, keyed by chain and contract address. Many series, so name the deployments you need.

One row per tokenized real-world-asset deployment, one token contract on one chain, keyed by chain and contract address: symbol, product, issuer, category and subcategory, the chain and the mapped network and issuer project records. The id is the series key of the rwa-by-deployment timeseries model.

| | |
| - | - |
| Access | Real-world-assets-dataset |
| Tabular model | `rwa-deployments`: primary key `id` |
| Timeseries model | `rwa-by-deployment`: intervals `1d`, series key `id` (RWA Deployment ID), series must be named (up to 20 per call) |

## Endpoints

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

> **[Batch Get RWA Deployment timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-deployment.md)**
>
> Up to 20 series in one request, named by RWA Deployment ID in `series`.

> **[Get RWA Deployment timeseries](https://docs.blockworks.com/api-reference/data-api/real-world-assets/timeseries-rwa-by-deployment-by-id.md)**
>
> One series over a time window, keyed by its RWA Deployment 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 |
| - | - | - | - | - |
| `priceUSD` | Price (USD) | float64 | | Token price in USD. |
| `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-deployment timeseries model, the chain and token address joined with an underscore. (primary key) |
| `name` | string | `Eq`, `IsOneOf`, `Contains` | default | The deployment's display name. |
| `symbol` | string | `Eq`, `IsOneOf`, `Contains` | yes | The token's ticker symbol. |
| `tokenSlug` | string | `Eq`, `IsOneOf` | | The product's token slug, shared by every chain's deployment of the same token. |
| `tokenAddress` | string | `Eq`, `IsOneOf` | | The token contract address (the mint address on Solana). |
| `chain` | string | `Eq`, `IsOneOf` | yes | The short name of the chain (ethereum, base, solana). |
| `issuerID` | string | `Eq`, `IsOneOf` | | The identifier of the issuing company. |
| `sector` | string | `Eq`, `IsOneOf` | | The RWA category, the token sector (government-debt, commodities, equities, credit). |
| `subsector` | string | `Eq`, `IsOneOf` | | The RWA subcategory, the token subsector within its sector. |
| `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. |
| `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-deployment/1d/<id>?timeframe=7d&selections=priceUSD,circulatingSupplyUSD" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

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


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