Skip to main content
WSS

Overview

  • Dataset ID: 0304 - Token Transfers
  • Description: Token transfer events (native ETH, ERC-20, ERC-721, ERC-1155) produced by TokenTransfersEngine from transactions, internal transactions, and transfer logs.
  • Sample: Hugging Face Sample

Subscription Parameters

chain_id
number
required
Target EVM network. See the Chain enumeration.
from_addresses
string[]
Optional filter: sender addresses (hex, no 0x).
to_addresses
string[]
Optional filter: recipient addresses (hex, no 0x).
token_addresses
string[]
Optional filter: token contract addresses (hex, no 0x); omit for native transfers where applicable.
transfer_types
string[]
Optional filter: transfer kinds (e.g. native, erc20, erc721, erc1155).

Message Fields

block_number
number
Block containing the transfer.
block_time
string
Block time (ISO-8601).
tx_index
number
Transaction index within the block.
log_index
number | null
Log index when sourced from a log; null when not applicable.
trace_address
string | null
Trace address for internal tx transfers (e.g. "0", "0.1"); null for other types.
from_address
string
Sender address (hex).
to_address
string
Recipient address (hex).
token_address
string | null
Token contract; null for native ETH transfers.
amount_raw
string
Raw amount (integer string in token/native units).
amount_adj
string | null
Decimal-adjusted amount; null if decimals unknown or NFT.
token_id
string | null
NFT / ERC-1155 id when applicable.
transfer_type
integer
Transfer mechanism as integer enum (see Transfer Type).
_tracing_id
string
Row lineage id (hex).
_parent_tracing_ids
string[]
Parent lineage ids (hex).
_created_at
string
Record creation time (ISO-8601).
_updated_at
string
Record last update time (ISO-8601).

Subscription Example

Response Example

subscribe
type:object
unsubscribe
type:object
subscribe_response
type:object
unsubscribe_response
type:object
update
type:object
Last modified on April 6, 2026