Skip to main content
Hummingbot API is a RESTful server that provides programmatic access to the Hummingbot trading framework. It serves as the execution layer for Condor and other AI trading systems.

​
System Architecture

​
Components

​
User Interfaces

ComponentDescription
CondorTelegram bot for mobile/desktop control of trading operations
MCP / AI AgentsConnect Claude, Gemini, GPT, or other LLMs to trading infrastructure

​
Server Layer

ComponentDescription
Hummingbot APIFastAPI server providing REST endpoints for trading, data, and bot management
PostgreSQLStores orders, accounts, positions, and performance metrics
EMQXMessage broker enabling real-time communication with bot instances

​
Core Components

ComponentDescription
Hummingbot ClientCore Python library with CEX connectors and trading strategies
GatewayDEX middleware for Uniswap, Jupiter, Raydium, and 30+ DEXs

​
How It Works

  1. User Interfaces (Condor, AI agents) send requests to the Hummingbot API
  2. Hummingbot API processes requests and routes them to the appropriate component
  3. Hummingbot Client handles CEX trading via exchange APIs
  4. Gateway handles DEX trading via blockchain RPCs

​
Deployment Options

​
Development (Local)

Run everything on your local machine: 
# Clone and start Hummingbot API
git clone https://github.com/hummingbot/hummingbot-api
cd hummingbot-api
make install
make run

​
Production (Server)

Deploy on a cloud server with Docker:
  • API server runs as a systemd service or Docker container
  • Bots run as isolated Docker containers
  • Gateway runs as a separate service for DEX access

​
Data Flow

​
Learn More

Hummingbot

The core trading framework

Gateway

DEX middleware for decentralized trading