Dhan Trading

🚀 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 文件獲取詳細信息。

⚠️ 免責聲明

此軟件僅用於教育目的。使用風險自擔。創建者對使用此軟件造成的任何財務損失不承擔責任。執行所有交易操作前請務必核實。