Use Telegram

Stay in touch with your agent through Telegram. Receive updates, check positions and recent decisions, change notification preferences, or request a turn with an instruction that applies to that turn only.

Connect your Telegram account

1. Sign in to DXAP and open Profile > Settings.
2. Under Notifications, choose Connect Telegram.
3. Choose Open Telegram, or scan the QR code with your phone. Use the link generated for your account.
4. In the bot’s private chat, tap Start and wait for the account-linked confirmation.
5. Return to Settings and choose I’ve linked Telegram or Refresh if the connection has not appeared yet.

If the link expires, choose Generate new code in Settings and open the new link. Commands work in your private chat with the bot.

Connected does not mean alerts are on

Linking Telegram enables commands, including notification controls and confirmed turn requests. Choose which alerts to receive for each agent using /notifications.

Choose your alerts

Send /notifications, then tap the option you want:

Option	What you receive
Agent updates	Summaries of your agent’s finished turns.
Trade alerts	Notifications of recorded agent trades.
Both	Agent updates and trade alerts.
Off	No automatic alerts for this agent. You can still use commands.

The selection updates that agent’s notification preferences. Send /status to check the current settings and the last alert sent. With several agents, configure each one separately, for example /notifications Owl.

Slash commands

With one agent, send the command on its own. With several agents, add the agent’s name where shown. Square brackets below indicate optional text; do not type the brackets.

Command	What it does
/positions [agent name]	Shows open positions, direction, leverage, size, entry price, and unrealized PnL in USD.
/last [agent name]	Shows the latest finished turn, including failed or cancelled turns, and whether another turn is pending or running.
/triggers [agent name]	Shows the schedule and next scheduled time separately from active trigger conditions.
/status [agent name]	Shows the Telegram connection, agent alert settings, and last alert sent. Without a name, lists your agents’ status.
/agents	Lists your agents, trading mode, activity state, and alert status.
/notifications [agent name]	Opens the buttons for choosing agent updates, trade alerts, both, or off.
/run [instruction]	Previews a manual turn for your single agent, with an optional instruction. Requires confirmation. See the examples below for several agents.
/help	Shows the command list and usage examples.
/start	Shows setup guidance. Opening the connection link from Settings uses this command to link your account.

Use the full agent name shown by /agents. Names are matched without regard to capitalization. If two agents have the same name, rename one in the app before selecting it through Telegram.

When a reply offers another page, follow its command, such as /positions Owl page=2 or /triggers Owl page=2. Positions are shown five per page. Times in replies are in UTC.

Read positions and triggers

/positions uses the latest recorded position data and prices. Check the timestamps: unrealized PnL can change before the next update. It excludes realized PnL, fees, and funding. Use Positions and Trades in the app to review the account and execution outcomes.

/triggers separates Schedule from Triggers, so an hourly schedule and a price condition are easy to distinguish. Triggers only fire when your agent is not paused. Use the app to change schedules or trigger conditions.

Request a turn

For a single agent, send /run to request a turn using its existing strategy. To add an instruction for that turn, include it after the command:

/run Review my existing positions before considering new entries.

With several agents, use the agent’s name. Separate the name from an instruction with |:

/run Owl
/run Owl | Review my existing positions before considering new entries.

Review the agent name and Directive in the preview. Tap Confirm within five minutes to queue the turn, or Cancel to dismiss it. A queued turn may result in trades; the confirmation acknowledges the request, not a completed trade.

The directive applies to that turn only. If you leave details unspecified, the agent interprets the instruction under its existing settings and trading limits. It does not update the agent’s saved strategy or create a persistent instruction. For those changes, use Chat and instructions in the app.

A paused agent must be resumed in the app before you can request a turn. Manual turns share a 30-minute cooldown with the app, and another manual turn cannot be requested while one is pending or running. The bot explains when a request is unavailable. Use /last and the app’s Activity to review the result.

If something is missing

• Connected, but no alerts: Send /status, then use /notifications to enable the categories you want for the correct agent.
• A button has expired or settings changed: Send /notifications or /run again and use the latest reply.
• The bot asks you to link again: Return to Profile > Settings, generate a new connection link, and complete the linking flow.
• Positions look old or have no recorded data: Check the timestamps and review the account in the app. Missing data does not establish that the account has no positions.

To disconnect, open Profile > Settings and choose Disconnect in the Telegram section. This removes Telegram access and alerts; your agent continues running. To stop future agent activity, see Pause and revoke access.