🚀 DhanHQ 交易助理

这是一款由 AI 驱动的 DhanHQ 经纪商交易助手，基于 Model Context Protocol (MCP) 构建。它实现了与 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 凭证。

安装步骤

1. 克隆此仓库到本地：

git clone https://github.com/yourusername/dhanhq-trading-assistant.git
cd dhanhq-trading-assistant

2. 使用 pip 安装依赖项：

pip install -r requirements.txt

3. 配置您的 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 文件获取详细信息。

⚠️ 免责声明

此软件仅用于教育目的。使用风险自担。创建者对使用此软件造成的任何财务损失不承担责任。执行所有交易操作前请务必核实。