> ## 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 | `ton.stablecoins.supply_change` | | Table Status | Production-Ready | | Unique Key | `block_timestamp`, `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). | | from\_address\_b | VARCHAR(16777216) | Bounceable user-friendly format of from\_address. | | from\_address\_nb | VARCHAR(16777216) | Non-bounceable user-friendly format of from\_address. | | from\_jetton\_address | VARCHAR(16777216) | Jetton wallet address of the sender (hex). This is the contract that debited the tokens. | | from\_jetton\_address\_b | VARCHAR(16777216) | Bounceable user-friendly format of from\_jetton\_address. | | from\_jetton\_address\_nb | VARCHAR(16777216) | Non-bounceable user-friendly format of from\_jetton\_address. | | to\_address | VARCHAR(16777216) | For mints: the recipient's Jetton Wallet contract (msg\_destination). NOT the recipient owner EOA — use to\_owner\_address for that. For burns: '0' sentinel. | | to\_address\_b | VARCHAR(16777216) | Bounceable user-friendly format of to\_address. | | to\_address\_nb | VARCHAR(16777216) | Non-bounceable user-friendly format of to\_address. | | to\_owner\_address | VARCHAR(16777216) | Recipient owner EOA for mints, resolved from the Jetton Wallet (to\_address) via int\_ton\_transfers\_\_jetton\_masters\_v2. Matches what tonviewer displays as the recipient. NULL if the wallet has not been seen sending yet. For burns: '0' sentinel. | | to\_owner\_address\_b | VARCHAR(16777216) | Bounceable (UF) form of to\_owner\_address. | | to\_owner\_address\_nb | VARCHAR(16777216) | Non-bounceable (UF) form of to\_owner\_address. | | to\_jetton\_address | VARCHAR(16777216) | Jetton wallet address of the recipient (hex). This is the contract that was credited the tokens. | | jetton\_master | VARCHAR(16777216) | Jetton master address. This is the token contract equivalent (like erc20) on ton. | | jetton\_master\_b | VARCHAR(16777216) | Bounceable user-friendly format of jetton\_master. | | jetton\_master\_nb | VARCHAR(16777216) | Non-bounceable user-friendly format of jetton\_master. | | 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"). | | 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. | | 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. | | 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. | | query\_id | VARCHAR(16777216) | Application-defined query identifier linking related messages in a transfer chain. | | 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`. | | opcode | VARCHAR(16777216) | Message operation code. Always '0x178d4519' (JettonInternalTransfer). | | success | BOOLEAN | Boolean flag indicating whether the transaction executed successfully. True = succeeded, false = failed or reverted. | | block\_timestamp | TIMESTAMP\_NTZ(9) | Timestamp (UTC) of the block that contains this record. | | utime | TIMESTAMP\_NTZ(9) | Unix timestamp of the transfer. | | created\_lt | NUMBER(38,0) | Logical time of the transfer. | | transaction\_hash | VARCHAR(16777216) | Hash of the transaction that produced this record. Uniquely identifies a transaction within the blockchain. | | transaction\_hash\_hex | VARCHAR(16777216) | Hex-encoded lowercase hash of the transaction. | | hash | VARCHAR(16777216) | Hash of this record's transaction. Alias for transaction\_hash used in raw tables that preserve the original blockchain field name. | | message\_index | NUMBER(38,0) | Zero-based position of the message within the transaction. A Cosmos transaction can contain multiple messages. | | 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. | | bounce | BOOLEAN | Bounce of the transfer. | | bounced | BOOLEAN | Bounced of the transfer. | | masterchain\_seqno | NUMBER(38,0) | Sequence number on the masterchain. | | seqno | NUMBER(38,0) | The sequence number of the transaction | | shard | VARCHAR(16777216) | Shard identifier where the transfer was processed. | | workchain | NUMBER(38,0) | Workchain of the transfer. | | \_tokens\_updated\_at | TIMESTAMP\_NTZ(9) | Timestamp of when the token metadata was last updated. | | \_metadata\_created\_at | TIMESTAMP\_NTZ(9) | Timestamp when the token metadata record was first created. | | \_metadata\_updated\_at | TIMESTAMP\_NTZ(9) | When the stablecoin metadata was last updated. | | event\_name | VARCHAR(16777216) | Name of the smart contract event that triggered this bridge record (e.g. `Deposit`, `Send`, `TransferInitiated`). | | is\_mint | BOOLEAN | Boolean flag indicating if this is a token minting event | | is\_burn | BOOLEAN | Boolean flag indicating if this is a token burning event | | \_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. |