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 種預設交易策略（如黃金交叉、動能、均值回歸），可快速上手。