Skip to main content
WSS
wss://stream.blockdb.io/v1/evm/
Messages
subscribe
type:object
unsubscribe
type:object
subscribe_response
type:object
unsubscribe_response
type:object
update
type:object

​
Description

The Transactions stream delivers every executed transaction on the canonical chain as it is finalized. Messages include full execution metadata, gas accounting, and lineage identifiers.

​
Subscription Parameters

​
chain_id
number
required
Target EVM network.
​
from_addresses
string[]
Filter by sender address (20 bytes, hex string, no 0x prefix).
​
to_addresses
string[]
Filter by recipient address (20 bytes, hex string, no 0x prefix).
​
status_success
boolean
Filter by execution status (true = success, false = revert).

​
Message Fields

​
tx_hash
string
Keccak-256 hash of the transaction.
​
block_number
number
Block height containing the transaction.
​
from_address
string
Sender address.
​
to_address
string
Recipient address. null for contract creation.
​
gas_used
number
Gas consumed by the transaction.
​
status_success
boolean
Execution status: true = success, false = revert.
​
_tracing_id
string
Tracing identifier for cross-referencing with other datasets.

​
Subscription Example

# Use wscat to connect and subscribe
wscat -c wss://stream.blockdb.io/v1/evm/ \
  -H "Authorization: Bearer $BLOCKDB_API_KEY" \
  -x '{"action": "subscribe", "dataset_id": "0102", "chain_id": 1, "params": {"status_success": true}}'

​
Response Example

{
  "chain_id": 1,
  "dataset_id": "0102",
  "is_reorg": false,
  "data": {
    "block_number": 12345678,
    "block_hash": "f78e26c5959a94d6a62ed3837f5dcecf0d3761bf0a502e12a08fd7bc44c8568d",
    "block_time": "2025-11-11T18:42:15.123Z",
    "tx_hash": "7b5c0972efb6a0b5be4a4d4a0de5d1abd922478a53f32b2c717a800c862ba9e0",
    "tx_index": 4,
    "from_address": "0000000000000000000000000000000000000000",
    "to_address": "0000000000000000000000000000000000000001",
    "gas_used": 21000,
    "effective_gas_price_wei": "1234567890123456789",
    "status_success": true,
    "tx_type": 2,
    "_tracing_id": "010200000000000000000000000000000000",
    "_created_at": "2025-11-11T18:42:15.123Z"
  }
}