koreainvestment/open-trading-api

What it solves

此项目提供完整的示例代码和工具，帮助开发者和 AI 代理人集成韩国投资证券（KIS）Open API。它简化了获取市场数据、管理账户和执行交易的过程，支持包括国内外股票、债券、期货/期权等多种金融工具。

How it works

仓库根据用户需求分为不同层级：

• LLM-Optimized Samples (examples_llm/)：小型、单函数代码片段，设计让 AI 代理人能够轻松浏览和调用特定 API 功能。
• User-Integrated Samples (examples_user/)：按资产类别组织的函数和执行示例，供人类开发者使用。
• Strategy Builder：可视化 UI 工具，用于使用技术指标设计交易策略并生成买/卖/持有信号。
• Backtester：基于 Docker 的引擎（使用 QuantConnect Lean），可对设计的策略进行历史数据验证。
• Authentication：集中式 kis_auth.py 模块负责 token 发放和环境切换（真实交易 vs. 模拟交易）。

Who it’s for

• 新手 Python 开发者，想使用 KIS Open API。
• 想改进现有 API 实现或结构的交易员。
• 构建 AI 驱动交易代理人，进行股票搜索、价格分析和自动交易的开发者。

Highlights

• AI-Ready Structure：包含 llms.txt 文件和特定文件夹结构，使 API 可被 ChatGPT、Claude 等大型语言模型访问。
• End-to-End Pipeline：支持从策略设计（Strategy Builder）到历史验证（Backtester）再到执行的完整工作流。
• Broad Asset Support：覆盖国内外股票、债券、ELW、ETF/ETN 以及期货/期权。
• Preset Strategies：内置 10 种预定义交易策略（如金叉、动量、均值回归），快速上手。