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

# Transfers

### Table Details

| Property | Value |
| - | - |
| Table Name | `arc.rwa.transfers` |
| 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) | Slug identifying the blockchain this record belongs to (e.g. `ethereum`, `base`, `avalanche`, `solana`). In per-chain tables this is always the same value; in cross-chain tables it identifies which chain the row came from. |
| from\_address | VARCHAR(16777216) | Address that initiated or sent from in this event. For token transfers, the account whose balance decreased. For transactions, the transaction sender (msg.sender). |
| to\_address | VARCHAR(16777216) | Address that received in this event. For token transfers, the account whose balance increased. For transactions, the destination address (may be a smart contract). |
| transfer\_type | VARCHAR(9) | Category of this token movement. For native currency transfers: `value_transfer` (explicit send), `gas_payment_to_miner` (priority fee to block producer), or `gas_burn` (EIP-1559 base fee destroyed). For token transfers: always `value_transfer`. |
| token\_type | VARCHAR(16777216) | Token standard for the asset. One of: `erc20` (fungible), `erc721` (non-fungible), `erc1155` (semi-fungible), or the native currency symbol (e.g. `eth`, `matic`, `bnb`). |
| token\_address | VARCHAR(16777216) | Contract address of the token. For EVM chains, native currency (e.g. ETH, MATIC) is represented as the zero address (0x0000000000000000000000000000000000000000). For Solana, this is the mint address. |
| token\_name | VARCHAR(16777216) | Full name of the token (e.g. "USD Coin", "Wrapped Ether"). |
| token\_symbol | VARCHAR(16777216) | Ticker symbol of the token (e.g. "USDC", "WETH"). |
| token\_decimals | NUMBER(38,0) | Number of decimal places used to represent the token's smallest unit. Used to convert raw amounts: normalized\_amount = raw\_amount / 10^decimals. For example, USDC has 6 decimals, so 2500000 raw units = 2.5 USDC. |
| raw\_amount\_str | VARCHAR(16777216) | Token amount in the smallest unit as a string. Same concept as `amount_raw_str` — the column is named `raw_amount_str` in models that follow the `raw_` prefix convention rather than the `_raw` suffix convention. |
| raw\_amount | FLOAT | Token amount in the smallest indivisible unit (not decimal-adjusted). Same concept as `amount_raw` — the column is named `raw_amount` in models that follow the `raw_` prefix convention. |
| amount\_str | VARCHAR(16777216) | Normalized token amount stored as a string to preserve full precision. Equivalent to `amount` but avoids floating-point truncation for very large or very small values. |
| amount | FLOAT | Token amount normalized by the token's decimal precision (amount\_raw / 10^decimals). This is the human-readable value (e.g. 1.5 USDC rather than 1500000). |
| usd\_amount | FLOAT | USD value of the token amount at the time of the event, computed using the hourly USD exchange rate. |
| usd\_exchange\_rate | FLOAT | USD price per unit of the token at the time of the event, used to compute `usd_amount`. Sourced from Allium's hourly price feed. |
| transaction\_from\_address | VARCHAR(16777216) | Address of the externally-owned account (EOA) that signed and submitted the transaction. This is the wallet that paid gas, which may differ from the `from_address` of an individual token transfer if a contract is routing tokens on behalf of a user. |
| transaction\_to\_address | VARCHAR(16777216) | Address the transaction was sent to (the top-level `to` field of the transaction). May be a router, aggregator, or bridge contract rather than the direct recipient of assets. |
| 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) derived from block\_timestamp. Used as a partition key in incremental models. |
| 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 block) and increments by 1 for each new 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 (e.g. transaction hash + log index). Stable across full refreshes. |
| \_rwa\_token\_created\_at | TIMESTAMP\_NTZ(9) | Timestamp (UTC) when this token was first added to the Allium RWA token registry. |
| \_transfers\_created\_at | TIMESTAMP\_NTZ(9) | Timestamp (UTC) when the underlying transfer record that feeds this row was first created. |
| \_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. |

### Related Docs

* [EVM RWA Transfers](/historical-data/supported-blockchains/evm/core-schemas/rwa/transfers)
