Telegram BotMarket Data in Your Pocket
Send commands to @RealMarketAPISaasBot on Telegram to get live prices, market overviews, AI forecasts, price alerts, and volume spike notifications — no server required.
/set YOUR_API_KEY. After that, all authenticated commands work automatically. Get your key from the dashboard.Setup Commands
/startNo authDisplays the welcome message with a quick-start guide.
/set YOUR_API_KEYNo authConnects an API key to your Telegram account. The key must be active. If you already have a key connected, it will be replaced.
• Key shorter than 10 characters → format error
• Key not found or not active → not found error
/set sk_live_abcdefghij1234567890
/unsetNo authDisconnects the current API key from your Telegram session. Works even if the key is revoked or session is suspended.
/helpNo authDisplays the full command reference grouped by category.
Market Data Commands
/price SYMBOLAuth requiredReturns the live price for a single symbol. Data is sourced from the real-time Redis price channel (M1), falling back to the latest DB candle.
| Field | Description |
|---|---|
Price | Current close price |
Ask / Bid | Ask and bid prices |
High / Low | Candle high and low |
Change | Close − Open (absolute + %) |
Time | Candle open time (UTC) |
Source | ⚡ Live (Redis) or 🗄 Cached (DB) |
/price XAUUSD
/price BTCUSD
/price EURUSD
/marketAuth requiredDisplays a market overview of all plan-allowed symbols grouped by market class (Crypto, Forex, etc.). Shows symbol, price, and hourly change %.
/symbolsAuth requiredLists all available symbols grouped by market class. ✅ = included in your plan · 🔒 = requires a higher plan.
/tfAuth requiredLists all available timeframes in canonical order (M1 → MN). ✅ = included in your plan · 🔒 = requires a higher plan.
Analysis & Forecast
/next SYMBOL [TIMEFRAME]Auth requiredPlus / Pro / BusinessReturns a price forecast for the next candle based on technical indicators. Default timeframe is H1.
Indicators
EMA 21 / 50 | Exponential Moving Average |
RSI (14) | Wilder's smoothed RSI |
ATR (14) | Average True Range |
Support | Min low — last 20 candles |
Resistance | Max high — last 20 candles |
Signal Bias
🟢 Bullish — bull score > bear AND ≥ 3
🔴 Bearish — bear score > bull AND ≥ 3
⚪ Neutral — otherwise
Price targets: price ± ATR(14)
/next XAUUSD
/next BTCUSD H1
/next EURUSD M15
Wishlist
A personal watchlist of symbols with live M1 prices and % change.
/wishlistAuth requiredShows all symbols in your watchlist with current prices and % change.
/wishlist add SYMBOLAuth requiredAdds a symbol to your watchlist. Symbol must be in your plan. Duplicate entries are rejected.
/wishlist remove SYMBOLAuth requiredRemoves a symbol from your watchlist.
/wishlist remove allAuth requiredClears your entire watchlist at once.
Price Alerts
One-shot alerts triggered when price crosses a target level. Alerts are preserved after firing (IsTriggered = true).
/alert SYMBOL PRICEAuth requiredCreates a price alert. Direction is auto-detected from the current price vs your target.
/alert XAUUSD 2000
/alert BTCUSD 65000.50
/alert listAuth requiredLists all active (non-triggered) alerts with their 8-character short ID.
/alert remove {id}Auth requiredRemoves an alert by its 8-character short ID prefix.
/alert remove a3f8c1d2
/alert remove allAuth requiredRemoves all active alerts at once.
Volume Spike Alerts
One-shot alerts triggered when M1 volume exceeds a multiple of the historical average. Optional args can be provided in any order.
/spike SYMBOL [MULTIPLIER] [TIMEFRAME]Auth requiredRegisters a volume spike watch. Multiplier (min 1.5, default 2.0) and baseline timeframe (default H1) are optional and can be given in any order. Creation is rejected if the current volume already exceeds the threshold. One active watch per symbol per user.
| Baseline | avg(last 20 TF candles volume) ÷ minutes-per-candle → M1 equivalent |
| Trigger | M1 volume ≥ baseline × multiplier |
| Min multiplier | 1.5 |
| Default multiplier | 2.0 |
| Default timeframe | H1 |
Supported Baseline Timeframes
| Value | Candle size |
|---|---|
M1 | 1 minute |
M5 | 5 minutes |
M15 | 15 minutes |
M30 | 30 minutes |
H1 | 1 hour (default) |
H4 | 4 hours |
D1 | Daily |
/spike XAUUSD
/spike BTCUSD 3
/spike EURUSD 1.5 H4
/spike XAUUSD H4
/spike XAUUSD 2.5 D1
/spike listAuth requiredLists all active spike watches with their threshold and 8-character short ID.
/spike remove {id}Auth requiredRemoves a spike watch by its 8-character short ID prefix.
/spike remove b2e91fc0
SMA Crossover Alerts
Subscribe to SMA21 / SMA50 crossover alerts on any supported timeframe. The bot fires a notification every time SMA21 crosses above or below SMA50. Subscriptions remain active indefinitely until removed.
/sub sma {timeframe} {symbol}Auth requiredSubscribes to SMA21/SMA50 crossover alerts for the given symbol and timeframe. A duplicate subscription for the same pair is rejected.
| Argument | Description | Example |
|---|---|---|
{timeframe} | M1 · M5 · M15 · M30 · H1 · H4 · D1 | H1 |
{symbol} | Trading symbol (case-insensitive) | XAUUSD |
/sub sma h1 XAUUSD
/sub sma h4 BTCUSD
/sub listAuth requiredShows all active SMA crossover subscriptions with their current state and short ID.
📈 SMA Crossover Subscriptions
• XAUUSD H1 | SMA21 above SMA50 ⬆️ | 🆔 3fa2c1b0
• BTCUSD H4 | SMA21 below SMA50 ⬇️ | 🆔 7e90d4a1
/sub remove {id}Auth requiredRemoves a specific SMA crossover subscription by its 8-character short ID.
/sub remove 3fa2c1b0
/sub remove allAuth requiredRemoves all active SMA crossover subscriptions at once.
Alert Notification Format
🟢 SMA Crossover Alert!
📌 Symbol: XAUUSD
⏱️ Timeframe: H1
📊 SMA21 has crossed above ⬆️ (Bullish) SMA50
📈 SMA21: 2324.183456
📉 SMA50: 2318.750123
🕒 Time: May 06, 14:00 UTC
Use /price XAUUSD for full details.
| Cross Direction | Emoji | Label |
|---|---|---|
| SMA21 crosses above SMA50 | 🟢 | Bullish |
| SMA21 crosses below SMA50 | 🔴 | Bearish |
Crossover Detection Logic
Tick N: SMA21 < SMA50 → state saved as false (no alert — first check)
Tick N+X: SMA21 > SMA50 → state changed → 🟢 FIRE alert, update to true
Tick N+Y: SMA21 < SMA50 → state changed → 🔴 FIRE alert, update to false
... repeats until user runs /sub remove {id}
- • Checked every 1 minute via
SmaAlertHostedService - • Candles fetched from Redis (
HISTORICAL:PRICE_CHANNEL_{SYMBOL}_{TIMEFRAME}) - • Minimum 50 candles required for a valid SMA50 calculation
- • The first check only initialises state — no alert is sent on subscription creation
Account & Info
/meAuth requiredDisplays your account profile.
| Field | Source |
|---|---|
| API Key status | TelegramTracking.Status |
| Total Events | TelegramTracking.TotalSuccessEvent |
| Plan name | Plan.Name via Usage.CurrentPlanCode |
| Usage | RequestCount / RequestLimit (+ %) |
| Expiry | Usage.EndDate + days remaining |
| Auto-Renewal | Usage.AutoRenewal |
Ready to get started?
Connect your API key and start receiving live market data right in Telegram.