Alerts

Alerts are Telegram messages sent by the Alerts Bot when something about your positions or orders needs attention. They only inform you; they never close or change a position.

The Alerts page has one master switch for the bot and one switch per alert group. Each group has its own thresholds and a repeat interval, so you only get the messages you want.

• Bot switch. When it is off, monitoring stops entirely; your settings are kept. The status dot next to it is green and pulsing when the bot is active, yellow when it is slow (a delay of 10–30 seconds) and red when it is offline or switched off.
• Groups. P&L alerts, missing stop-loss and take-profit, liquidation risk, limit orders, API connection errors, reminders before big US macro releases, and a Monday summary of the week's releases. Each is described in its own section below.
• Saved automatically. Switches save the moment you flip them; number fields and the day and hour of the week-ahead summary save when you leave the field (or press Enter) and a short "Saved" confirms it. A value that is not accepted goes back to the previous one. The Save button at the bottom saves everything on demand, just in case.
• Repeats. Every alert has a minimum interval in minutes between repeats of the same message, so a position that stays above a threshold does not flood your chat.

Alerts cover every exchange you have connected and enabled. To receive them you first need to link Telegram, as described under Config.

Get a message when an open position's profit or loss, measured against the margin you put in, crosses your threshold, and again each time it moves further by your step.

P&L is a percentage of margin, so leverage is already accounted for. The defaults are shown below; change them to fit your style.

• Stop-loss threshold (default −1.0) — alert when P&L falls below this percentage. For example −2 means a loss of 2% of margin.
• Stop-loss step (default 2.0) — alert again each time P&L falls this many percentage points further.
• Take-profit threshold (default 1.0) — alert when P&L rises above this percentage.
• Take-profit step (default 1.0) — alert again each time P&L rises this many points further.
• Alert frequency (default 360 minutes) — the minimum time between repeats of the same alert.
• Position opened and Position closed — one-time messages when a position appears or closes, with the result on close.

A tight loss threshold on low leverage creates noise; a loose one on high leverage arrives late. Start with the defaults, watch the messages for a few days and adjust.

Get a reminder when an open position or a limit order has no stop-loss or take-profit, or when it covers only part of the size. Reminders stop once it is fully covered.

You configure this separately for Positions and Limit Orders, with a switch for Stop Loss not configured and one for Take Profit not configured in each. Enable only what you need. Repeat reminder every (default 10 minutes) sets how often the reminder repeats while the problem remains.

There are two different messages:

• "…is not set!" — there is no stop-loss or take-profit at all.
• "…doesn't cover the full position/order size!" — one exists, but its size does not reach the full position or order. This happens when you scale into a position without replacing the old stop, or when the exchange holds several partial stop or take-profit orders that do not yet add up to the full size.

Partial coverage is detected for exchanges that support several stop or take-profit legs: Bybit's Partial mode, OKX's multi-leg attach orders and BloFin's independent standing orders. Bybit and OKX also allow such a ladder on a limit order that has not filled yet.

Get an alert when the price has covered most of the distance from your entry to the exchange's liquidation price, before the exchange liquidates the position.

BitMe uses the liquidation price that your exchange reports for the position, so the alert is right for the margin mode and leverage you actually use. It measures how much of the way from your entry price to that liquidation price the current price has already covered: 0% is just opened, 100% is at the liquidation price.

• Threshold (default 90, range 1–100) — alert when the price has covered this percentage of the distance. 90 means price is 90% of the way to liquidation.
• Frequency (default 10 minutes) — how often to repeat while the position stays above the threshold.

Example of the message:

[SOL] Liquidation risk! 92.3% to liquidation price

Some exchanges do not report a usable liquidation price for every position (BloFin does not for cross-margin positions). In that case BitMe falls back to the share of the margin that the loss has consumed, and the message reads Margin used 92.3% instead. This fallback is exact only for isolated margin.

Raise the threshold only if you accept less warning; a lower one gives you more time to add margin, reduce the position or close it. The alert informs you; it does not act.

Get an alert when the market price approaches one of your pending limit orders, and when limit orders are placed or closed.

• Threshold (default 30) — start alerting when price is within this percentage of the order price.
• Step (default 1.0) — alert again each time the price gets this many percent closer.
• Frequency (default 360 minutes) — the minimum time between alerts for the same order.
• New limit order and Closed limit order — one-time messages when an order is placed or disappears.

Only regular limit orders are monitored; take-profit and stop-loss orders are excluded.

Get an alert when BitMe cannot reach an exchange API, so you know monitoring itself has gone blind.

It fires after 3 consecutive failures, so an occasional hiccup is ignored. The cause can be an exchange outage, a revoked or expired key, or a network error. While the problem lasts, the alert repeats at the interval you set.

Example of the message:

[API Error: Bybit API failed 3× in a row (retCode=10004)]

If you see this for one exchange, check that the key is still valid in Config (the exchange card shows “Sync failing — check your API key” when the nightly sync cannot use it) and that the exchange is not down.

Get a Telegram reminder shortly before a scheduled US macro release that often moves the whole market, together with a list of your open positions.

Pick which releases you care about, grouped by region: United States (FOMC rate decision, US CPI, US jobs report, US PCE inflation), Europe (ECB rate decision) and Japan (BoJ rate decision). FOMC, CPI and the jobs report are on by default; PCE, ECB and BoJ are off until you switch them on. The Bank of Japan does not announce the time of its decision in advance (it comes when the meeting ends, around noon in Tokyo), so BoJ reminders use an approximate time and say so and how long before them you want to hear: 60 minutes and 15 minutes (both on by default), and a third row where you type your own number of minutes (1 to 1440, i.e. up to 24 hours) and switch it on. You can combine them, e.g. 60, 15 and 120. If the bot was offline for part of that time, you get one reminder for the closest window, not several.

