Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.extractor.live/llms.txt

Use this file to discover all available pages before exploring further.

Overview

The Transfer Monitor processes every incoming transaction in real time, inspects its event logs for ERC-20 Transfer events, and fires an alert whenever a transfer involving a monitored address exceeds the configured threshold. A monitored address is matched against three roles in each Transfer event:
  • Token contract — the address that emitted the Transfer event
  • Sender — the from field of the Transfer
  • Recipient — the to field of the Transfer
An alert is emitted if the raw transfer value is greater than or equal to the configured threshold.

Threshold

The minimum transfer amount that triggers an alert. Specified as a raw integer — i.e. the on-chain value without decimal adjustment.
FieldTypeRequired
thresholdfloatYes
For example, to alert on transfers of 1,000 USDC (6 decimals), set the threshold to 1000000000 (1000 × 10⁶).
How to define a threshold: Specify the transfer amount that will trigger an alert in integer format, for example 1000000.

Monitored Address Matching

The detector checks each Transfer event against every configured monitored address. A match is registered if the monitored address appears in any of the following positions:
PositionDescription
Token contractThe address that emitted the Transfer log
FromThe sender of the transfer
ToThe recipient of the transfer
A single transaction may produce multiple alerts if it contains multiple matching Transfer events or if the same address appears in several configurations.

Severity

Controls the severity level of the alert when the threshold is exceeded.
ValueBehaviour
(not set)Defaults to Low (0.3)
Custom valueApplied directly to the alert

Alert Metadata

Every alert includes the following metadata fields:
FieldDescription
tx_hashHash of the transaction containing the Transfer
tx_fromSender address of the outer transaction
tx_toRecipient address of the outer transaction
monitored_contractThe configured monitored address that triggered the match
senderThe from address in the Transfer event
recipientThe to address in the Transfer event
valueRaw transfer amount (on-chain integer, not adjusted for decimals)
tokenAddress of the ERC-20 token contract
symbolToken symbol resolved on-chain (falls back to token address if unavailable)
thresholdThe configured threshold value

Alert Types

Event TypeTrigger
transfer_amount_threshold_exceedTransfer value ≥ threshold for a monitored address