Monitors

Set up automated alerts to watch for on-chain events and get notified when conditions are met.

Overview

Monitors run on a schedule and execute a predefined query or rule against the chain data. When the rule matches, ChainGraph sends a notification via your configured channels (in-app, email, webhook, or Slack).

Creating a monitor

1. Go to Monitors in the sidebar
2. Click New Monitor
3. Choose a monitor type (template or custom query)
4. Configure the parameters (address, threshold, time window)
5. Set the schedule (every 1 min, 5 min, 15 min, 1 hour, daily)
6. Choose notification channels
7. Save and enable

Monitor templates

Pre-built templates for common use cases:

• Large transfer alert — notify when a transfer above a threshold is detected
• New counterparty — notify when a watched address transacts with a new address
• Sanctioned address interaction — notify when a monitored address interacts with a sanctioned entity
• Token drain — notify when a large percentage of tokens leave an address
• Contract deployment — notify when a watched address deploys a new contract
• DEX activity — notify when a watched address makes a DEX swap
• Dormant address activation — notify when an address inactive for X days transacts

Custom query monitors

Pro and Enterprise users can write custom Cypher or SQL queries as monitor rules. The query runs on schedule and triggers if it returns any rows.

-- Example: Alert when any address receives > 100 ETH
SELECT tx_hash, from_address, to_address, value_wei
FROM native_transfers
WHERE to_address = '0x...'
  AND value_wei > 100000000000000000000
  AND block_timestamp > now() - INTERVAL 5 MINUTE

Notification channels

Monitor statuses

• Active — running on schedule
• Paused — temporarily disabled
• Error — last run failed (check the error log)
• Triggered — last run matched and sent a notification

Limits