CLI¶

kxt CLI는 라이브러리와 동일한 공개 메서드를 얇게 감싼 커맨드라인 래퍼입니다. 실제 네트워크 호출 경로는 라이브러리와 같습니다.

기본 출력은 사람과 LLM 모두 읽기 쉬운 구조화된 plain-text 포맷입니다. 원시 JSON이 필요하면 전역 --json 플래그를 사용하세요.

Verify installation¶

kxt --help
kxt doctor

kxt doctor는 자격증명 환경변수 상태를 점검합니다.

Global flags¶

--json : 구조화 plain-text 대신 원시 JSON을 출력합니다.
--debug : 예상치 못한 내부 오류에 대해 Python traceback을 보여줍니다.

두 플래그 모두 서브커맨드 앞, 즉 kxt 바로 뒤에 씁니다 (예: kxt --json quote 005930).

Authentication¶

CLI는 시크릿을 플래그로 받지 않습니다. 반드시 환경변수를 사용하세요 (Authentication 참조).

General commands¶

kxt capabilities                               # 지원 메서드 매트릭스
kxt doctor                                     # 자격증명/환경 점검

Market data¶

kxt quote 005930 --provider kis
kxt bars 005930 --provider kis --timeframe day --start 2025-04-01 --end 2025-04-14
kxt bars 005930 --provider kis --timeframe 5m
kxt recent-trades 005930 --provider kis --limit 5
kxt orderbook 005930 --provider kis
kxt investor-flow 005930 --provider kis

recent-trades는 당일 국내주식 체결만 지원합니다. investor-flow는 장 마감 이후 공개되는 정규장 집계입니다.

Account & orders¶

계좌번호(CANO)와 상품코드가 필요합니다. KIS_ACCOUNT_NO, KIS_ACCOUNT_PRODUCT_CODE 환경변수로도 넣을 수 있고, 플래그가 우선합니다.

kxt balance         --account-no 12345678 --account-product-code 01
kxt positions       --account-no 12345678 --account-product-code 01
kxt buying-power 005930 --price 70000 \
                    --account-no 12345678 --account-product-code 01
kxt open-orders     --account-no 12345678 --account-product-code 01
kxt order-history   --start 2025-01-01 --end 2025-01-31 \
                    --account-no 12345678 --account-product-code 01

plain-text 출력에서 계좌번호는 마지막 4자리만 노출됩니다(예: ****6789). 전체 계좌번호가 필요하다면 --json을 사용하세요.

Orders¶

kxt place-order 005930 --side BUY --order-type LIMIT \
  --quantity 1 --limit-price 70000 \
  --account-no 12345678 --account-product-code 01

kxt cancel-order --order-id 0000000123 --origin-org-no 01234 \
  --account-no 12345678 --account-product-code 01

kxt modify-order --order-id 0000000123 --origin-org-no 01234 \
  --quantity 1 --limit-price 70500 \
  --account-no 12345678 --account-product-code 01

Output format¶

기본(plain-text) kxt quote 005930 예:

occurred_at    : 2025-04-14T00:00:00+00:00
last           : 71000
open           : 70900
high           : 71400
low            : 70500
previous_close : 70900
change         : 100
change_rate    : 0.14
volume         : 10203040

JSON 모드 (kxt --json quote 005930):

{
  "occurred_at": "2025-04-14T00:00:00+00:00",
  "last": "71000",
  "open": "70900",
  "high": "71400",
  "low": "70500",
  "previous_close": "70900",
  "change": "100",
  "change_rate": "0.14",
  "volume": "10203040"
}