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

### Table Details

| Property            | Value                                          |
| ------------------- | ---------------------------------------------- |
| Table Name          | `plume.rwa.supply_change`                      |
| Table Status        | Production-Ready                               |
| Unique Key          | `block_date`, `unique_id`                      |
| Clustering Key(s)   | `block_date, token_address, transfer_type`     |
| Search Optimization | `block_date`, `token_address`, `transfer_type` |

### Table Columns

| Column Name                     | Data Type         | Description                                                                                                                                       |
| ------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| chain                           | VARCHAR(16777216) | Name of the blockchain network this record belongs to.                                                                                            |
| from\_address                   | VARCHAR(16777216) | Address that sent in this event. For token transfers, the account whose balance decreased.                                                        |
| to\_address                     | VARCHAR(16777216) | Address that received in this event. For token transfers, the account whose balance increased.                                                    |
| transfer\_type                  | VARCHAR(9)        | Category of transfer (e.g. mint, burn, standard transfer).                                                                                        |
| token\_type                     | VARCHAR(16777216) | Token standard or category (e.g. erc20, erc721, native).                                                                                          |
| token\_address                  | VARCHAR(16777216) | Contract address of the token. On EVM chains native currency is represented as the zero address.                                                  |
| token\_name                     | VARCHAR(16777216) | Human-readable name of the token.                                                                                                                 |
| token\_symbol                   | VARCHAR(16777216) | Ticker symbol of the token.                                                                                                                       |
| token\_decimals                 | NUMBER(38,0)      | Number of decimal places used to convert the token's raw integer amount to a human-readable amount.                                               |
| raw\_amount\_str                | VARCHAR(16777216) | Token amount in the smallest indivisible unit as a string, to preserve full precision.                                                            |
| raw\_amount                     | FLOAT             | Token amount in the smallest indivisible unit (not decimal-adjusted).                                                                             |
| amount\_str                     | VARCHAR(16777216) | Decimal-adjusted token amount represented as a string to preserve full precision.                                                                 |
| amount                          | FLOAT             | Decimal-adjusted amount of tokens involved in this record.                                                                                        |
| usd\_amount                     | FLOAT             | USD value of the amount, computed using the token's USD exchange rate at the record's timestamp.                                                  |
| usd\_exchange\_rate             | FLOAT             | USD price of one unit of the token at the record's timestamp.                                                                                     |
| transaction\_from\_address      | VARCHAR(16777216) | Sender (msg.sender) of the transaction that produced this record.                                                                                 |
| transaction\_to\_address        | VARCHAR(16777216) | Destination address of the transaction that produced this record (may be a smart contract).                                                       |
| transaction\_hash               | VARCHAR(16777216) | Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain.                                       |
| transaction\_index              | NUMBER(38,0)      | Zero-based position of the transaction within its block. The first transaction in a block has index 0.                                            |
| log\_index                      | NUMBER(38,0)      | Zero-based position of this event log within its transaction. The first log emitted by a transaction has index 0.                                 |
| block\_date                     | DATE              | Calendar date (UTC) of the block that contains this record.                                                                                       |
| block\_timestamp                | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record.                                                                                           |
| block\_number                   | NUMBER(38,0)      | Sequential number of the block that contains this record. Starts at 0 (genesis) and increments by 1 per block.                                    |
| block\_hash                     | VARCHAR(16777216) | Cryptographic hash of the block header that contains this record. Uniquely identifies a block.                                                    |
| unique\_id                      | VARCHAR(16777216) | Allium's deterministic unique identifier for this row, generated from the fields that uniquely identify the record. Stable across full refreshes. |
| \_rwa\_token\_created\_at       | TIMESTAMP\_NTZ(9) | Timestamp (UTC) when the RWA token record was first created in the Allium platform.                                                               |
| \_transfers\_created\_at        | TIMESTAMP\_NTZ(9) | Timestamp (UTC) when the underlying transfer record was first created in the Allium platform.                                                     |
| \_created\_at                   | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was created in the database.                                                                                          |
| \_updated\_at                   | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was last updated in the database.                                                                                     |
| \_changed\_since\_full\_refresh | BOOLEAN           | Indicates if the record has changed since the last full data refresh.                                                                             |
| is\_mint                        | BOOLEAN           | Whether this transfer is a mint (tokens created, originating from the zero address).                                                              |
| is\_burn                        | BOOLEAN           | Whether this transfer is a burn (tokens destroyed, sent to the zero address).                                                                     |