Skip to main content
WSS

Overview

Subscription Parameters

chain_id
number
required
Target EVM network. See the Chain enumeration for supported values.
contract_addresses
string[]
Filter by emitting contract address (hex string, 20 bytes, no 0x prefix).
topic_zeros
string[]
Filter by the primary event topic (e.g., Transfer, Swap signature hashes).

Message Fields

Payload mirrors blockdb_evm.b0103_logs_v1 (binary fields as hex strings without 0x in JSON).
contract_address
string
Address of the emitting contract.
topic_zero
string
Primary topic hash identifying the event (32 bytes). null for anonymous events.
data_topics
string[]
Subsequent event topics (indexed parameters).
data
string
Raw event data payload (hex string (no 0x prefix)).
block_number
number
Block height containing the log.
block_time
string
Block time (ISO-8601).
tx_index
number
Transaction index.
log_index
number
Log index.
_tracing_id
string
Tracing identifier for lineage correlation.
_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