Unified CLI Command Syntax
BitCLI uses an identical command-line syntax across all interfaces. Whether you type a message directly into the Telegram bot or an AI agent passes a string into the MCP alert_manager(command=...) tool, the C++ engine parses and executes it identically.
💡 Default Exchange Context: Alerts default to Bybit Linear. To target another venue, prefix the command with
binance,bybit, orhl(Hyperliquid). You can change your personal default exchange via/settings.
1. Price Targets & Corridors
Set absolute price levels, exit channels, or percentage deviations evaluated tick-by-tick.
| Syntax | Example | Description |
|---|---|---|
<coin> <price> | btc 95k | Triggers when BTC reaches $95,000 (auto-detects UP/DOWN direction). |
[exchange] <coin> <price> | binance eth 3150 | Explicitly targets Binance USDⓈ-M Futures. |
<coin> <min>-<max> | btc 64k-95k | Corridor Exit: Alerts when price leaves this channel in either direction. |
<coin> +<pct>% | sol +3.5% | Triggers only if SOL pumps 3.5% from current market price. |
<coin> -<pct>% | eth -5% | Triggers only if ETH dumps 5% from current market price. |
<coin> <pct>% | btc 2% | Bidirectional Corridor: Alerts if price deviates ±2%. |
Note: Suffixes k (thousand) and m (million) are supported everywhere (e.g. 95.5k, 1.2m).
2. Velocity (Rapid Pumps & Dumps)
Detect sudden price momentum before the candle closes. The engine evaluates rolling price changes in RAM tick-by-tick.
Syntax: [exchange] <coin|*> [+-]<pct>% <timeframe>
btc 3% 5m— Alert if BTC jumps ±3% within any rolling 5-minute window.sol +2.5% 1m— Fast pump alert: triggers only on upward moves > 2.5% within 1 minute.* -5% 15m— Global Radar: Scans all 1,650+ contracts simultaneously across the exchange and alerts if any coin dumps 5% in 15 minutes.
3. Whale Volume Spikes (RVOL)
Volume spikes compare the volume of the currently forming candle block against the 20-period Simple Moving Average (SMA20) of historical closed blocks.
Syntax: [exchange] <coin|*> vol <timeframe> x<multiplier>
sol vol 5m x3— Triggers when SOL 5m volume exceeds 3x its 20-period baseline.* vol 15m x4— Scans the whole exchange for anomalous institutional volume bursts (4.0x SMA20).
4. Forced Liquidations & Cascade Anomalies
Monitor forced position liquidations and statistical clustering in real time.
btc liq 500k— Single forced liquidation event exceeding $500,000 USD on BTC.* liq 1m— Global scan for liquidation events exceeding $1,000,000 USD on any contract.* liq z3— Liquidation Cascade Anomaly: Triggers when liquidation volume exceeds 3 standard deviations (Z-Score > 3.0σ) from historical baseline.
5. Order Flow (Cumulative Volume Delta)
Cumulative Volume Delta (CVD) measures the net imbalance between aggressive market buyers (ask hitters) and aggressive market sellers (bid hitters).
btc cvd div 15m— CVD Divergence: Detects exhaustion setups where price makes a new high/low while CVD initiative diverges.sol cvd abs 5m— Delta Absorption: Catches passive institutional limit walls (icebergs) absorbing aggressive taker flow.
6. Open Interest & Funding Rates
Normalized 8-hour funding rates and leverage accumulation tracking.
* oi +5% 15m— Sudden 5% surge in open interest in 15 minutes (leverage buildup).sol oi -10% 1h— Mass position flush / liquidations.* fr > 0.1%— Alerts when longs are heavily overcrowded (paying >0.1% per 8h funding).sol fr < -0.05%— Alerts when short sellers are aggressively paying longs to hold positions.
7. Historical & Daily Key Levels
btc ath— Alerts when Bitcoin breaks its global All-Time High.sol atl— Alerts when Solana breaks its All-Time Low.eth pdh— Breakout above Yesterday's High (Previous Day High).eth pdl— Breakdown below Yesterday's Low (Previous Day Low).
8. Cooldown Modifier (cd=)
Prevent alert spam during choppy or high-volatility conditions by appending a cooldown period:
* vol 5m x3 cd=30m— Trigger once, then mute volume alerts for 30 minutes.btc 3% 5m cd=1h— Mute velocity alerts on BTC for 1 hour after first trigger.