Alerts

Cross-device price monitoring via Telegram and webhooks. A background daemon polls MoonPay's token API every 10 seconds and dispatches notifications when conditions are met.

Add an Alert

owl alert add \
  -t So11111111111111111111111111111111 \
  -c solana \
  --condition price_above:200 \
  --channel telegram

Flag	Description
-t, --token	Token address	required
-c, --chain	Chain name (solana, ethereum, base, etc.)	required
--condition	Condition in type:value format	required
--channel	Notification channel	required
--url	Webhook URL (required for webhook channel)	optional

Condition Types

Type	Triggers When	Example
price_above	Price >= threshold	price_above:200
price_below	Price <= threshold	price_below:100
percent_change	% move in time window	percent_change:15
balance_below	Wallet balance drops below threshold	balance_below:50

Manage Alerts

# list all alerts
owl alert list

# remove by ID
owl alert remove abc123

# start the monitoring daemon
owl alert daemon

The daemon polls mp token retrieve every 10 seconds. Alerts fire once and are marked as triggered.

Notification Channels

Send alerts to a Telegram chat via the Bot API.

owl alert channels \
  --telegram-token BOT_TOKEN \
  --telegram-chat CHAT_ID

Webhook

HTTP POST to any URL. Works with Slack, Discord, or custom servers.

owl alert channels \
  --webhook-url https://hooks.slack.com/...

Channel config is stored at ~/.config/owl/channels.json

MCP Tools

Tool	Description
owl_alert_add	Add a price alert rule
owl_alert_list	List all active alerts
owl_alert_remove	Remove an alert by ID
owl_alert_channels_set	Configure notification channels
owl_alert_history	View past triggered alerts