> ## 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.

# Transfers Overview

> Query all token transfer events — native ETH, ERC-20, ERC-721, and ERC-1155 — in a single unified endpoint.

## Overview

The Transfers suite provides access to all token transfer events produced by the TokenTransfersEngine via a single unified endpoint. Use the optional `transfer_type` filter to narrow results to a specific asset kind. The endpoint supports the same request shape (chain, block or time range, optional address filters, pagination) and returns a consistent record format with lineage fields.

### Endpoint

| Endpoint                                                                              | Summary                                                       | Transfer types                                       |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------- | ---------------------------------------------------- |
| [`POST /evm/transfers/token-transfers`](/api-reference/evm/transfers/token-transfers) | All transfer types in one response; filter by `transfer_type` | native\_tx, native\_internal, erc20, erc721, erc1155 |

### Parameter Conventions

<ParamField body="chain_id" type="number" required>
  Target EVM network. See [Chain](/api-reference/enumerations/chain) for supported values.
</ParamField>

<ParamField body="from_block" type="number">
  Starting block number (inclusive). Use with `to_block`.
</ParamField>

<ParamField body="to_block" type="number">
  Ending block number (inclusive). Use with `from_block`.
</ParamField>

<ParamField body="from_timestamp" type="string">
  Starting timestamp (ISO-8601). Use with `to_timestamp`; mutually exclusive with block range.
</ParamField>

<ParamField body="to_timestamp" type="string">
  Ending timestamp (ISO-8601). Use with `from_timestamp`.
</ParamField>

<ParamField body="from_address" type="string">
  Filter by sender address (hex, 20 bytes, no `0x` prefix).
</ParamField>

<ParamField body="to_address" type="string">
  Filter by recipient address (hex, 20 bytes, no `0x` prefix).
</ParamField>

<ParamField body="token_address" type="string">
  Filter by token contract (hex, 20 bytes). For native endpoint, omit or leave unset.
</ParamField>

<ParamField body="limit" type="number" default="250">
  Page size; max 1000. Stays under \~10 MB when combined with narrow ranges.
</ParamField>

<ParamField body="cursor" type="string">
  Pagination cursor from a previous response.
</ParamField>

### Usage Guidance

* **Filter by type** — Pass `transfer_type` as integer codes (`0`=native\_tx, `1`=native\_internal, `2`=erc20, `3`=erc721, `4`=erc1155) to narrow results to a specific asset kind in a single request. *See the [TransferType](/api-reference/enumerations/transfer-type) enumeration.*
* **Narrow by address** — Use `from_address` / `to_address` and optionally `token_address` to reduce payload and cost.
* **Join with entities** — Use `token_address` with [ERC-20](/api-reference/evm/entities/tokens-erc20), [ERC-721](/api-reference/evm/entities/tokens-erc721), or [ERC-1155](/api-reference/evm/entities/tokens-erc1155) token metadata for symbols and decimals.

### Common Patterns

**ERC-20 transfers for a wallet:**

```json theme={null}
{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "to_address": "0000000000000000000000000000000000000001",
  "limit": 250
}
```

**NFT (ERC-721) transfers for a collection:**

```json theme={null}
{
  "chain_id": 1,
  "from_timestamp": "2025-01-01T00:00:00Z",
  "to_timestamp": "2025-01-31T23:59:59Z",
  "token_address": "bc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
  "limit": 250
}
```

**Native ETH only (no token contract):**

```json theme={null}
{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_address": "0000000000000000000000000000000000000000",
  "limit": 250
}
```

**All transfer types in one request:**

```json theme={null}
{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "limit": 250
}
```

### Dataset & Relationships

* **Dataset ID:** `0304` — [Token transfers](/data-catalog/evm/transfers/token-transfers) (data catalog)
* **Transfers → Transactions:** Join on `(block_number, tx_index)` to [transactions](/api-reference/evm/primitives/transactions)
* **Transfers → Tokens:** Join `token_address` to [ERC-20](/api-reference/evm/entities/tokens-erc20), [ERC-721](/api-reference/evm/entities/tokens-erc721), or [ERC-1155](/api-reference/evm/entities/tokens-erc1155) for metadata

### See Also

* [Token Transfers](/api-reference/evm/transfers/token-transfers) — Full endpoint reference
* [Data catalog: Token Transfers](/data-catalog/evm/transfers/token-transfers) — Schema and columns