KIS 주식 트레이딩

한국투자증권 Open API를 통한 국내 주식 매매 스킬.

使用KIS（韩国投资证券）Open API进行韩国股票交易技能。支持余额查询、实时行情、买卖订单、交易历史以及KRX（KOSPI/KOSDAQ）上市股票的市场概览。

设置

在config文件（~/.kis-trading/config.ini）中设置以下值：

ini
[KIS]
APPKEY = yourapp_key
APPSECRET = yourapp_secret
ACCOUNT_NO = 12345678-01
BASE_URL = https://openapi.koreainvestment.com:9443

模拟交易：https://openapivts.koreainvestment.com:29443

确认设置：

bash
python3 scripts/setup.py --config ~/.kis-trading/config.ini --check

余额查询

显示余额、账户余额、预付款、可买入金额

bash
python3 scripts/balance.py --config ~/.kis-trading/config.ini

持有股票

持有股票、我的股票、收益率

bash
python3 scripts/holdings.py --config ~/.kis-trading/config.ini

股票行情

三星电子当前价、005930行情、Kakao股价

bash
python3 scripts/quote.py --config ~/.kis-trading/config.ini --code 005930
python3 scripts/quote.py --config ~/.kis-trading/config.ini --name 삼성전자

买入/卖出订单

买入三星电子10股、卖出Kakao5股

⚠️ 订单必须在获得用户确认后执行！

bash

市价买入

python3 scripts/order.py --config ~/.kis-trading/config.ini --side buy --code 005930 --qty 10 --market

限价买入

python3 scripts/order.py --config ~/.kis-trading/config.ini --side buy --code 005930 --qty 10 --price 70000

卖出

python3 scripts/order.py --config ~/.kis-trading/config.ini --side sell --code 005930 --qty 10 --market

下单前必须：

1. 1. 向用户显示股票名称、数量和价格并请求确认
2. 可使用--dry-run预先确认订单内容
3. 确认后执行实际订单

交易记录

交易记录、今日成交记录、订单记录

bash
python3 scripts/history.py --config ~/.kis-trading/config.ini
python3 scripts/history.py --config ~/.kis-trading/config.ini --start 20240101 --end 20240131

市场概览

市场概览、成交量排名、KOSPI指数

bash
python3 scripts/market.py --config ~/.kis-trading/config.ini --action index
python3 scripts/market.py --config ~/.kis-trading/config.ini --action volume-rank

注意事项

• - 实盘投资时务必将BASE_URL设置为实盘URL
• 模拟交易和实盘交易的TR ID可能不同
• API调用限制为每秒20次（自动控制）
• 绝对不要在未经用户确认的情况下执行订单