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) |