🚀 DhanHQ 交易助理
DhanHQ 交易助理是一款基于 Model Context Protocol (MCP) 的 AI 驱动交易助手，专为 DhanHQ 经纪商打造。它实现了与 DhanHQ 交易平台的自然语言交互，用户只需通过简单的对话指令，就能轻松完成订单放置、查看投资组合以及管理交易活动等操作。
🚀 快速开始
DhanHQ 交易助理能让你通过自然语言与 DhanHQ 交易平台交互，便捷地开展各类交易活动。下面为你介绍使用前的安装与设置步骤。
✨ 主要特性
订单管理
- 普通订单（市价单/限价单）：可借助
order_placement_tool.py完成。 - 超级订单：带有目标和止损价的订单，通过
super-order.py进行管理。 - 收市后订单：使用
after_market_order_tool.py可在市场收盘后下单，确保次日开盘时执行。 - 订单簿和交易历史记录访问：通过
order_book_tool.py能访问订单簿和交易历史记录。
投资组合管理
- 持仓和头寸查看：通过
holdings_positions_tool.py查看持仓和头寸情况。 - 头寸转换：支持将头寸从日内交易转为交割等操作。
账户信息
- 资金余额查看：使用
fund_balance_tool.py可查看账户资金余额。 - 保证金需求计算：通过
margin_calculator_tool.py计算保证金需求。
📦 安装指南
先决条件
- Python 3.8 或更高版本
- pip 包管理器
- DhanHQ 账户及 API 凭证
安装步骤
- 克隆此仓库到本地：
git clone https://github.com/yourusername/dhanhq-trading-assistant.git
cd dhanhq-trading-assistant
- 使用 pip 安装依赖项：
pip install -r requirements.txt
- 配置您的 DhanHQ API 凭证，创建
config.ini文件并添加以下内容：
[dhanhq]
api_key = your_api_key_here
api_secret = your_api_secret_here
💻 使用示例
基础用法
以下是一些常见的交易指令示例：
# 查看当前资金余额
/balance
# 查询股票报价
/quote TCS.NS
# 下单购买股票
/buy HDFCBANK 10 shares at limit price 500
# 设置止损订单
/sell RELAXYES 5 lots with stop loss 20%
高级用法
各工具的功能说明如下：
order_placement_tool.py
此工具用于处理普通市价单和限价单，支持买入和卖出操作。
super-order.py
该工具用于管理带有复杂目标和止损条件的超级订单，支持百分比和固定价格两种模式。
after_market_order_tool.py
允许在市场收盘后下单，确保次日开盘时执行。
fund_balance_tool.py
提供账户资金、未平仓头寸和可用保证金信息。
holdings_positions_tool.py
显示当前持仓、历史交易记录和允许的产品类型转换。
margin_calculator_tool.py
计算不同投资组合的保证金需求，并生成报告。
order_book_tool.py
访问订单历史、未成交订单和已完成交易，支持订单取消功能。
📚 详细文档
项目使用 stocks.json 文件将股票名称映射到其标识符，文件结构如下：
{
"companies": [
{
"stock_code": "1333",
"company_name": "HDFC 银行有限公司",
"stock_name": "HDFCBANK",
"description": "..."
}
]
}
📄 许可证
本项目使用 MIT 许可证。查看 LICENSE 文件获取详细信息。
⚠️ 重要提示
此软件仅用于教育目的。使用风险自担。创建者对使用此软件造成的任何财务损失不承担责任。执行所有交易操作前请务必核实。
💡 使用建议
建议在使用前仔细阅读文档，熟悉各工具的功能和使用方法。同时，在进行实际交易操作时，先在模拟环境中进行测试，确保操作的准确性。