> ## 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 | `aptos.stablecoins.supply_change` | | Table Status | Production-Ready | | Unique Key | `block_timestamp`, `unique_id` | | Clustering Key(s) | `block_timestamp::date, token_address` | | Search Optimization | `from_address`, `to_address`, `token_address` | ### Table Columns | Column Name | Data Type | Description | | ----------------------- | ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | product\_id | VARCHAR(16777216) | Internal Allium identifier for the stablecoin product. Groups together the canonical and bridged variants of the same stablecoin on the same chain. | | is\_native | BOOLEAN | True if this is the issuer's canonical deployment on this chain (not a bridge-wrapped version). | | stablecoin\_type | VARCHAR(16777216) | Classification of the stablecoin mechanism. Values include `fiat_backed` (e.g. USDC, USDT), `crypto_backed` (e.g. DAI), `algorithmic`, or `yield_bearing`. | | currency | VARCHAR(16777216) | Fiat currency this stablecoin is pegged to, as an ISO 4217 code in lowercase (e.g. `usd`, `eur`, `jpy`). | | 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(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`). | | 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). | | \_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\_updated\_at | TIMESTAMP\_NTZ(9) | When the stablecoin metadata was last updated. | | event\_name | VARCHAR(16777216) | Source SettlementPool event name: Deposited or Withdrawn. | | 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. |