Hummingbot: Trading Agent

Hummingbot MCP is an open-source toolset that lets you control and monitor your Hummingbot trading bots through AI-powered commands and automation.

21 ToolsRequires ConfigurationRequires Secrets

Overview Tools (21)Config

Docker Hub Github repository

Tools

Name Description

get_portfolio_overview Get a unified portfolio overview with balances, perpetual positions, LP positions, and active orders. This tool provides a comprehensive view of your entire portfolio by fetching data from multiple sources in parallel. By default, it returns all four types of data, but you can filter to only include specific sections. Data Sources (fetched in parallel using asyncio.gather): 1. Token Balances - Holdings across all connected CEX/DEX exchanges 2. Perpetual Positions - Open perpetual futures positions from CEX 3. LP Positions (CLMM) - Real-time concentrated liquidity positions from blockchain DEXs - Queries database to find all pools user has interacted with - Calls get_positions() for each pool to fetch real-time blockchain data - Includes real-time fees and token amounts 4. Active Orders - Currently open orders across all exchanges NOTE: This only shows ACTIVE/OPEN positions. For historical data, use search_history() instead.

search_history Search historical data from the backend database. This tool is for historical analysis, reporting, and tax purposes. For real-time current state, use get_portfolio_overview() instead. Data Types: - orders: Historical order data (filled, cancelled, failed) - perp_positions: Perpetual positions (both open and closed) - clmm_positions: CLMM LP positions (both open and closed) Common Filters (apply to all data types): account_names: Filter by account names (optional) connector_names: Filter by connector names (optional) trading_pairs: Filter by trading pairs (optional) status: Filter by status (optional, e.g., 'OPEN', 'CLOSED', 'FILLED', 'CANCELED') start_time: Start timestamp in seconds (optional) end_time: End timestamp in seconds (optional) limit: Maximum number of results (default: 50, max: 1000) offset: Pagination offset (default: 0) CLMM-Specific Filters: network: Network filter for CLMM positions (optional) wallet_address: Wallet address filter for CLMM positions (optional) position_addresses: Specific position addresses for CLMM (optional) Examples: - Search filled orders: search_history("orders", status="FILLED", limit=100) - Search closed perp positions: search_history("perp_positions", status="CLOSED") - Search all CLMM positions: search_history("clmm_positions", limit=100)

Name	Description
`get_portfolio_overview`	Get a unified portfolio overview with balances, perpetual positions, LP positions, and active orders. This tool provides a comprehensive view of your entire portfolio by fetching data from multiple sources in parallel. By default, it returns all four types of data, but you can filter to only include specific sections. Data Sources (fetched in parallel using asyncio.gather): 1. Token Balances - Holdings across all connected CEX/DEX exchanges 2. Perpetual Positions - Open perpetual futures positions from CEX 3. LP Positions (CLMM) - Real-time concentrated liquidity positions from blockchain DEXs - Queries database to find all pools user has interacted with - Calls get_positions() for each pool to fetch real-time blockchain data - Includes real-time fees and token amounts 4. Active Orders - Currently open orders across all exchanges NOTE: This only shows ACTIVE/OPEN positions. For historical data, use search_history() instead.
`search_history`	Search historical data from the backend database. This tool is for historical analysis, reporting, and tax purposes. For real-time current state, use get_portfolio_overview() instead. Data Types: - orders: Historical order data (filled, cancelled, failed) - perp_positions: Perpetual positions (both open and closed) - clmm_positions: CLMM LP positions (both open and closed) Common Filters (apply to all data types): account_names: Filter by account names (optional) connector_names: Filter by connector names (optional) trading_pairs: Filter by trading pairs (optional) status: Filter by status (optional, e.g., 'OPEN', 'CLOSED', 'FILLED', 'CANCELED') start_time: Start timestamp in seconds (optional) end_time: End timestamp in seconds (optional) limit: Maximum number of results (default: 50, max: 1000) offset: Pagination offset (default: 0) CLMM-Specific Filters: network: Network filter for CLMM positions (optional) wallet_address: Wallet address filter for CLMM positions (optional) position_addresses: Specific position addresses for CLMM (optional) Examples: - Search filled orders: search_history("orders", status="FILLED", limit=100) - Search closed perp positions: search_history("perp_positions", status="CLOSED") - Search all CLMM positions: search_history("clmm_positions", limit=100)

Hummingbot: Trading Agent

Tools

Related servers