Dhan Trading

🚀 DhanHQ 取引アシスタント

このプロジェクトは、Model Context Protocol (MCP) をベースにした AI 駆動の 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 ファイルを参照してください。

⚠️ 免責事項

このソフトウェアは教育目的でのみ使用されます。利用は自己責任で行ってください。作成者は、このソフトウェアの使用によって生じるいかなる財務的損失にも責任を負いません。すべての取引操作を実行する前に必ず確認してください。