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.
Table Details
| Property | Value |
|---|---|
| Table Name | stable.assets.stablecoin_transfers |
| Table Status | Production-Ready |
| Unique Key | block_timestamp, unique_id |
| Clustering Key(s) | block_timestamp::date, token_address |
| Search Optimization | from_address, to_address, transaction_hash, token_address |
Table Columns
| Column Name | Data Type | Description |
|---|---|---|
| from_address | VARCHAR(42) | 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(42) | Address that received in this event. For token transfers, the account whose balance increased. For transactions, the destination address (may be a smart contract). |
| token_address | VARCHAR(42) | 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”). |
| 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. |
| transaction_from_address | VARCHAR(42) | 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(42) | 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(66) | 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_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(66) | 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. |
| currency | VARCHAR(16777216) | Fiat currency this stablecoin is pegged to, as an ISO 4217 code in lowercase (e.g. usd, eur, jpy). |
| base_asset | VARCHAR(16777216) | Canonical name of the stablecoin (e.g. USDC, USDT, DAI). Groups together all deployments of the same stablecoin across chains and issuers. |
| is_bridge | BOOLEAN | True if this stablecoin token is a bridged representation (e.g. USDC bridged from Ethereum to an L2 via a third-party bridge). False if it is the canonical deployment by the issuer. |
| _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. |
| _metadata_updated_at | TIMESTAMP_LTZ(9) | When the stablecoin metadata was last updated. |