Transfers Overview

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`	All transfer types in one response; filter by `transfer_type`	native_tx, native_internal, erc20, erc721, erc1155

Parameter Conventions

number

required

Target EVM network. See Chain for supported values.

number

Starting block number (inclusive). Use with to_block.

number

Ending block number (inclusive). Use with from_block.

string

Starting timestamp (ISO-8601). Use with to_timestamp; mutually exclusive with block range.

string

Ending timestamp (ISO-8601). Use with from_timestamp.

string

Filter by sender address (hex, 20 bytes, no 0x prefix).

string

Filter by recipient address (hex, 20 bytes, no 0x prefix).

string

Filter by token contract (hex, 20 bytes). For native endpoint, omit or leave unset.

number

default:"250"

Page size; max 1000. Stays under ~10 MB when combined with narrow ranges.

string

Pagination cursor from a previous response.

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 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, ERC-721, or ERC-1155 token metadata for symbols and decimals.

Common Patterns

ERC-20 transfers for a wallet:

{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "to_address": "0000000000000000000000000000000000000001",
  "limit": 250
}

NFT (ERC-721) transfers for a collection:

{
  "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):

{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "from_address": "0000000000000000000000000000000000000000",
  "limit": 250
}

All transfer types in one request:

{
  "chain_id": 1,
  "from_block": 12345678,
  "to_block": 12345999,
  "limit": 250
}

Dataset & Relationships

Dataset ID: 0304 — Token transfers (data catalog)
Transfers → Transactions: Join on (block_number, tx_index) to transactions
Transfers → Tokens: Join token_address to ERC-20, ERC-721, or ERC-1155 for metadata

Overview

SDKs

Account & Usage

EVM Endpoints

Enumerations

Overview

Endpoint

Parameter Conventions

Usage Guidance

Common Patterns

Dataset & Relationships

See Also

​Overview

​Endpoint

​Parameter Conventions

​Usage Guidance

​Common Patterns

​Dataset & Relationships

​See Also

Overview

Endpoint

Parameter Conventions

Usage Guidance

Common Patterns

Dataset & Relationships

See Also