Condor

Condor is a powerful Telegram bot that provides a mobile-friendly interface to interact with Hummingbot API. It allows you to monitor portfolios, manage trading bots, execute trades on both centralized (CEX) and decentralized (DEX) exchanges, and configure your entire trading setup—all from Telegram.

Condor Dashboard Coming Soon

A browser-based version of Condor is in development and will replace the current Dashboard.

Why Use Condor?

• Accessibility: Manage your bots on the go without needing SSH access or complex terminal commands.
• Optimized for AI: Chat-based, simple interface will evolve toward natural language.
• Team Usage: Manage multiple API servers and control access with view-only mode.

Core Components

1. Telegram Interface: The user-facing component running on Telegram clients, handling user input and displaying interactive menus.
2. Command Handlers: The logic layer that processes specific commands (e.g., /portfolio, /bots) and determines the appropriate action.
3. API Integration Layer: A secure communication module that interacts with the Hummingbot Backend API using standard REST protocols.
4. Data Processing Utilities: Helper functions that format raw data from Hummingbot into clear, readable messages and visualizations (charts/graphs).

Installation

Condor is installed automatically when you run the Hummingbot API Quickstart. During installation, you'll need to provide:

Create a Telegram Bot:

BotFather is Telegram's official bot for creating and managing bots.

1. Open the link above or search for @BotFather in Telegram
2. Send /newbot and follow the prompts to name your bot (e.g., @my_condor_bot)
3. Copy the bot token (looks like 123456789:ABCdefGHIjklMNOpqrsTUVwxyz)

Get Your Telegram User ID:

UserInfoBot is a bot that tells you your Telegram user ID.

1. Open the link above or search for @userinfobot in Telegram
2. Send /start - it will reply with your User ID (a number like 123456789)

Connect To Hummingbot API Server

1. Open @my_condor_bot (or whatever you named it) in Telegram and send /start
2. Use /servers to add your Hummingbot API server:
   • Name: Enter a name (e.g., localhost or my-server)
   • Host: Enter localhost (local) or your server IP (cloud)
   • Port: Enter 8000 (default)
   • Username: Enter your API username (default: admin)
   • Password: Enter your API password (default: admin)
3. Click Confirm & Add to save the server

Setting Default Server

After adding a server, you need to set it as your default server. Click on the server name in the /servers list to view its details and set it as default.

Once set as default, the server will show a crown icon in the list and display "Your default server" in the details view.

Adding Keys

Use /keys to add your exchange API credentials. This allows Condor to access your exchange accounts for trading and portfolio monitoring.

1. Run /keys to open the credentials menu
2. Select Perpetual or Spot depending on the exchange type
3. Choose the exchange you want to configure
4. Enter the required credentials (API key, secret, and any exchange-specific options)

See Connecting to Exchanges for details on creating API keys for each exchange.

Only enable Read and Trade access

For security reasons, we recommend using only read + trade enabled API keys. Do not enable withdraw or transfer permissions.

After adding your keys, run /portfolio to view your balances across all connected exchanges.

Commands

Once connected, you can use these commands:

Command	Description
/start	Welcome message and server status
/portfolio	View detailed portfolio breakdown
/bots	Check status of all trading bots
/trade	Unified trading - CEX orders and DEX swaps
/lp	Liquidity pool management
/routines	Run configurable Python scripts
/servers	Manage Hummingbot API servers
/keys	Configure exchange API credentials
/gateway	Deploy Gateway for DEX trading
/admin	Admin panel - manage users and access