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

# Token Transfers

### Table Details

| Property | Value |
| - | - |
| Table Name | `solana.raw.token_transfers` |
| Table Status | Production-Ready |
| Unique Key | `block_timestamp`, `txn_id`, `unique_id` |
| Clustering Key(s) | `to_date("block_timestamp"), "token_type", "mint"` |
| Search Optimization | `txn_id`, `mint`, `type`, `from_address`, `to_address`, `token_acc_from`, `token_acc_to`, `unique_id`, `signer` |

### Table Columns

| Column Name | Data Type | Description |
| - | - | - |
| 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`). |
| mint | VARCHAR(16777216) | Base58-encoded mint address of the SPL token. Analogous to `token_address` on EVM chains. Each mint uniquely identifies a fungible or non-fungible token on Solana. |
| 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\_acc\_from | VARCHAR(16777216) | SPL token account address of the sender. Each SPL token balance is held in a token account (derived from owner + mint), not the wallet address directly. |
| token\_acc\_to | VARCHAR(16777216) | SPL token account address of the recipient. Each SPL token balance is held in a token account (derived from owner + mint), not the wallet address directly. |
| 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`. |
| 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\_slot | NUMBER(38,0) | Solana slot number in which this transaction was confirmed. Slots are the fundamental unit of time on Solana (analogous to block numbers on EVM chains). Not every slot produces a block. |
| block\_timestamp | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record. |
| txn\_id | VARCHAR(16777216) | Base58-encoded transaction signature on Solana. Analogous to `transaction_hash` on EVM chains. Uniquely identifies a transaction. |
| txn\_index | NUMBER(38,0) | Zero-based position of this transaction within its slot. |
| inner\_instruction\_index | NUMBER(38,0) | Zero-based position of this inner instruction within its parent instruction's inner instructions array. -1 for top-level instructions that are not inner instructions. |
| instruction\_index | NUMBER(38,0) | Zero-based position of this instruction within the transaction's top-level instructions array. |
| program\_name | VARCHAR(16777216) | Human-readable name of the Solana program (e.g. "spl\_token", "system\_program", "jupiter\_v6"). Resolved from Allium's program registry. |
| program\_id | VARCHAR(16777216) | Base58-encoded public key of the Solana program that processed this instruction (e.g. `TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA` for SPL Token). |
| outer\_program\_id | VARCHAR(16777216) | Program ID of the outermost instruction that invoked this inner instruction on Solana |
| pseudo\_instruction\_order | NUMBER(38,0) | Internal ordering key for instructions within a Solana transaction that may lack an explicit index. Used to maintain processing order. |
| raw\_amount | VARCHAR(16777216) | 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. |
| signer | VARCHAR(16777216) | Primary signing account (fee payer) of the transaction. This is the account that authorized the transaction and paid transaction fees. |
| type | VARCHAR(16777216) | The type of the position on the perpetual. |
| 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. |
| \_updated\_at | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was last updated in the database. |
| \_created\_at | TIMESTAMP\_NTZ(9) | Timestamp of when the entry was created in the database. |
| decimals | NUMBER(38,0) | Number of decimal places for this token. Short alias for `token_decimals` used in tables that preserve the original blockchain field naming convention. |
| txn\_fee | NUMBER(38,0) | Transaction fee paid in lamports for this NFT mint or trade. |