Overview
- Dataset ID:
0304 - Table:
blockdb_evm.b0304_token_transfers_v1 - Description: Token transfer events (native ETH, ERC-20, ERC-721, ERC-1155) produced by TokenTransfersEngine from transactions, internal transactions, and transfer logs.
- Primary Key:
id(BIGINT GENERATED ALWAYS AS IDENTITY) - Foreign Key:
(block_number, tx_index)→blockdb_evm.b0102_transactions_v1 - API: POST /evm/transfers/token-transfers
- Sample: Hugging Face Sample
Methodology
The transfers are created for identified contract addresses that are ERC-20, ERC-721, ERC-1155 or native ETH. If the contract is not identified as one of these, the transfer is not created.Columns
| Column | Type | Description |
|---|---|---|
chain_id | BIGINT | EVM chain identifier; see Chain. |
id | BIGINT | Surrogate primary key (auto-generated). |
block_number | BIGINT | Block where the transfer occurred. |
block_time | TIMESTAMPTZ | UTC timestamp of the block. |
tx_index | INTEGER | Transaction index within the block. |
log_index | INTEGER | Log index within the transaction receipt; null for native or internal tx transfers. |
trace_address | TEXT | Trace address for internal tx transfers (e.g. “0”, “0.1”); null for other types. |
from_address | BYTEA | Sender address (20 bytes). |
to_address | BYTEA | Recipient address (20 bytes). |
token_address | BYTEA | Token contract address (20 bytes); null for native ETH. |
amount_raw | NUMERIC(78,0) | Raw amount in smallest unit (wei for native, raw uint256 for ERC-20/1155). |
amount_adj | TEXT | Decimal-adjusted amount; null if decimals unknown or NFT. |
token_id | NUMERIC(78,0) | Token ID for ERC-721 and ERC-1155; null for native/ERC-20. |
transfer_type | TEXT | Transfer type: native_tx, native_internal, erc20, erc721, erc1155. |
_tracing_id | BYTEA | BlockDB lineage identifier. |
_parent_tracing_ids | BYTEA[] | BlockDB lineage identifiers of the parent records. |
_created_at | TIMESTAMPTZ | Record creation timestamp. |
_updated_at | TIMESTAMPTZ | Record last update timestamp. |
Use Cases
- Wallet balance and flow analytics
- Token movement and holder tracking
- Compliance and attribution (native + ERC-20/721/1155 in one table)
- MEV and arbitrage flow reconstruction
Related Datasets
ERC-20 Tokens
Token metadata for the transferred assets.
Transactions
Parent transactions containing these transfers.
Logs
Raw event logs that source these transfers.