> ## Documentation Index
> Fetch the complete documentation index at: https://condor.hummingbot.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Telegram Interface

> Mobile-friendly interface for controlling Condor via Telegram bot

Condor provides a Telegram bot interface for mobile-friendly control of your trading infrastructure. You can interact with it conversationally or use structured commands.

## Conversational Mode

Before creating Trading Agents, you can talk to Condor directly using natural language:

```
You: What's my balance on Binance?
Condor: Here's your Binance balance:
- USDT: 1,234.56
- BTC: 0.025
- ETH: 0.5
```

```
You: What routines do I have for market analysis?
Condor: You have these analysis routines available:
- technical_analysis: Analyze trend, volatility, support/resistance
- support_resistance_ema: Identify S/R levels with EMA alignment
```

```
You: Can you analyze BTC-USDT and tell me what you think?
Condor: Running technical analysis routine...
- Trend: EMA aligned (fast > mid > slow) - bullish
- Key support: $62,500
- Key resistance: $65,200
- Suggestion: Consider grid with long bias
```

## Commands

| Command | Description |
| - | - |
| `/start` | Welcome message and setup |
| `/portfolio` | View balances across exchanges |
| `/agent` | Trading Agent management and LLM connection |
| `/executors` | Deploy and manage trading executors |
| `/bots` | Deploy and manage trading bots |
| `/new_bot` | Create bot configurations |
| `/routines` | Run configurable Python routines |
| `/trade` | Place CEX and DEX orders |
| `/swap` | DEX token swaps via Gateway |
| `/lp` | Liquidity pool management |
| `/servers` | Manage Hummingbot API servers |
| `/keys` | Configure exchange API credentials |
| `/gateway` | Gateway for DEX trading |
| `/web` | Open the web dashboard |
| `/memory` | What each assistant remembers about you, grouped |
| `/delegations` | Background agent tasks and their results |
| `/stop` | Interrupt the answer in flight, keeping the session |
| `/cancel` | Back out of any in-progress input flow |
| `/admin` | User approvals and roles (admin) |
| `/update` | Check for updates and restart (admin) |

## /start - Main Menu

The welcome screen providing quick access to all features. Returns to the main menu at any time.

## /portfolio - Portfolio Dashboard

Comprehensive portfolio tracking across all connected accounts and exchanges.

**Features:**

* **P\&L Tracking**: 24-hour, 7-day, and 30-day performance metrics
* **Token Holdings**: Current balances with price changes
* **Position Monitoring**: Perpetual futures and CLMM positions
* **Visual Analytics**: Portfolio value charts and distribution graphs

## /bots - Bot Management

Monitor and control all Hummingbot trading bot instances.

**Features:**

* **Status Overview**: Health indicators for all bots
* **System Metrics**: CPU usage, memory, uptime
* **Controller Performance**: Track strategy metrics
* **Start/Stop**: Control bot lifecycle
* **Log Viewing**: Access bot logs for debugging

## /agent - Trading Agents

Create and manage autonomous Trading Agents.

**Features:**

* **Create Agent**: Guided setup for new Trading Agents
* **Select LLM**: Connect Claude, Gemini, Copilot, Codex, OpenRouter, or a local model — see [Integrating your LLM](/llm-integration)
* **Run Modes**: dry\_run, run\_once, or loop
* **Monitor**: View active sessions and tick status
* **Inject Directives**: Send real-time instructions to running agents

## /trade - CEX Trading

Unified trading interface for centralized exchanges.

**Supported Exchanges:** Binance, Bybit, OKX, Kucoin, Kraken, Coinbase, Hyperliquid

**Features:**

* Market and limit orders
* Position management (perpetual)
* Leverage configuration
* Order tracking and cancellation

## /swap - DEX Token Swaps

Execute token swaps on decentralized exchanges via Gateway.

**Supported DEXs:** Jupiter (Solana), Uniswap (Ethereum, Base)

**Features:**

* Get quotes from multiple protocols
* Slippage protection
* Transaction status tracking

## /lp - Liquidity Pool Management

Manage Concentrated Liquidity Market Maker (CLMM) positions.

**Supported Protocols:** Orca, Raydium, Meteora, Uniswap V3

