韩国投资证券 REST API MCP (模型上下文协议)

这是一个使用韩国投资证券(KIS)的 REST API 来进行股票交易和查询行情信息的 MCP (模型上下文协议) 服务器。它提供包括国内和海外股票交易、行情查询、账户管理等多种金融交易功能。

✨ 主要功能

• 🇰🇷 国内股票交易

  • 实时当前价格查询
  • 买入/卖出订单
  • 余额查询
  • 报价信息查询
  • 订单历史查询

• 🌏 海外股票交易

  • 支持美国、日本、中国、香港、越南等主要市场
  • 实时当前价格查询
  • 买入/卖出订单

• ⚡ 特点

  • 异步处理，响应迅速
  • 实时行情和成交信息
  • 稳定的错误处理
  • 可扩展的设计

⚠️ 注意事项

这个项目仍然是一个正在开发中的未完成项目。在实际投资中使用之前，请进行充分的测试。

• 使用本项目所产生的所有损失和责任完全由用户承担。
• 使用 API 时必须遵守韩国投资证券的使用条款。
• 使用真实账户时需要注意，建议使用模拟投资账户进行充分的测试。
• 必须确认与 API 调用限制相关的约束。

Requirements

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

Installation

# 1. Install uv if not already installed
pip install uv

# 2. Create and activate virtual environment
uv venv
source .venv/bin/activate  # Linux/MacOS
# or
.venv\\Scripts\\activate  # Windows

# 3. Install dependencies
uv pip install -e .

# 4. Set environment variables
export KIS_APP_KEY="应用密钥"
export KIS_APP_SECRET="密钥"
export KIS_ACCOUNT_TYPE="VIRTUAL"  # 或 "REAL"
export KIS_CANO="账户号码"

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)

Resources

Configuration

通过环境变量设置 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

Error Handling

API 调用时可能发生的主要错误:

• 认证错误: API 密钥或密钥不正确
• 余额不足: 订单金额大于账户余额
• 时间限制: 不在交易时间内
• 订单限制: 订单数量或金额超过限制

About

• 扩展性设计
• 异步处理，响应迅速
• 实时行情和成交信息
• 稳定的错误处理

License

MIT License