MCP 工具参考¶
Hummingbot MCP 服务器向 AI 助手公开以下工具，用于自动化交易和投资组合管理。
账户工具¶
get_accounts¶
列出所有连接的交易所账户及其状态。
返回： 包含连接详情的账户对象数组
示例用法：
get_account_balance¶
获取特定交易所账户的余额。
参数： - account_name (string): 交易所账户名称
返回： 指定账户的余额详情
示例用法：
投资组合工具¶
get_portfolio_balances¶
查看所有连接交易所的聚合投资组合。
返回： 跨交易所的所有资产的合并视图
示例用法：
get_portfolio_performance¶
分析投资组合绩效指标，包括盈亏。
返回： 绩效指标、回报和分析
示例用法：
交易工具¶
place_order¶
在支持的交易所执行买卖订单。
参数： - exchange (string): 目标交易所 - trading_pair (string): 交易对（例如 "BTC-USDT"） - side (string): "buy" 或 "sell" - amount (number): 订单金额 - order_type (string): "market" 或 "limit" - price (number, optional): 限价订单价格
返回： 包含订单 ID 的订单确认
示例用法：
cancel_order¶
取消现有订单。
参数： - order_id (string): 要取消的订单 ID - exchange (string): 下单交易所
返回： 取消确认
示例用法：
get_open_orders¶
查看跨交易所的所有活动订单。
参数： - exchange (string, optional): 按特定交易所过滤
返回： 包含详情的未平仓订单列表
示例用法：
get_order_history¶
查看过去的订单执行历史。
参数： - exchange (string, optional): 按交易所过滤 - trading_pair (string, optional): 按交易对过滤 - limit (number, optional): 返回结果数量
返回： 历史订单数据
示例用法：
头寸工具¶
get_positions¶
查看衍生品交易的未平仓头寸。
参数： - exchange (string, optional): 按交易所过滤
返回： 包含盈亏数据的未平仓头寸列表
示例用法：
close_position¶
以编程方式平仓特定头寸。
参数： - exchange (string): 持有头寸的交易所 - symbol (string): 头寸符号 - amount (number, optional): 部分平仓数量
返回： 头寸平仓确认
示例用法：
get_position_history¶
查看历史头寸数据和表现。
参数： - exchange (string, optional): 按交易所过滤 - limit (number, optional): 结果数量
返回： 包含盈亏的历史头寸数据
示例用法：
市场数据工具¶
get_ticker¶
获取交易对的当前价格数据。
参数： - exchange (string): 目标交易所 - symbol (string): 交易对符号
返回：当前价格、交易量和 24 小时统计数据
示例用法：
get_orderbook¶
访问订单簿深度数据。
参数： - exchange（字符串）：目标交易所 - symbol（字符串）：交易对符号 - depth（数字，可选）：订单簿深度级别
返回：当前买卖订单及其数量
示例用法：
get_funding_rates¶
监控跨交易所的永续合约资金费率。
参数： - exchange（字符串，可选）：按交易所筛选 - symbol（字符串，可选）：按交易对筛选
返回：当前资金费率和下次资金时间
示例用法：
工具使用示例¶
复杂工作流¶
投资组合再平衡：
AI: "Analyze my portfolio and rebalance to 60% BTC, 30% ETH, 10% SOL"
1. Uses get_portfolio_balances to assess current allocation
2. Calculates required trades using market data tools
3. Executes rebalancing orders with place_order
4. Confirms new allocation with updated portfolio data
风险管理：
AI: "Close any positions with more than 10% unrealized loss"
1. Uses get_positions to analyze all open positions
2. Identifies positions exceeding loss threshold
3. Uses close_position for each position meeting criteria
4. Reports actions taken and updated risk exposure
资金费率套利：
AI: "Find negative funding rate opportunities for BTC"
1. Uses get_funding_rates across multiple exchanges
2. Identifies profitable funding rate spreads
3. Opens positions to capture funding payments
4. Monitors and manages positions automatically
工具响应格式¶
所有工具返回结构化的 JSON 响应，AI 助手可以解析并以自然语言呈现给用户。MCP 服务器处理技术 API 交互，而 AI 提供用户友好的解释和建议。
错误处理¶
工具包括全面的错误处理：- 无效参数 - 交易所连接问题
- 余额不足错误 - 速率限制 - 认证失败
错误响应包含描述性消息，AI 助手可以解释给用户用简单语言。
安全说明¶
- 所有交易操作都需要适当的认证
- 头寸规模和风险限制应适当配置
- 定期监控 AI 交易活动
- 设置异常交易行为的警报
- 切勿在对话中分享 API 凭据