open-trading-api

用Python轻松接入韩国证券交易，还能让AI帮你下单

open-trading-api 是一个面向韩国投资与证券（Korea Investment & Securities）开放 API 的 Python 封装库，旨在简化开发者对韩国证券市场交易接口的调用。它解决了原生 OpenAPI 使用门槛高、认证流程复杂、文档零散的问题，将 REST 调用、WebSocket 连接、令牌管理等底层细节封装为简洁的 Python 方法。核心能力包括：支持股票、ETF、期权等品种的行情查询与订单执行，提供自动交易策略的快速搭建框架，并集成了对 LLM（如 ChatGPT、Claude）的适配，可通过自然语言指令触发交易操作。项目基于 MCP（Model Context Protocol）设计，便于 AI 代理接入，同时附带丰富的示例代码，覆盖从基础查询到复杂策略的回测与实盘。整体上，它为个人开发者和小型量化团队提供了高效、低门槛的韩国市场交易工具。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1615

维护状态较活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队koreainvestment

所属国家

官网地址https://apiportal.koreainvestment.com

GitHubhttps://github.com/koreainvestment/open-trading-api

定价模式unknown

价格说明官网为韩国投资证券开放API门户，提供API服务，但具体定价信息未明确，需进一步确认。

访问状态

是否开源是

开源协议

主要语言Python

技术栈/模型ai-trading,api-samples,autotrade,chatgpt,claude,finance,investment,koreainvestment,llm,mcp,open-trading-api,openapi,python,realtime,rest-api,stock-trading,stocks,trading,trading-api,websocket

GitHub 星标★ 1615

30天Star增速

HF 下载量

上线时间2022-04-08 00:00:00

最近更新2026-09-23 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

Python 开发环境（仓库面向 Python 开发者提供示例代码）
韩国投资证券 Open API 账号与认证信息（需在 apiportal.koreainvestment.com 申请）
使用 backtester 时需本地已安装并启动 Docker Desktop

安装与启动步骤

1克隆项目仓库

把 open-trading-api 仓库拉到本地，示例代码、认证模块和文档都在其中。
```
git clone https://github.com/koreainvestment/open-trading-api.git
```
2申请 Open API 认证

访问韩国投资证券 Open API 门户申请接口权限并获取认证信息，示例代码依赖该认证才能调用接口。
3查看 LLM 使用指南

仓库根目录提供 llms.txt，供 ChatGPT、Claude 等 LLM 与 AI 代理快速理解仓库结构与用法。
4选择示例目录

examples_llm/ 是单个 API 功能粒度的示例，examples_user/ 是按品种整合的实际投资与自动交易示例，按需进入。
5确认回测环境

使用基于 QuantConnect Lean 的 backtester 前，先确认 Docker Desktop 已运行，Lean 镜像首次运行会自动下载。
```
docker info
docker images | grep lean
```

如何确认成功

执行 docker info 能正常输出，且 docker images | grep lean 能看到 Lean 镜像，说明回测环境已就绪。

常见问题

Q：运行 backtester 时出现 Docker 错误怎么办？

A：README 建议先运行 docker info 确认 Docker Desktop 是否已启动，再用 docker images | grep lean 检查 Lean 镜像，首次运行会自动下载。

Q：examples_llm 和 examples_user 有什么区别？

A：examples_llm/ 面向 LLM，按单个 API 功能拆分，便于检索和调用；examples_user/ 按品种整合，适合实际投资与自动交易实现。

Q：怎么让 ChatGPT 或 Claude 读懂这个仓库？

A：把仓库根目录的 llms.txt 提供给模型，它会基于该文件快速了解仓库结构和示例代码的调用方式。

Q：示例代码能直接用于实盘吗？

A：README 声明示例代码仅供参考、可能随时更新且不另行通知，因使用示例代码造成的损失官方不承担责任，请自行评估风险。

注意事项

示例代码仅作为韩国投资证券 Open API 的参考示例，未经通知可能持续更新。
使用示例代码开发的程序所产生的损失，官方不承担任何责任。
Korean Investment & Securities Open API 需先在官方门户申请后才能调用。

核心亮点

封装了韩国投资证券的认证与REST/WebSocket接口，大幅降低接入门槛
内置MCP支持，可直接对接ChatGPT/Claude等LLM实现自然语言交易
提供大量可运行的示例代码，覆盖行情、交易、自动策略等场景

不足之处

文档以韩文为主，非韩语用户上手成本较高
仅支持韩国投资证券一家券商，适用范围有限

适用场景

个人开发者快速搭建韩国股票自动交易机器人
量化策略研究中使用Python进行数据获取与回测
结合LLM构建基于自然语言的智能投资助手

替代项目

kiwoom-openapi-py、pykis、eBestOpenAPI

项目介绍

open-trading-api 是行业应用领域的开源项目，由 koreainvestment 开发，2022 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,615）位列前 30%，在行业应用分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,559 增加到 1,615，净增 56。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-23。官网为韩国投资证券开放API门户，提供API服务，但具体定价信息未明确，需进一步确认。从国内网络环境看，可直接访问。

它主要面向的使用场景是：个人开发者快速搭建韩国股票自动交易机器人。同类可对比的替代方案包括 kiwoom-openapi-py、pykis、eBestOpenAPI。

上一篇：Raycast-Easydict

下一篇：FinRobot