How Background Alerts Work
Native Mobile (Capacitor)
On iOS and Android, Chainfolio uses native background processing—a framework for running tasks in the background without draining battery.
- Runs in isolated native process
- Scheduled execution every 15-30 minutes
- Access to native push notifications
- Low battery impact optimization
Web Browser (Service Workers)
In browsers, Chainfolio uses Service Workers with Periodic Background Sync to evaluate alerts when the browser is open (even if tab is closed).
- Works in Chrome, Edge, Safari
- Browser push notifications
- Offline-first design
- No server dependency
Alert Types & Triggers
Portfolio Balance Alerts
Monitor your total portfolio value or individual wallet balances.
- Absolute thresholds – Alert when portfolio crosses $10K, $100K, $1M
- Percentage changes – Alert on 5%, 10%, 25% daily moves
- Relative changes – Alert if portfolio drops 15% from all-time high
- Token-specific – Alert when specific token balance changes
Price Movement Alerts
Track token prices without relying on centralized price-alert services.
- Price thresholds – Alert when BTC > $70K or SOL < $100
- Percentage moves – Alert on 10% hourly or 25% daily moves
- Volume spikes – Alert on unusual trading volume
- Market cap changes – Alert when token enters/exits top 100
RPC Health Alerts
Monitor the health and performance of your RPC endpoints.
- Latency thresholds – Alert when RPC response > 2 seconds
- Error rate alerts – Alert when > 10% of requests fail
- Sync status – Alert when RPC falls behind chain tip
- Rate limit warnings – Alert when approaching rate limits
Transaction & Activity Alerts
Get notified of on-chain activity across your tracked wallets.
- New transactions – Alert on any incoming/outgoing transaction
- Large transfers – Alert on transfers > configured amount
- DeFi interactions – Alert on staking, lending, swapping
- NFT activity – Alert on NFT purchases, sales, transfers
Advanced Alert Logic
Condition Builder
Chainfolio's alert system supports complex logical conditions using AND/OR operators:
Example: Whale-Like Behavior
IF (portfolio_value > $1M) AND (solana_balance > 10,000 SOL)
AND (hourly_tx_count < 3) THEN alert_level = "HIGH"
Example: DeFi Risk Monitoring
IF (defi_exposure > 40% of portfolio) AND
(protocol_concentration > 20% in single protocol)
THEN alert_level = "MEDIUM"
Example: Market Downturn Protection
IF (portfolio_drop > 15% in 24h) AND
(btc_dominance_increasing) AND
(fear_greed_index < 20) THEN alert_level = "CRITICAL"
Risk-Level Classification & Cooldown
Alert Severity Levels
- LOW – Informational (e.g., daily portfolio summary)
- MEDIUM – Worth attention (e.g., 10% portfolio move)
- HIGH – Actionable (e.g., large withdrawal to exchange)
- CRITICAL – Immediate attention (e.g., RPC completely down)
Intelligent Cooldown
Prevents alert fatigue with configurable cooldown periods:
- Per-alert cooldown – Don't alert twice for same condition within X minutes
- Global cooldown – Limit total alerts per hour/day
- Escalation bypass – Critical alerts always fire regardless of cooldown
- Sleep hours – Mute alerts during specified hours
Privacy-First Alert Architecture
No Server Dependency
Traditional Alert Services
- Your wallet addresses stored on their servers
- Alert logic runs on their infrastructure
- They know when and why you get alerts
- Require accounts and authentication
Chainfolio Background Alerts
- Alert evaluation happens on your device
- No server ever sees your alert conditions
- Push notifications via local OS mechanisms
- No accounts, no telemetry, no data sharing
Technical Implementation
Alert Evaluator
Core service that evaluates alert conditions against live portfolio data using real-time UI updates.
Background Bridge
Bridges data between main app and native background processing / Service Workers.
Notification Engine
Handles native push notifications (iOS/Android) and browser notifications with rich content.
Use Cases & Examples
DeFi Farmer
Alert: "Notify me if my staking APY drops below 5% OR if protocol TVL drops 30% in 24h"
Long-Term Holder
Alert: "Notify me if my portfolio crosses $1M OR if BTC dominance rises above 55%"
Active Trader
Alert: "Notify me if SOL price moves 5% in 1h OR if whale moves > $5M to exchange"
Infrastructure Manager
Alert: "Notify me if RPC latency > 2s OR if sync falls behind by > 100 blocks"