Skip to main content

Flexible Webhook Stream Types


Stream type refers to the kind of on-chain data that Flexible Webhook tracks. This is a separate concept from the WebSocket-based Nodit Stream service.

The data schema available for reception varies by the stream type selected by the user. Each field in the schema serves two purposes:

  • Receive Fields: Select which fields to include in the webhook payload. All fields in the schema are eligible. You can deselect fields you do not need and receive only the fields you want.
  • Condition Fields (Condition): Some fields can also be used as filtering conditions. These are marked with ✓ in the Condition column of the tables below.

Fields currently used in filter conditions cannot be deselected from receive fields. The value format when writing filter conditions varies by field.

  • Address fields (e.g., from_address, to_address, token_address): 0x-prefixed checksum address
  • Quantity fields (e.g., value, gas_used, receipt_gas_used): string representation of a large integer (bigint)
  • Others: use the field's Type as-is

All schemas are commonly supported on EVM-compatible chains and have the same structure across all supported chains.


Block

Tracks block creation events.

Field

Type

Condition

Description

base_fee_per_gas

string

EIP-1559 base fee (wei)

blob_gas_used

string

EIP-4844 blob gas used

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

difficulty

string

Block difficulty. 0 after PoS transition

excess_blob_gas

string

Excess blob gas beyond the target

extra_data

string

Arbitrary data included by the block producer

gas_limit

string

Block gas limit

gas_used

string

Total gas used in the block

hash

string

Block hash

log_count

integer

Number of event logs included in the block

logs_bloom

string

Bloom filter for log search

miner

string

Block producer (validator) address

mix_hash

string

PoW verification hash. RANDAO value after PoS

nonce

string

PoW nonce. 0x0 after PoS

parent_beacon_block_root

string

Parent beacon block root hash

parent_hash

string

Parent block hash

receipts_root

string

Transaction receipts Merkle root

requests_hash

string

EIP-7685 requests hash

sha3_uncles

string

Uncle block hash

size

string

Block size (bytes)

state_root

string

State trie Merkle root

transaction_count

integer

Number of transactions included in the block

transactions

array

List of transaction hashes

transactions_root

string

Transaction trie Merkle root

withdrawal_count

integer

Number of validator withdrawals

withdrawals_root

string

Withdrawals trie Merkle root


ERC-20 Transfer

Tracks ERC-20 token transfer events.

Field

Type

Condition

Description

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

from_address

string

Sender address

log_index

integer

Log index within the block

to_address

string

Recipient address

token_address

string

Token contract address

transaction_hash

string

Transaction hash

transaction_index

integer

Transaction index within the block

value

string

Transfer amount (raw value without decimals applied)


ERC-721 Transfer

Tracks ERC-721 NFT transfer events.

Field

Type

Condition

Description

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

from_address

string

Sender address

log_index

integer

Log index within the block

to_address

string

Recipient address

token_address

string

NFT contract address

token_id

string

Token ID

transaction_hash

string

Transaction hash

transaction_index

integer

Transaction index within the block


ERC-1155 Transfer

Tracks ERC-1155 multi-token transfer events.

Field

Type

Condition

Description

batch_index

integer

Index within a batch transfer

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

from_address

string

Sender address

log_index

integer

Log index within the block

operator

string

Operator address that executed the transfer

to_address

string

Recipient address

token_address

string

Token contract address

token_id

string

Token ID

transaction_hash

string

Transaction hash

transaction_index

integer

Transaction index within the block

value

string

Transfer amount (raw value without decimals applied)


Log

Tracks smart contract event logs.

Field

Type

Condition

Description

address

string

Contract address that emitted the event

block_hash

string

Block hash

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

data

string

Non-indexed event data (hex)

log_index

integer

Log index within the block

removed

boolean

Whether the log was removed due to chain reorganization (reorg)

topics

array

Event topics array

topics[0]

array element

event signature hash (filter only)

topics[1]

array element

First indexed parameter (filter only)

topics[2]

array element

Second indexed parameter (filter only)

topics[3]

array element

Third indexed parameter (filter only)

transaction_hash

string

Transaction hash

transaction_index

integer

Transaction index within the block

topics[0] through topics[3] are filter-condition-only fields. In received data, they are delivered as the topics array.


Transaction Receipt

Tracks transaction execution results (receipts).

Field

Type

Condition

Description

access_list

array

EIP-2930 access list

authorization_list

array

EIP-7702 authorization list

blob_versioned_hashes

array

EIP-4844 blob versioned hash list

block_hash

string

Block hash

block_number

integer

Block number

block_timestamp

integer

Block creation time (Unix timestamp)

from_address

string

Transaction sender address

gas

string

Transaction gas limit

gas_price

string

Gas price (wei)

hash

string

Transaction hash

input

string

Transaction input data (calldata, hex)

max_fee_per_blob_gas

string

EIP-4844 max fee per blob gas

max_fee_per_gas

string

EIP-1559 max fee per gas

max_priority_fee_per_gas

string

EIP-1559 priority fee per gas

nonce

string

Transaction sequence number of the sender address

receipt_blob_gas_price

string

Actual blob gas price applied

receipt_blob_gas_used

string

Amount of blob gas used

receipt_contract_address

string

Deployed address for contract creation transactions

receipt_cumulative_gas_used

string

Cumulative gas used within the block

receipt_effective_gas_price

string

Actual gas price applied

receipt_gas_used

string

Actual amount of gas used

receipt_logs_bloom

string

Bloom filter for log search

receipt_root

string

State root (pre-Byzantium compatibility)

receipt_status

string

Execution result (`0x0`: failure, `0x1`: success)

to_address

string

Transaction recipient address

transaction_index

integer

Transaction index within the block

transaction_type

string

Transaction type (`0x0`: legacy, `0x2`: EIP-1559, etc.)

value

string

Native token transferred (wei)