> ## 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                      |
| `/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

## /keys - Credential Management

Manage exchange API credentials securely.

1. Select **Perpetual** or **Spot**
2. Choose the exchange to configure
3. Enter API key and secret

<Warning>
  For security, only enable **read + trade** permissions on your API keys. Do not enable withdraw or transfer permissions.
</Warning>

## /config - System Configuration

Manage all system settings:

| Section         | Description                                            |
| --------------- | ------------------------------------------------------ |
| **API Servers** | Add, edit, or remove Hummingbot API server connections |
| **Gateway**     | Deploy and configure Gateway for DEX trading           |
| **Wallets**     | Create or import blockchain wallets                    |
| **Networks**    | Configure blockchain network RPC endpoints             |

## Notifications

Condor sends notifications for:

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

Configure notification preferences in `/config`.

## 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>