Preflight Check
Understand preflight checks and the reasons a start may be blocked.
Pre-start checks
Before a LIVE start the launcher checks and asks, in this order:
- The robot file reads and its launch profile settings are valid. A shared traded pair is informational; a pair used only as an input is not treated as a traded pair.
- The mode confirmation: the Start “…” in …? dialog.
- The secure key storage works on this computer, and the risk limits that are set are valid.
- A separate confirmation, LIVE start: real money (on Sandbox, LIVE · Sandbox start: test funds). The dialog opens with Cancel focused.
- There are API keys. If there are none, the key entry dialog opens right away.
- After the account is selected, Launcher checks this computer and the servers of the current XTester Studio profile. It checks again before the real test order and immediately before starting the robot.
- If the last command to the exchange ended with an unknown outcome, a manual check (see Quarantine).
- On the first LIVE start on this account, a real test order (see below).
- The robot starts; the progress shows in a notification with Cancel the Start.
- Blocking reason
If a check fails, the launcher shows the reason and, where it can, a button to fix it: Open Connections, Open Launch Profile, Open Risk Limits, Choose an Account. All check lines are in the journal.
A Paper robot also passes a pre-start check; if it fails, the journal opens with the reasons.
The same public exchange-account fingerprint in two locations refuses a second Live start on every pair. Different fingerprints do not block a shared pair. If a fingerprint is unknown, the same pair on the same exchange network is conservatively treated as a possible shared account and the start is refused. The same strategy requires a separate warning or confirmation.
If Studio is closed, a server is unreachable, observations are stale or the Agent does not support the check, the absence of other robots is unconfirmed: a new Live start or explicit resume is held. Open the correct XTester Studio window and check its servers in Robots. Paper keeps its ordinary checks and reports unknown remote coverage in the journal.
The real test order
On the robot's first LIVE start on an account, the launcher checks that the exchange accepts and cancels orders. It shows the plan: the order type, price, quantity, amount and an estimated fee.
- Tick The exchange is checked: no open orders, no position and I understand this is a real order on a real account, with my money. If the exchange did not confirm maker-only mode, a third tick is needed.
- Click Next and type the order amount exactly as shown.
- Click Send the Real Order. The launcher sends one minimal order, reads it back from the exchange, cancels it and checks that there is no position.
If a manual check is needed, the ticks are reset: check the open orders and the position right on the exchange and confirm again.
Other robots are checked again before the real test order is sent. A refusal or cancellation sends no new order. This check does not replace your checkboxes, exact amount entry or confirmation of the real order.
Risk limits
Limits are set in the launch profile: Risk limits. They are optional for LIVE, but the limits that are set are checked before the start: for example, an order limit above the position limit stops the start with an explanation.
The daily loss is set in the account currency, as a percentage of the capital at the start of the UTC day, or both; the stricter one then applies. The limit counts the robot's own result, not the whole account's, so deposits, withdrawals and other robots do not affect it. Once the daily limit is hit, new entries stop until the end of the day.
Keys only in the launcher
Exchange keys are entered only in the launcher: on the Connections page or in the dialog the launcher opens itself at the start. They are kept only on this computer, in secure storage, and never go into robot files.
Never share keys, private keys or a mnemonic. For wallets, enter the agent or signer key, not the master wallet's.
Intervention
If something changed on a LIVE robot's account without its command (a foreign order appeared, a robot order was cancelled or changed, the position changed apart from its trades), a yellow strip Intervention in the robot's strategy. with the details appears under the title bar, and Intervention appears in the status bar.
• If the robot trades on: Open the Journal or Acknowledge; the warning goes away and comes back at the next change.
• If the robot paused on its pair and waits for your decision: Adopt the change makes the orders and position of the pair the robot's and it continues; Restore cancels all orders of the pair and closes a position opened without the robot, then continues; or end its work with Stop.
If Telegram is chosen in the profile, you can also decide by replying in Telegram.
Quarantine and unknown outcomes
If a command to the exchange ended with an unknown outcome (for example, the connection broke), the launcher does not know whether it was carried out. Before the next LIVE start it shows The exchange needs a check.
- Open the exchange and check this account: the open orders and the position.
- Click Yes, Checked. Before the start the launcher makes sure once more that the exchange is clean.
If a position or orders stayed on the exchange after a stop, the status bar warns check the exchange: check them before the next start.