키움증권 주식 자동매매 설정 방법 (국내·미국 주식, 트레이딩뷰 연동)

트레이딩뷰에서 만든 지표·전략의 신호로 키움증권 계좌의 국내·미국 주식을 자동매매하는 방법입니다.
키움증권은 모의투자 계좌도 지원해서, 실제 돈을 넣기 전에 국내 주식으로 먼저 연습해 볼 수 있습니다.

키움증권에서 할 수 있는 것

설정 순서

1. REST API 신청: PC에서 키움 REST API 사이트에 로그인해 [API 사용신청] 을 하고, [계좌 App Key 관리] 에서 ① IP 등록 → ② 계좌 등록 → ③ App Key·App Secret 다운로드 순서로 진행합니다. 허용 IP에는 확장프로그램 API키 등록화면에 표시된 IP주소를 넣어 주세요.

   

   화면 출처: 키움 REST API (개인정보와 IP는 가림 처리) · 번호별 자세한 설명은 거래소 API 발급 방법의 키움증권 항목에 있습니다.
2. API키 등록: 확장프로그램 API키 등록 화면의 KIWOOM 줄(모의투자는 KIWOOM-Testnet 줄)에서 계정명 칸에 키움 계좌번호, App Key, App Secret 순으로 입력하고 [연결중] 을 확인합니다.
3. 종목 선택: API키를 등록하면 메시지 작성화면에서 종목을 고를 수 있습니다.
4. 주문메시지 작성 → 얼러트 설정: 메시지를 만들어 트레이딩뷰 얼러트에 웹훅 URL과 함께 넣습니다. → 웹훅URL에 의한 자동매매

주문메시지 예시

삼성전자 10주 시장가 매수

TVM:{"exchange":"kiwoom","account":"계좌번호","symbol":"005930/KOSPI","type":"market","side":"buy","amount":10,"token":"인증키"}:MVT

테슬라 보유 수량의 50%를 시장가 매도 (미국 주식)

TVM:{"exchange":"kiwoom","account":"계좌번호","symbol":"TSLA/NASD","type":"market","side":"sell","bal_pct":50,"token":"인증키"}:MVT

모의투자 계좌에서 카카오 5주 지정가 매수 (마지막 체결가)

TVM:{"exchange":"kiwoom-testnet","account":"계좌번호","symbol":"035720/KOSPI","type":"limit","side":"buy","amount":5,"price":"last","token":"인증키"}:MVT

종목은 종목코드/시장 형식입니다. 예시는 형식을 보여 드리기 위한 것이니, 실제 메시지는 반드시 메시지 작성화면에서 만들어 주세요. 각 항목의 뜻은 주문메시지 항목 설명에 있습니다.

주의사항

• 실전투자와 모의투자는 App Key가 서로 다릅니다. 실전 키는 KIWOOM 줄에, 모의투자 키는 KIWOOM-Testnet 줄에 등록해 주세요.
• 모의투자는 국내 주식만 지원합니다. 미국 주식은 실전 계좌에서만 주문할 수 있습니다.
• App Key와 App Secret은 1회만 다운로드할 수 있고 이후 비활성화됩니다. 잃어버리면 키움 REST API 사이트의 [갱신]으로 다시 발급해 등록해 주세요.
• REST API 신청은 PC에서만 할 수 있습니다.
• 주문은 해당 시장의 거래 시간에만 체결됩니다. 장이 열리지 않은 시간의 얼러트는 주문되지 않을 수 있습니다.

자주 묻는 질문

Q. 한국투자증권과 무엇이 다른가요?
둘 다 국내·미국 주식을 지원합니다. 키움증권은 미국 주식도 시장가 주문이 가능하고 모의투자 계좌(국내 주식) 로 연습할 수 있다는 점이 다릅니다. 한국투자증권 설정은 한국투자증권 자동매매를 참고해 주세요.

Q. 키움 자동매매를 하려면 코딩을 할 줄 알아야 하나요?
아니요. 트레이딩뷰에서 지표나 전략으로 얼러트를 만들고, TVExtBot 확장프로그램에서 주문메시지를 만들어 붙여넣기만 하면 됩니다. 키움 REST API를 직접 프로그래밍할 필요가 없습니다.

Q. 키움 영웅문(HTS)을 켜 두어야 하나요?
아니요. TVExtBot은 키움 REST API로 주문하고 클라우드 서버에서 처리하므로, 영웅문이나 컴퓨터를 켜 둘 필요가 없습니다.

Q. 주식 투자에도 파인스크립트 전략을 쓸 수 있나요?
네. 전략 만드는 방법은 파인스크립트 강좌에서 예제와 함께 설명합니다.