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 quote 005930 --provider tossinvest
kxt quote 005930 000660 AAPL --provider tossinvest
kxt bars 005930 --provider kis --timeframe day --start 2025-04-01 --end 2025-04-14
kxt bars 005930 --provider tossinvest --timeframe day
kxt bars 005930 --provider kis --timeframe 5m
kxt recent-trades 005930 --provider kis --limit 5
kxt recent-trades 005930 --provider tossinvest --limit 5
kxt orderbook 005930 --provider kis
kxt orderbook 005930 --provider tossinvest
kxt investor-flow 005930 --provider kis

KIS recent-trades는 당일 국내주식 체결만 지원합니다. Toss Invest quote는 최대 200개 심볼 batch 조회를 지원합니다. Toss Invest bars는 provider interval 기준 1m, day를 우선 지원하고, 다분봉은 1분봉을 로컬 집계합니다. investor-flow는 KIS 전용입니다.

Analytics¶

kxt rankings VOLUME --provider kis --limit 10
kxt rankings MARKET_CAP --provider kis --scope KRX
kxt rankings EXPECTED_EXECUTION --provider kis --limit 10
kxt program-trade 005930 --provider kis
kxt program-trade 005930 --provider kis --mode by-stock-daily --start 2025-04-01 --end 2025-04-14
kxt investor-trends 005930 --provider kis
kxt investor-trends 005930 --provider kis --trend estimate
kxt condition-search --provider kis
kxt condition-search --provider kis --seq 001

rankings, program-trade, investor-trends, condition-search는 현재 구현된 분석 CLI입니다. --scope가 있는 명령은 KRX, NXT, TOTAL 중 하나를 받습니다. 조건검색 결과 조회에는 프로바이더 사용자 ID가 필요할 수 있습니다.

Account & orders¶

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

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

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 place-order 005930 --provider tossinvest --side BUY --order-type LIMIT \
  --quantity 1 --limit-price 70000 --account-no 1

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"
}