Tailflow
Skip to article
Browse documentation

Build a flow

Filters and block batches

Narrow events, combine conditions, and understand grouped inputs.

Use values from a real example

Choose a field, an operator, and a value. Available operators include equality, inequality, numeric comparisons, and in. Use the operator suitable for the field.

Use decimal token units for Value and check raw decoded arguments separately. A missing USD estimate is not zero. Avoid requiring a dollar threshold for assets whose example has no valuation.

Token Transfer Trigger Configuration
1Event source
Token Transfer (ERC20)
2Filters
Edit the conditions to explore the controls. Event samples stay fixed.
Inspect Example triggers to check your selection.
3Trigger
Chains
1 selected · 3 of 7 chains shown
Fires
Event shape
token_symbol
USDC
value_decimal
125000
from_address
0x1111111111111111111111111111111111111111
Example. Choose the event source, then narrow it with a Value filter. Chains are selected in the trigger inspector.Changes stay in this example. Nothing is saved or sent.

Combine trigger filters

AND requires both groups to match. Consecutive OR rows form an alternative group, and groups are joined with AND.

For example: From is wallet · OR To is wallet · AND Value ≥ 1000 selects transfers involving the wallet in either direction, with at least 1000 tokens.

Path conditions require all their conditions to match. Use separate paths for separate outcomes, remembering that both paths run if both match.

Trigger Filters: AND and OR Conditions
Filters
Edit the conditions to explore the controls. Event samples stay fixed.
Event shape
from_address
0x1111111111111111111111111111111111111111
to_address
0x2222222222222222222222222222222222222222
value_decimal
1250
This transfer matches the wallet and the minimum amount.
Example. From OR To matches either side of the transfer. AND Value then applies the minimum amount to both alternatives.Changes stay in this example. Nothing is saved or sent.

Nested fields

Fields can refer to nested data, such as args.value or logs.0.args.value. Numeric segments refer to array positions, starting at zero. An exact log position is not guaranteed to have the same meaning in every transaction; check representative examples.

Nested Event Field Filters
Event shape
logs.0.name
Transfer
logs.0.args.value
25000000
Filters
Edit the conditions to explore the controls. Event samples stay fixed.
Example. Use the path shown in Event shape. Array index 0 means the first item, not a guarantee that the same event always occupies that position.Changes stay in this example. Nothing is saved or sent.

Batch per block

Where offered for transfers, batching combines matching events on the same chain and in the same block. Trigger filters apply to individual events before grouping. The path receives the resulting batch.

A batch has count and events, plus summary fields. It has no single transaction hash. Use explorer_block_url for the block and events for individual transfers.

For token batches, value_decimal adds the token amounts, so it is only meaningful as one asset total when the batch contains the same asset. USD totals can be partial when some events lack a valuation.

After changing batching, inspect the event fields and rerun the test. A template written for one transfer may no longer apply.

Trigger Firing Mode and Event Shape
Trigger
Fires
One run for the matching transfers in this block.
Event shape
count
3
events
[ transfer 1, transfer 2, transfer 3 ]
value_decimal
375000
Example. The Fires control changes the input. In Batch per block, use count and events rather than assuming there is one transfer.Changes stay in this example. Nothing is saved or sent.