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

# Stablecoin Transfers

### Table Details

| Property            | Value                                  |
| ------------------- | -------------------------------------- |
| Table Name          | `aptos.assets.stablecoin_transfers`    |
| Table Status        | Production-Ready                       |
| Unique Key          | `block_timestamp::date`, `unique_id`   |
| Clustering Key(s)   | `block_timestamp::date, token_address` |
| Search Optimization | `token_address`, `token_symbol`        |

### Table Columns

| Column Name                     | Data Type         | Description                                                                                                                                                                                                                                           |
| ------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 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).                                                                                   |
| token\_type                     | VARCHAR(14)       | 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`).                                                                             |
| coin\_address                   | VARCHAR(16777216) | Aptos Move type address of the fungible token (Coin Standard type, e.g. 0x1::aptos\_coin::AptosCoin).                                                                                                                                                 |
| coin\_name                      | VARCHAR(16777216) | Full name of this coin. Short alias for token\_name in Aptos/Cosmos-style tables.                                                                                                                                                                     |
| coin\_symbol                    | VARCHAR(16777216) | Ticker symbol of this coin. Short alias for token\_symbol in Aptos/Cosmos-style tables.                                                                                                                                                               |
| coin\_decimals                  | NUMBER(38,0)      | Decimal precision of this coin. Short alias for token\_decimals in Aptos/Cosmos-style tables.                                                                                                                                                         |
| fa\_address                     | VARCHAR(16777216) | Aptos Fungible Asset (FA) object address for this token under the new FA Standard.                                                                                                                                                                    |
| fa\_name                        | VARCHAR(16777216) | Display name of this Fungible Asset token.                                                                                                                                                                                                            |
| fa\_symbol                      | VARCHAR(16777216) | Ticker symbol of this Fungible Asset token.                                                                                                                                                                                                           |
| fa\_decimals                    | NUMBER(38,0)      | Decimal precision of this Fungible Asset token.                                                                                                                                                                                                       |
| 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.                                 |
| match\_type                     | VARCHAR(16777216) | How the outbound and inbound legs were matched — exact (deterministic ID match) or composite (matched on recipient + amount within time window).                                                                                                      |
| transfer\_type                  | VARCHAR(16777216) | 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`. |
| withdraw\_metadata              | OBJECT            | JSON metadata associated with this withdrawal event.                                                                                                                                                                                                  |
| deposit\_metadata               | OBJECT            | JSON metadata associated with this deposit event (e.g. sequence number, event key).                                                                                                                                                                   |
| raw\_amount\_str                | VARCHAR(16777216) | Raw collateral amount in USDC base units (6 decimals), as a string.                                                                                                                                                                                   |
| 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.                                                                                                                      |
| tx\_sender                      | VARCHAR(16777216) | Address that signed and submitted the transaction.                                                                                                                                                                                                    |
| tx\_payload                     | VARIANT           | JSON-encoded transaction payload including the function, type arguments, and input arguments.                                                                                                                                                         |
| block\_hash                     | VARCHAR(16777216) | Cryptographic hash of the block header that contains this record. Uniquely identifies a block.                                                                                                                                                        |
| block\_height                   | NUMBER(38,0)      | Number of confirmed blocks between this block and the genesis block (inclusive). Unlike `block_slot`, this only increments for slots that produced a block.                                                                                           |
| block\_timestamp                | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record.                                                                                                                                                                                               |
| 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.                                                                                                                                                |
| transaction\_version            | NUMBER(38,0)      | Monotonically increasing version number of the transaction on the Aptos blockchain. Aptos uses versions rather than block-scoped transaction indices.                                                                                                 |
| event\_index                    | NUMBER(38,0)      | Zero-based index of this event within its transaction. The specific semantics depend on the chain — on Aptos this is the `event_index` within the transaction; on Cosmos this is within the message.                                                  |
| 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.                                                                 |
| tx\_function                    | VARCHAR(16777216) | Fully-qualified Move function identifier called by this transaction (e.g., 0x1::coin::transfer).                                                                                                                                                      |
| 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.                                                                 |
| \_transfer\_created\_at         | TIMESTAMP\_NTZ(9) | Timestamp when the underlying transfer record was first ingested.                                                                                                                                                                                     |
| \_transfer\_updated\_at         | TIMESTAMP\_NTZ(9) | Timestamp when the underlying transfer record was last updated.                                                                                                                                                                                       |
| \_metadata\_created\_at         | TIMESTAMP\_LTZ(9) | Timestamp when the token metadata record was first created.                                                                                                                                                                                           |
| \_metadata\_updated\_at         | TIMESTAMP\_LTZ(9) | When the stablecoin metadata was last updated.                                                                                                                                                                                                        |
| \_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.                                                                                                                                                                                 |
