Documentation

Large Transfer Detection

Monitor large token transfers with configurable thresholds by amount, USD value, or percentage of supply

Large Transfer Detection monitors ERC-20 token transfers on your watched contracts and alerts you when a transfer exceeds a configurable threshold. Use it to detect whale activity, suspicious outflows, treasury movements, and potential exploits in real time.

How It Works

ChainRaven monitors Transfer events emitted by ERC-20 token contracts. When a transfer occurs, it compares the transfer amount against your configured threshold. If the transfer exceeds the threshold, an alert is generated and sent via your configured notification channels.

Note: The contract must emit standard ERC-20 Transfer events for large transfer detection to work. Most token contracts do, but non-standard implementations may not be supported.


Threshold Modes

You can configure thresholds in three different ways depending on what makes most sense for the token you're monitoring:

Amount Mode

Alert when a transfer exceeds a raw token amount.

Threshold: 1,000,000 USDC
→ Alert fires when any single transfer is > 1,000,000 USDC

Best for stablecoins and tokens where you know the absolute value you care about.

USD Mode

Alert when a transfer exceeds a USD value at the time of the transfer.

Threshold: $500,000 USD
→ Alert fires when any single transfer is worth > $500,000

Best for volatile tokens where you care about dollar value rather than token quantity. ChainRaven fetches the token price at block time to evaluate each transfer.

Percentage Mode

Alert when a transfer exceeds a percentage of the total token supply.

Threshold: 1% of total supply
→ Alert fires when any single transfer moves > 1% of all tokens

Best for governance tokens — catches large unlocks, unusual whale movements, and potential governance attacks relative to circulating supply.


Configuring Thresholds

  1. Go to your Dashboard and find the contract you want to configure
  2. Open the contract's settings
  3. Under Large Transfer Threshold, select your preferred mode
  4. Enter the threshold value
  5. Save — monitoring starts immediately

You can update the threshold at any time. Changes take effect for new transfers only and do not affect historical data.


Alert Details

When a large transfer is detected, your alert will include:

FieldDescription
TokenToken name and symbol
AmountRaw token amount transferred
USD ValueEstimated USD value (when available)
FromSender address
ToRecipient address
ThresholdWhich threshold was exceeded and by how much
TransactionTransaction hash with block explorer link
BlockBlock number and timestamp

Severity Levels

Large transfer alerts are assigned severity based on how much the transfer exceeds your configured threshold:

Excess Over ThresholdSeverity
1×–2×Low
2×–5×Medium
5×–10×High
10×+Critical

You can customize severity assignment in Alert Preferences using Range Mode.


Plan Availability

Large Transfer Detection is available on Pro and Ultimate plans.

PlanLarge Transfer Detection
FreeNot included
Pro✓ Included
Ultimate✓ Included

Tips

  • Set conservative thresholds first — you can always raise them if you're getting too many alerts. It's easier to increase a threshold than to miss an incident because it was set too high.
  • Use percentage mode for governance tokens — a 1% threshold catches most significant movements without generating noise from normal trading activity.
  • Combine with ownership monitoring — a large transfer combined with an ownership change on the same contract is a strong signal worth investigating immediately.
  • Check the recipient — when you receive an alert, look up the To address. If it's a known exchange, bridge, or multisig, the transfer may be routine. An unknown wallet is a red flag.