このプロジェクトについて

このリポジトリは、韓国投資証券 KIS Open API を連携するためのサンプルコードと補助ツールを提供する。examples_user は商品別に統合された関数と実行例を提供し、examples_llm は単一 API 機能別に最小呼び出しファイルと検証ファイルを分離し、LLM コードエージェントが探索しやすく構成していると明記している。共通の kis_auth.py は、アクセストークンの発行および管理、本番/模擬環境の切り替え、共通 API 呼び出し、WebSocket 接続設定を扱う。 扱う API カテゴリは、認証、国内株式、国内債券、国内先物オプション、海外株式、海外先物オプション、ELW、ETF/ETN である。REST の例とともに、WebSocket を通じたリアルタイム気配値の購読例もある。利用するには KIS Open API の申請後、アプリキー、アプリシークレット、HTS ID、口座番号を kis_devlp.yaml に設定する必要があり、Python 3.11 以上と uv の使用を推奨する。 追加ツールとして、strategy_builder はビジュアル UI で売買戦略を設計し、BUY/SELL/HOLD シグナルを生成するほか、80 種類のテクニカル指標と 10 種類のプリセット戦略をサポートする。backtester は Docker ベースの QuantConnect Lean による過去データ検証、パラメータ最適化、HTML レポートを提供し、戦略は .kis.yaml 形式で共有される。MCP ディレクトリは、KIS Code Assistant と Trading MCP を通じた AI ツール接続を扱う。戦略ツールの使用には Node.js 18+ と Docker Desktop が必要になる場合がある。 提供元はサンプルコードを参考用として案内しており、コードは予告なく更新される可能性があり、これを活用したプログラムによる損害については責任を負わないと明記している。