> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockdb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Token Transfers

> Unified ERC-20, ERC-721, ERC-1155 & native ETH transfers in one table. Deterministic tracing IDs, 10 EVM chains.

## 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:** `_tracing_id`
* **Foreign Key:** `(block_number, tx_index)` → `blockdb_evm.b0102_transactions_v1`
* **API:** [POST /evm/transfers/token-transfers](/api-reference/evm/transfers/token-transfers)
* **CSV Sample:** [Download](https://huggingface.co/datasets/BlockDB/Token-Transfers-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0304_token_transfers_v1.csv?download=true)
* **JSON Sample:** [Download](https://huggingface.co/datasets/BlockDB/Token-Transfers-Ethereum-And-EVM-Cryptocurrency-Data/resolve/main/data/blockdb_evm.b0304_token_transfers_v1.json?download=true)

## Sample Viewer

<Frame>
  <iframe src="https://huggingface.co/datasets/BlockDB/Token-Transfers-Ethereum-And-EVM-Cryptocurrency-Data/embed/viewer/default/train" frameborder="0" width="100%" height="600px" />
</Frame>

## 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                                                                         |
| --------------------- | --------------- | ----------------------------------------------------------------------------------- |
| `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`       | `SMALLINT`      | Transfer mechanism; see [Transfer Type](/api-reference/enumerations/transfer-type). |
| `_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

<CardGroup cols={3}>
  <Card title="ERC-20 Tokens" icon="circle-dollar-to-slot" href="/data-catalog/evm/entities/erc20-tokens">
    Token metadata for the transferred assets.
  </Card>

  <Card title="Transactions" icon="arrow-right-arrow-left" href="/data-catalog/evm/primitives/transactions">
    Parent transactions containing these transfers.
  </Card>

  <Card title="Logs" icon="list" href="/data-catalog/evm/primitives/logs">
    Raw event logs that source these transfers.
  </Card>
</CardGroup>