Open Trading API

You must have a KIS brokerage account and apply for Open API access at the KIS Developer Portal. After approval, generate your App Key and App Secret for both paper trading (모의투자) and live trading (실전투자) environments.

# Visit: https://apiportal.koreainvestment.com/about-howto

Clone the open-trading-api repository and install Python dependencies using uv. The uv sync command reads pyproject.toml and installs everything in one step.

git clone https://github.com/koreainvestment/open-trading-api
cd open-trading-api

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install project dependencies
uv sync

Edit the kis_devlp.yaml configuration file in the project root. Fill in your App Key, App Secret, account number, and whether you are using paper trading or live trading mode. This file is read by the shared kis_auth.py authentication module.

# Edit kis_devlp.yaml:
# app_key: your-app-key-here
# app_secret: your-app-secret-here
# account_no: your-account-number
# is_paper_trading: true  # set false for live trading

Run the authentication example to verify your credentials and generate an access token. The token is cached and reused for subsequent API calls.

# Using uv
uv run python examples_llm/kis_auth.py

# Or: python examples_llm/kis_auth.py (with venv activated)

Try an LLM-optimized single-function sample to verify end-to-end connectivity. For example, query the current price of a domestic stock.

# Domestic stock price inquiry
uv run python examples_llm/domestic_stock/inquire_price/inquire_price.py

The MCP/ directory contains the KIS Code Assistant and Trading MCP server. Add it to your MCP client configuration to allow an LLM agent to call trading APIs and query market data directly.