韩国投资证券 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 许可证