• Press conference. For the FOMC and ECB decisions the reminder also gives the start of the press conference (30 minutes after the decision), which often moves the market as much as the decision itself. The BoJ conference time is not published, so it is not listed.
• Open positions. The message lists your positions on every exchange and marks those without a stop-loss.
• Only when I have open positions. On by default, so a flat account stays quiet. Turn it off to get the reminder anyway.

Example of the message:

[Macro][FOMC rate decision in 15 min (18:00 UTC; press conf. 18:30 UTC). Open: BTC Long (Bybit), ETH Short (OKX). No SL: ETH Short (OKX).]

The release dates come from the official calendars of the Federal Reserve, the Bureau of Labor Statistics, the Bureau of Economic Analysis, the European Central Bank and the Bank of Japan and can change; BitMe lists only dates it has checked. The reminder only informs you; it never changes a position. To get the whole week's releases in one message every Monday, use the week-ahead summary.

Once a week BitMe sends you a Telegram list of the macro releases scheduled for the next 7 days, for the events you selected in Macro events. You choose the weekday and hour. It is part of Macro events, so it is not sent while that section is switched off.

When it arrives

You choose the weekday and the hour yourself, in Alerts → Week-ahead summary: tap a day (Mon–Sun) and pick the hour. The default is Monday, 9:00.

The time is in your own timezone (set it in Profile; without one BitMe uses UTC). The message arrives once a week, at the chosen hour or within about 15 minutes after it.

What it covers

The list starts on the day you chose and runs for 7 days, so the window always begins at the moment the message arrives.

• Monday 9:00 (default): arrives Monday morning, covers Monday – Sunday.
• Wednesday 18:00: arrives Wednesday evening, covers Wednesday – next Tuesday.
• Sunday 20:00: arrives Sunday evening, covers Sunday – next Saturday.

Because every message covers exactly the 7 days after it, no release is missed and none is listed twice, whichever day you pick. The title shows the dates, e.g. "Week ahead 28.10–03.11".

Each release is shown with its day and time in your timezone. A week without any gets a one-line message that also names the next release.

Good to know

• Same events as the reminders. It lists the events you selected in Macro events; if you switched one off there, it is left out here too.
• Part of Macro events. It sits inside that block: when you switch the whole Macro events section off, the week-ahead summary is not sent either.
• Changing the day. If you move it to a later day in the same week, you get the next message on that day, even if one already arrived earlier in the week.
• If BitMe was unavailable at your hour, the message is sent later the same day. It is not sent on the following day, because a list that has already started is worse than none.
• Where it also shows. The message is added to the notification inbox in the header. The calendar icon next to it shows the current week at any time, see Notifications inbox and macro calendar.

It is off by default. Switch it on in Alerts; it needs your Telegram Chat ID, like the other alerts.

Example of the message (Monday):

📅 Week ahead 26.10–01.11
• Wed 28.10 19:00 — FOMC rate decision (press conf. 19:30)
• Fri 30.10 13:30 — US jobs report (NFP)
Times in Europe/Warsaw

The Clear cache button on the Alerts page makes the bot forget what it remembers about your alerts, so the next check starts from zero.

The bot remembers which positions it has seen and when it last sent each alert, so it does not repeat the same message too often. Clear cache deletes that memory for your account. Afterwards:

• Alerts can be sent again right away, even if the repeat interval has not passed.
• Positions that are already open can be reported as new.

Use it after a larger change of thresholds when you want to see the new rules applied at once, or if alerts seem stuck. You do not need it in normal use, and it does not change your settings or touch your exchange.

Two icons in the header, next to your avatar, on every page: the inbox with the history of alerts the bot sent you, and the calendar with this week's macro releases.

Inbox

• Where. The inbox icon sits left of your avatar. A red badge shows how many alerts are unread, and it updates by itself every few seconds.
• Open it to see the latest 30 alerts, newest first. The unread ones are in bold. Opening the inbox clears the badge; the history stays. Close it with ✕, by tapping outside it or by tapping the icon again.
• What appears. The same alerts that go to Telegram: P&L, missing stop-loss and take-profit, liquidation risk, limit orders, macro reminders, the week-ahead summary and API errors. Each row has an icon showing where it came from.

The inbox is a convenience copy. Telegram remains the place where alerts are delivered, so keep the Alerts Bot and your Chat ID set up.

Macro calendar

The calendar icon, left of the inbox, lists the macro releases (FOMC, US CPI, US jobs report, US PCE, ECB, BoJ) scheduled for the current week, Monday to Sunday.

• A small grey number on the icon tells you how many releases are still ahead today (in your timezone). The number drops as each release happens, and no number means nothing more is scheduled today.
• Each row shows the day and date, the event and its time, in your timezone (set it in Profile; without one BitMe uses UTC). Today's row is highlighted and releases that already happened are dimmed.
• Press conference. Under the FOMC and ECB decisions a grey line shows when the press conference starts (30 minutes later).
• All releases are listed, whatever you selected in Macro events. Those settings only decide which reminders are sent to Telegram.
• It works without Telegram or alerts switched on. It is a calendar, not an alert. The BoJ time is approximate, as noted in the row.

The reminders and the Monday list sent to Telegram are described in Macro events and Week-ahead summary.