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

这是使用韩国投资证券（KIS）的REST API搜索股票交易和价格信息的MCP（模型上下文协议）服务器。提供国内外股票交易、行情查询、账户管理等多种金融交易功能。

✨ 主要特点

• 🇰🇷国内股票交易
  • 实时现价查询
  • 买入/卖出订单
  • 查看余额
  • 查看家庭信息
  • 查看订单历史记录
• 🌏外国股票交易
  • 支持美国、日本、中国、香港和越南等主要市场
  • 实时现价查询
  • 买入/卖出订单
• ⚡功能
  • 通过异步处理实现快速响应
  • 实时价格和交易信息
  • 稳定的错误处理
  • 可扩展设计

⚠️ 注意

该项目尚在开发中，是一个未完成的项目。在实际投资之前，请进行彻底的测试。

• 因使用本项目而产生的任何损失和责任均由用户自行承担。
• 使用API时，您必须遵守韩国投资证券使用条款。
• 使用真实账户时需谨慎，建议使用模拟投资账户进行充分测试。
• 请务必检查有关 API 调用限制的限制。

要求

• Python >= 3.13
• uv（Python打包工具）

安装

功能

国内股票交易

• inquery_stock_price - 查询当前股票价格
  • symbol ：股票代码（例如“005930”）（字符串，必需）
  • 返回：当前价格、前一日价格、涨跌幅、交易量等。
• order_stock - 股票买入/卖出订单
  • symbol ：股票代码（字符串，必需）
  • quantity ：订单数量（数量，必填）
  • price ：订单价格（0：市场价）（数字，必填）
  • order_type ：订单类型（“买入”或“卖出”）（字符串，必需）
• inquery_balance - 查询账户余额
  • 回报：持股情况、估值、盈亏状况等。
• inquery_order_list - 查询每日订单历史记录
  • start_date ：搜索开始日期（YYYYMMDD）（字符串，必需）
  • end_date ：搜索结束日期（YYYYMMDD）（字符串，必需）
• inquery_order_detail - 查询订单详情
  • order_no ：订单号（字符串，必需）
  • order_date ：订单日期（YYYYMMDD）（字符串，必需）
• inquery_stock_ask - 查询股票价格信息
  • symbol ：股票代码（字符串，必需）
  • 返回：卖价/买价、买入数量等。

海外股票交易

• order_overseas_stock - 海外股票买卖订单
  • symbol ：股票代码（例如“AAPL”）（字符串，必需）
  • quantity ：订单数量（数量，必填）
  • price ：订单价格（数字，必填）
  • order_type ：订单类型（“买入”或“卖出”）（字符串，必需）
  • market ：市场代码（字符串，必需）
    • “NASD”：纳斯达克
    • “NYSE”：纽约
    • “AMEX”：美国运通卡
    • “香港联交所”：香港
    • “SHAA”：中国上海
    • “SZAA”：中国深圳
    • “TKSE”：日本
    • “HASE”：越南河内
    • “VNSE”：越南胡志明市
• inquery_overseas_stock_price - 查询当前海外股票价格
  • symbol ：股票代码（字符串，必需）
  • market ：市场代码（字符串，必需）

资源

配置

通过环境变量设置您的 API 密钥和帐户信息：

• KIS_APP_KEY ：韩国投资证券应用程序密钥
• KIS_APP_SECRET ：韩国投资证券密钥
• KIS_ACCOUNT_TYPE ：账户类型（“REAL”或“VIRTUAL”）
• KIS_CANO ：账号

交易时间

国内库存：

• 正常营业时间：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 密钥或密钥
• 资金不足：当订单金额大于账户余额时
• 时间限制：交易时间以外
• 订单限制：如果订单数量或金额超出限制。

关于

• 可扩展设计
• 通过异步处理实现快速响应
• 实时价格和交易信息
• 稳定的错误处理

执照

MIT 许可证