Guides · All plans
Telegram bot
Send commands to @RealMarketAPISaasBot to get live prices, market overviews, forecasts, price alerts, and volume spike notifications. No server required.
Connect once
/set YOUR_API_KEY once; after that every authenticated command works 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 a key is already connected, it is replaced. A key shorter than 10 characters returns a format error; a key that is not found or not active returns a 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 the 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, sourced from the real-time Redis price channel (M1) with a fallback to the latest database 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 requiredMarket overview of all plan-allowed symbols grouped by market class (Crypto, Forex, etc.), with symbol, price, and hourly change %.
/symbolsAuth requiredLists all available symbols grouped by market class, marking which are included in your plan and which require a higher plan.
/tfAuth requiredLists all available timeframes in canonical order (M1 → MN), marking which are included in your plan and which require a higher plan.
Analysis & forecast
/next SYMBOL [TIMEFRAME]Auth requiredPlus / Pro / BusinessReturns a forecast for the next candle based on technical indicators. Default timeframe is H1.
Indicators
| Indicator | Definition |
|---|---|
| EMA 21 / 50 | Exponential Moving Average |
| RSI (14) | Wilder's smoothed RSI |
| ATR (14) | Average True Range |
| Support | Min low over the last 20 candles |
| Resistance | Max high over the last 20 candles |
Signal bias
| Bias | Rule |
|---|---|
| Bullish | Bull score > bear score and ≥ 3 |
| Bearish | Bear score > bull score and ≥ 3 |
| Neutral | Otherwise |
Price targets: price ± ATR(14)
/next XAUUSD
/next BTCUSD H1
/next EURUSD M15Wishlist
/wishlistAuth requiredShows all symbols in your watchlist with current prices and % change.
/wishlist add SYMBOLAuth requiredAdds a symbol to your watchlist. The symbol must be in your plan; duplicates are rejected.
/wishlist remove SYMBOLAuth requiredRemoves a symbol from your watchlist.
/wishlist remove allAuth requiredClears your entire watchlist at once.
Price alerts
IsTriggered = true)./alert SYMBOL PRICEAuth requiredCreates a price alert. Direction is detected from the current price: Above when the target is higher than the current price, Below when it is lower.
/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
/spike SYMBOL [MULTIPLIER] [TIMEFRAME]Auth requiredRegisters a volume spike watch. Multiplier (min 1.5, default 2.0) and baseline timeframe (default H1) are optional. Creation is rejected if current volume already exceeds the threshold. One active watch per symbol per user.
| Setting | Value |
|---|---|
| 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 b2e91fc0SMA crossover alerts
/sub sma {timeframe} {symbol}Auth requiredSubscribes to SMA21/SMA50 crossover alerts for a 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 | 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 (bullish), update to true
Tick N+Y: SMA21 < SMA50 → state changed → FIRE alert (bearish), update to false
... repeats until the user runs /sub remove {id}- Checked every minute by
SmaAlertHostedService. - Candles are read from Redis (
HISTORICAL:PRICE_CHANNEL_{SYMBOL}_{TIMEFRAME}). - At least 50 candles are required for a valid SMA50 calculation.
- The first check only initialises state; no alert is sent when the subscription is created.
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 receive live market data in Telegram.