**Features:**

* View active LP positions
* Add/remove liquidity
* Collect accumulated fees
* Position range monitoring

## /servers, /keys, /gateway - System Configuration

Configuration is three separate commands rather than one menu:

| Command | What it covers |
| - | - |
| `/servers` | Add, edit, or remove Hummingbot API server connections, set the default, and see live status per server |
| `/keys` | Which exchanges are connected. **Read-only in Telegram** — see below |
| `/gateway` | Gateway for DEX trading: status, connectors, wallets, networks and RPC endpoints, pools and tokens |

### Exchange credentials are dashboard-only

`/keys` lists the exchanges currently connected and nothing more. Connecting a
new one, or removing an existing one, happens in the web dashboard under
**Settings → Keys** — the command hands you a login link, valid for 5 minutes,
to get there. An API secret is never typed into a Telegram chat, where it would
sit in message history on Telegram's servers.

<Warning>
  When creating the key at your exchange, enable **read + trade** only. Do not
  enable withdrawal or transfer permissions.
</Warning>

<Note>
  Older material refers to a single `/config` command. It no longer exists —
  use the three above, or the dashboard's [Settings page](/webui/settings),
  which covers the same ground in one place.
</Note>

## /update - Updates and Restart

Admin only. Checks **Condor** and the **Hummingbot API** beside it, showing what
each is running and what is available — for the API, both its git checkout and
its container image, since they answer different questions.

Before anything runs, a preflight reports **blockers** (a diverged checkout,
local changes that would be overwritten, an unreachable registry) with a way out
where one exists — a dirty checkout offers **discard** or **stash** — and
**warnings** that never refuse, such as restarting the API reaping its
executors.

An update lands the code, syncs dependencies, rebuilds the dashboard, and then
**asks you to relaunch** rather than restarting itself: Condor is rarely the top
of its own process tree, so re-execing races the parent into a second Condor on
the same port and token. Run `make restart` when it asks.

<Note>
  The dashboard has the same panel at **Settings → Updates**, over the same
  engine — an update started here can be watched to completion there, and a
  **Local mode** install uses that panel instead of this command. See [Keeping
  Condor updated](/getting-started/installing#keeping-condor-updated).
</Note>

## /cancel - Back Out of a Flow

Several flows ask for the next message as their answer — a server name, a
price, an amount. `/cancel` abandons that flow and returns you to normal
command handling. It is what the prompts themselves tell you to send, and it
works from inside any of them.

## Notifications

Condor sends notifications for:

* Executor state changes (created, filled, stopped)
* Risk limit violations
* Bot status changes
* Price alerts from routines

## Voice Commands

Send voice messages to Condor for hands-free trading. Condor uses Whisper for local transcription—no audio leaves your server.

### How It Works

1. Hold the microphone button in Telegram
2. Speak your command
3. Release to send
4. Condor transcribes and processes your request

### Examples

**Check prices:**

```
"Hey Condor, what's the price of ORCA USDT on Binance Perpetual?"
→ ORCA $1.96
```

**Create executors:**

```
"Create a grid executor on ORCA to go long between 1.9 and 2.02,
invest $300 with take profit of 0.15%"
→ Grid executor created: ORCA-USDT long grid, 1.90-2.02, $300
```

**Check status:**

```
"Can you tell me the state of that grid?"
→ Your grid is cooking. 3 levels filled, $45 invested, +$0.82 unrealized
```

<Note>
  The first voice message may take longer as Condor downloads the Whisper model (\~1GB). Subsequent messages are faster.
</Note>

## Security

* **User Whitelist**: Only authorized Telegram user IDs can interact with the bot
* **No Credential Storage**: API keys are stored encrypted on the server, not in Telegram
* **Session Isolation**: Each user's session is isolated

Using Condor in Telegram every day? Tell us what's working and what you wish it could do.

<Card title="Help shape Condor" icon="clipboard-list" href="https://forms.gle/7NpG3RtgfLrmpUNY8" cta="Take the 2-minute survey" type="tip">
  What's working? What's confusing? What do you wish Condor could do? Your answers go straight to the Hummingbot Foundation team and directly shape what we build next.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.