Skip to main content
Schema: hyperevm.core Table: ez_token_transfers Type: Table

What

This convenience table provides a comprehensive view of all ERC-20 token transfers with enriched metadata including decimal adjustments, USD values, and token information. It simplifies token flow analysis by joining transfer events with contract details and price data.

Key Use Cases

  • Tracking token movements and holder activity
  • Analyzing stablecoin flows and volumes
  • Monitoring DEX token inflows and outflows
  • Detecting new token launches and adoption
  • Calculating wallet token balances from transfer history

Important Relationships

  • Join with fact_event_logs: Use tx_hash and event_index for raw event details
  • Join with fact_transactions: Use tx_hash for transaction context
  • Join with dim_contracts: Use contract_address for token metadata
  • Complement to ez_native_transfers: Complete picture of value flows

Commonly-used Fields

  • contract_address: The token contract address (NOT the recipient)
  • from_address: Token sender address
  • to_address: Token recipient address
  • amount: Decimal-adjusted transfer amount
  • amount_usd: USD value at time of transfer
  • symbol: Token symbol (e.g., USDC, DAI)
  • raw_amount: Original amount without decimal adjustment

Sample queries

Top Token Transfers by USD Value
SELECT
    block_timestamp,
    tx_hash,
    symbol,
    from_address,
    to_address,
    amount,
    amount_usd,
    token_price,
    contract_address
FROM hyperevm.core.ez_token_transfers
WHERE block_timestamp >= CURRENT_DATE - 7
    AND amount_usd > 100000  -- Over \$100k
    AND has_decimal = TRUE
    AND has_price = TRUE
ORDER BY amount_usd DESC
LIMIT 100;
Daily Stablecoin Volume Analysis
SELECT
    DATE_TRUNC('day', block_timestamp) AS day,
    symbol,
    COUNT(*) AS transfer_count,
    COUNT(DISTINCT from_address) AS unique_senders,
    SUM(amount) AS total_amount,
    SUM(amount_usd) AS total_usd,
    AVG(amount_usd) AS avg_transfer_usd
FROM hyperevm.core.ez_token_transfers
WHERE symbol IN ('USDC', 'USDT', 'DAI', 'BUSD')
    AND block_timestamp >= CURRENT_DATE - 30
    AND has_decimal = TRUE
GROUP BY 1, 2
ORDER BY 1 DESC, 6 DESC;
DEX Token Flow Analysis
WITH dex_addresses AS (
    SELECT address
    FROM hyperevm.core.dim_labels
    WHERE label_type = 'dex'
    AND label_subtype IN ('pool', 'router')
)
SELECT
    DATE_TRUNC('hour', block_timestamp) AS hour,
    symbol,
    CASE
        WHEN from_address IN (SELECT address FROM dex_addresses) THEN 'DEX Outflow'
        WHEN to_address IN (SELECT address FROM dex_addresses) THEN 'DEX Inflow'
    END AS flow_type,
    COUNT(*) AS transfers,
    SUM(amount) AS total_amount,
    SUM(amount_usd) AS total_usd
FROM hyperevm.core.ez_token_transfers
WHERE block_timestamp >= CURRENT_DATE - 1
    AND (from_address IN (SELECT address FROM dex_addresses)
         OR to_address IN (SELECT address FROM dex_addresses))
    AND symbol IS NOT NULL
GROUP BY 1, 2, 3
ORDER BY 1 DESC, 6 DESC;
Token Holder Activity
-- Most active token senders
SELECT
    from_address,
    COUNT(DISTINCT contract_address) AS tokens_sent,
    COUNT(DISTINCT DATE(block_timestamp)) AS active_days,
    COUNT(*) AS total_transfers,
    SUM(amount_usd) AS total_usd_sent
FROM hyperevm.core.ez_token_transfers
WHERE block_timestamp >= CURRENT_DATE - 30
    AND has_price = TRUE
    AND amount_usd > 10  -- Filter dust
GROUP BY 1
HAVING COUNT(*) > 10
ORDER BY total_usd_sent DESC
LIMIT 100;
New Token Detection
WITH first_transfers AS (
    SELECT
        contract_address,
        symbol,
        MIN(block_timestamp) AS first_transfer,
        COUNT(*) AS transfer_count,
        COUNT(DISTINCT from_address) AS unique_senders,
        COUNT(DISTINCT to_address) AS unique_receivers
    FROM hyperevm.core.ez_token_transfers
    WHERE block_timestamp >= CURRENT_DATE - 7
    GROUP BY 1, 2
    HAVING MIN(block_timestamp) >= CURRENT_DATE - 1
)
SELECT
    ft.*,
    dc.name AS token_name,
    dc.decimals
FROM first_transfers ft
LEFT JOIN hyperevm.core.dim_contracts dc ON ft.contract_address = dc.address
ORDER BY transfer_count DESC;

Columns

Column NameData TypeDescription
BLOCK_NUMBERNUMBERSequential counter representing the position of a block in the blockchain since genesis (block 0).
BLOCK_TIMESTAMPTIMESTAMP_NTZUTC timestamp when the block was produced by validators/miners.
TX_HASHTEXTUnique 66-character identifier for the transaction.
TX_POSITIONNUMBERZero-indexed position of transaction within its block.
EVENT_INDEXNUMBERZero-based sequential position of the event within a transaction’s execution.
FROM_ADDRESSTEXTThe from address for the token transfer. This may or may not be the same as the origin_from_address.
TO_ADDRESSTEXTThe to address for the token transfer. This may or may not be the same as the origin_to_address.
CONTRACT_ADDRESSTEXTThe contract address for the token transfer.
TOKEN_STANDARDTEXTThe token standard for the transfer, in this case always erc20.
TOKEN_IS_VERIFIEDBOOLEANBoolean flag indicating if the token is verified by the Flipside team.
NAMETEXTHuman-readable contract name from the name() function.
SYMBOLTEXTToken/contract symbol from the symbol() function.
DECIMALSNUMBERNumber of decimal places for token amounts, read directly from the contract code.
RAW_AMOUNT_PRECISETEXTString representation of raw amount for precision preservation.
RAW_AMOUNTFLOATOriginal token amount without decimal adjustment.
AMOUNT_PRECISETEXTString representation of decimal-adjusted amount preserving full precision.
AMOUNTFLOATDecimal-adjusted token amount for human-readable values.
AMOUNT_USDFLOATUSD value of the token transfer at transaction time.
ORIGIN_FUNCTION_SIGNATURETEXTFunction signature (first 4 bytes) of the called method.
ORIGIN_FROM_ADDRESSTEXTThe externally-owned account (EOA) or contract address that initiated the transaction.
ORIGIN_TO_ADDRESSTEXTThe destination address for the transaction - either an EOA or contract address.
EZ_TOKEN_TRANSFERS_IDTEXTPrimary key - unique identifier for each row ensuring data integrity.
INSERTED_TIMESTAMPTIMESTAMP_NTZUTC timestamp when the record was first added to the Flipside database.
MODIFIED_TIMESTAMPTIMESTAMP_NTZUTC timestamp of the most recent update to this record.