韓国投資証券 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ライセンス