Skip to article
XTester Help
XTester Launcher

Connections

Manage exchange-account and Telegram connections.

Reviewed: Applies to: 1.0.0-preview.1

Exchange accounts

On the left is the Exchanges list with the accounts and the state of their keys: no keys, keys rejected, not verified or verified with a date. The account this robot trades through is marked “…” trades through this account.

Steps
  1. Click + (Add an Exchange Account).
  2. Choose the Exchange and the Network (Mainnet or Sandbox). They are set once, when the account is created.
  3. Enter a Name: this is how the account is called in the launch profile.
  4. Fill in the keys and click Save.
Application screenshotXTester 1.0.0-preview.1
Select a profile to check its exchange, network and key status. The demo profiles have no keys.Interface screenshot · XTester 1.0.0-preview.1

API keys

The key fields depend on the exchange: usually API Key and API Secret, on some exchanges a Passphrase too; on wallet-based exchanges the master wallet address and the private key of the agent or signer, on dYdX the address, the mnemonic and the subaccount number.

Application screenshotXTester 1.0.0-preview.1
This example selects the test network. Key fields are blank and the account is unsaved. Mainnet and Sandbox use separate credentials.Interface screenshot · XTester 1.0.0-preview.1
  1. Enter credentials for the selected network.

• Save saves the keys. The verification mark is reset.

• Verify sends a read-only request to the exchange. If the keys work, Keys verified … appears with the beginning of the account fingerprint. If the fingerprint changed after you replaced the keys, they belong to another account.

• A saved key is never shown again: the field is empty with the hint Saved — leave empty to keep it.

• Forget… erases the account's keys from this computer. A robot that traded through it will need another account in its profile.

Create a separate exchange subaccount for the robot. The launcher keeps other XTester robots off it at the same time, but does not protect it from manual trading or other bots.

Telegram

One notification bot for all robots of this computer. Connecting it is optional.

Steps
  1. Choose Telegram in the list on the left.
  2. Enter the Bot token and the Chat ID and click Save.
  3. Click Send a Test and check that the message arrived.
  4. In the robot's launch profile, choose this Telegram in the Telegram field.
Application screenshotXTester 1.0.0-preview.1
Advanced: manual credentials opens the bot token and chat ID fields. The form is blank; no connection was saved and no message was sent.Interface screenshot · XTester 1.0.0-preview.1
  1. Bot token and chat ID.

What is sent is chosen in Settings → Notifications. Forget… erases the token and the Chat ID.

Where the keys are kept

Keys and the token are kept only on this computer, in the system's secure storage, and never go into robot files. They are never written as plain text.

If the secure storage is unavailable, keys cannot be saved and LIVE is blocked; only Paper is available. To move connections to another computer, use Transferring connections.