韓国投資証券 REST API MCP (Model Context Protocol)

韓国投資証券（KIS）のREST APIを使用して株式取引および相場情報を照会するMCP（Model Context Protocol）サーバーです。国内および海外の株式取引、相場照会、口座管理など、さまざまな金融取引機能を提供します。

✨主な機能

• 🇰🇷国内株式取引
  • リアルタイムカレントビュー
  • 枚数/売り注文
  • 残高照会
  • 湖が情報を見る
  • 注文履歴の照会
• 🌏海外株取引
  • 米国、日本、中国、香港、ベトナムなどの主要市場をサポート
  • リアルタイムカレントビュー
  • 枚数/売り注文
• ⚡特徴
  • 非同期処理による高速応答
  • リアルタイム相場と締結情報
  • 安定したエラー処理
  • 拡張可能な設計

⚠️の注意事項

このプロジェクトはまだ開発中の未完成プロジェクトです。実際の投資に使用する前に十分なテストを行ってください。

• このプロジェクトを使用して発生したすべての損失と責任は、完全にユーザーにあります。
• APIを使用する場合は、韓国投資証券の利用規約を遵守する必要があります。
• 実際の口座使用には注意が必要であり、模擬投資口座で十分なテストをお勧めします。
• API呼び出しの制限に関する制約を必ず確認してください。

Requirements

• Python >= 3.13
• uv(Python packaging tool)

Installation

Functions

Domestic Stock Trading

• inquery_stock_price - 株価現在の検索
  • symbol : 種目コード (例: "005930") (string, required)
  • Returns: 現在価、前日比、等落率、取引量など
• order_stock - 在庫購入/売り注文
  • symbol : 種目コード (string, required)
  • quantity : 注文数量 (number, required)
  • price : 注文価格 (0: 市場価格) (number, required)
  • order_type : 注文タイプ ("buy" または "sell") (string, required)
• inquery_balance - 口座残高照会
  • Returns: 保有種目、評価金額、損益現況など
• inquery_order_list - 毎日の注文履歴の照会
  • start_date : 照会開始日 (YYYYMMDD) (string, required)
  • end_date : 照会終了日 (YYYYMMDD) (string, required)
• inquery_order_detail - 注文詳細履歴の照会
  • order_no : 注文番号 (string, required)
  • order_date : 注文日 (YYYYMMDD) (string, required)
• inquery_stock_ask - 号価情報の照会
  • symbol : 種目コード (string, required)
  • Returns: 売り/枚数 好価、好価数量など

Overseas Stock Trading

• order_overseas_stock - 海外株式の購入/売り注文
  • symbol : 種目コード (例: "AAPL") (string, required)
  • quantity : 注文数量 (number, required)
  • price : 注文価格 (number, required)
  • order_type : 注文タイプ ("buy" または "sell") (string, required)
  • market : マーケットコード (string, required)
    • 「NASD」：ナスダック
    • 「NYSE」：ニューヨーク
    • 「AMEX」：アメックス
    • 「SEHK」：香港
    • 「SHAA」：中国上海
    • 「SZAA」：中国深セン
    • 「TKSE」：日本
    • 「HASE」：ベトナムハノイ
    • 「VNSE」：ベトナムホーチミン
• inquery_overseas_stock_price - 海外株式の現在のビュー
  • symbol : 種目コード (string, required)
  • market : マーケットコード (string, required)

リソース

構成

環境変数を介してAPIキーとアカウント情報を設定します。

• KIS_APP_KEY ：韓国投資証券アプリキー
• KIS_APP_SECRET ：韓国投資証券秘密鍵
• KIS_ACCOUNT_TYPE : 口座タイプ(「REAL」または「VIRTUAL」)
• KIS_CANO ：口座番号

Trading Hours

国内在庫：

• 正規場：09:00～15:30
• 時間外単価：15:40～16:00

海外在庫:

• アメリカ（ナスダック/ニューヨーク）：22:30〜05:00（韓国時間）
• 日本：09:00～15:10
• 中国：10:30～16:00
• 香港：10:30～16:00
• ベトナム：11:15～16:15

エラーハンドリング

API呼び出し時に発生する可能性がある主なエラー：

• 認証エラー：APIキーまたは秘密鍵が間違っている場合
• 残高不足: 注文金額が口座残高より大きい場合
• 時間制限：取引時間ではない場合
• 注文制限：注文数量または金額が制限を超えた場合

About

• 拡張可能な設計
• 非同期処理による高速応答
• リアルタイム相場と締結情報
• 安定したエラー処理

ライセンス

MITライセンス