🚀 韩国投资证券 REST API MCP（模型上下文协议）
通过韩国投资证券(KIS)的REST API，借助MCP（模型上下文协议）服务器，可实现股票交易以及市场行情信息的查询。该系统支持国内及海外股票交易、账户管理等多样化金融服务，为用户提供便捷、高效的金融交易体验。
🚀 快速开始
本项目可通过韩国投资证券的REST API，利用MCP服务器开展股票交易和市场行情信息查询等操作。使用前，需按以下步骤配置相关信息。
✨ 主要特性
-
🇰🇷 国内股票交易
- 实时当前价查询
- 买入/卖出订单
- 资金余额查询
- 报价信息查询
- 订单记录查询
-
🌍 海外股票交易
- 查询海外市场实时行情（包括美国、日本、中国、香港、越南等）
- 根据市场代码和股票代码进行价格查询
- 下达买入或卖出指令
⚠️ 重要提示
请勿随意泄露API密钥，确保账户安全。使用前需仔细阅读相关协议。
📦 安装指南
通过环境变量配置API密钥和账户信息：
KIS_APP_KEY：韩国投资证券应用编程接口密钥KIS_APP_SECRET：韩国投资证券应用程序加密密钥KIS_ACCOUNT_TYPE：账户类型（"REAL" 或 "VIRTUAL"）KIS_CANO：客户账号
💻 使用示例
国内股票交易功能
| 函数名称 | 描述 |
|---|---|
inquiry_domestic_stock_price |
查询国内股票实时行情 |
order_purchase |
下达买入委托指令 |
order_sale |
下达卖出委托指令 |
inquiry_balance |
查询账户资金余额 |
inquiry_order |
查询当前订单状态 |
海外股票交易功能
| 函数名称 | 描述 |
|---|---|
inquiry_overseas_stock_price |
根据市场代码查询海外股票价格 |
order_purchase_international |
下达国际买入委托指令 |
order_sale_international |
下达国际卖出委托指令 |
📚 详细文档
⏰ 交易时间
国内股票：
- 正常交易时段：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密钥错误）
- 资金不足（订单金额超过账户余额）
- 非交易时段操作
- 订单数量或金额超出限制
📜 关于项目
- 具有扩展性设计
- 采用异步处理实现快速响应
- 提供实时行情和成交信息
- 稳定的错误处理机制