> ## Documentation Index
> Fetch the complete documentation index at: https://docs.allium.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Supply

> Daily supply snapshots and supply change events (mints and burns) for RWA tokens.

## Overview

The supply tables track the circulating supply of RWA tokens over time, including daily snapshots and individual mint/burn events that change the supply.

The complete coverage of RWA tokens is available in the `rwa.registry.deployments` table.

## Tables

| Table Name | Description |
| - | - |
| `rwa.core.supply_daily` | Daily supply snapshots of RWA tokens across different blockchains. |
| `rwa.core.supply_latest` | Most recent (last 3 days) daily supply snapshot, deduplicated to one row per token. Same schema as `rwa.core.supply_daily`. |
| `rwa.core.supply_change` | Transfers that resulted in supply changes (mints and burns) of RWA tokens. |

## Table Columns

<Tabs>
  <Tab title="Supply Daily">
    Daily supply snapshots of RWA tokens.

    Unique key: `date`, `chain`, `token_address`

    | Column Name | Description |
    | - | - |
    | `date` | The date of the supply snapshot |
    | `asset_class` | Top-level V2 classification (rates, equities, credit, fx, commodities, private\_funds, real\_estate) |
    | `asset_type` | Granular V2 sub-classification within the asset class |
    | `product_id` | Unique identifier for the RWA product |
    | `product_name` | Human-readable name of the RWA product |
    | `chain` | The blockchain network (ethereum, solana, aptos, sui, stellar, arbitrum, polygon, etc.) |
    | `token_address` | The contract/asset address of the RWA token |
    | `token_symbol` | The symbol of the RWA token |
    | `token_name` | The name of the RWA token |
    | `supply_delta` | The change in supply of the RWA token on the given day |
    | `supply` | The total circulating supply of the RWA token on the given day |
    | `price_usd` | The price of the RWA token in USD on the given day |
    | `market_cap_usd` | The market cap of the RWA token on the given day (calculated as price\_usd \* supply) |
    | `issuer_id` | Unique identifier for the token issuer |
    | `issuer_name` | Human-readable name of the token issuer |
    | `platform_id` | Unique identifier for the platform |
    | `platform_name` | Human-readable name of the platform |
    | `_created_at` | The timestamp when this record was created |
    | `_updated_at` | The timestamp when this record was last updated |
  </Tab>

  <Tab title="Supply Change">
    Transfers that resulted in supply changes (mints and burns) of RWA tokens. This is a filtered view of the transfers table showing only mint and burn events.

    Unique key: `unique_id`

    | Column Name | Description |
    | - | - |
    | `asset_class` | Top-level V2 classification (rates, equities, credit, fx, commodities, private\_funds, real\_estate) |
    | `asset_type` | Granular V2 sub-classification within the asset class |
    | `chain` | The blockchain network where the RWA token is minted or burned (e.g., ethereum, arbitrum, polygon, solana) |
    | `token_type` | The token standard (e.g., erc20, spl\_token) |
    | `token_address` | The contract address of the RWA token |
    | `token_name` | The name of the RWA token |
    | `token_symbol` | The symbol of the RWA token |
    | `raw_amount` | The raw amount of tokens transferred (not adjusted for decimals) |
    | `amount` | The amount of tokens transferred (adjusted for decimals) |
    | `usd_amount` | The USD value of the transferred tokens at the time of transfer |
    | `from_address` | The address that sent the tokens (zero address for mints) |
    | `to_address` | The address that received the tokens (zero address for burns) |
    | `token_acc_from` | The token account of the sender (applicable for Solana only) |
    | `token_acc_to` | The token account of the receiver (applicable for Solana only) |
    | `transaction_hash` | The hash of the transaction (or txn\_id for Solana) |
    | `block_timestamp` | The timestamp of the block when the transaction was executed |
    | `block_number` | The number of the block when the transaction was executed |
    | `block_hash` | The hash of the block when the transaction was executed |
    | `unique_id` | Unique identifier for the transfer event |
    | `event_name` | The name of the transfer event (e.g., Transfer, Mint, Burn) |
    | `is_mint` | Boolean flag indicating if this is a token minting event |
    | `is_burn` | Boolean flag indicating if this is a token burning event |
    | `_transfers_created_at` | Timestamp when the transfer was first recorded in the source system |
    | `_created_at` | Timestamp when this record was created |
    | `_updated_at` | Timestamp when this record was last updated |
  </Tab>
</Tabs>

<Accordion title="Legacy Schema">
  `crosschain.rwa.supply` is deprecated in favor of `rwa.core.supply_daily` above, and `crosschain.rwa.supply_change` is deprecated in favor of `rwa.core.supply_change` above. Both remain queryable, but new work should use the current schema. `rwa.core.supply_latest` is new — there is no legacy equivalent.
</Accordion>
