Exchange API Setup

거래소 API 발급 가이드

MOAHook이 사용자의 TradingView 알림을 거래소 API로 전달하려면 거래소에서 직접 API 키를 발급해야 합니다.

이 문서는 캡쳐를 보며 따라 하는 순서대로 구성했고, 각 단계마다 왜 그 설정을 고르는지 함께 설명합니다.

모바일에서 보는 경우

거래소 상세 화면에서 PC와 모바일 캡쳐를 전환할 수 있습니다. 모바일 캡쳐가 있는 거래소는 모바일에서 먼저 열리고, 아직 모바일 캡쳐가 없는 거래소는 PC 화면으로 안내합니다.

API 보안 설정 기준

64.176.225.121

IP 제한을 지원하는 거래소는 이 IP만 허용하고, 출금 권한은 절대 켜지 않습니다. 한투는 키 환경과 HTS ID를 정확히 맞춥니다.

IP 제한 또는 환경 검증

IP 제한을 지원하는 거래소는 허용 IP를 64.176.225.121로 제한하고, 한투는 모의/실전 환경과 HTS ID를 검증합니다.

출금 권한 금지

Withdraw, Transfer, Sub-account Manage 등 자산 이동 권한은 켜지 않습니다.

발급 직후 바로 등록

Secret Key는 다시 볼 수 없는 경우가 많으므로 발급 직후 모아봇 설정에 등록합니다.

전체 바이낸스 바이비트 비트겟 오케이엑스 업비트 빗썸 한국투자증권

한국투자증권

한국투자증권 API 키 발급

아래 화면 순서대로 키를 만든 뒤 모아봇 대시보드의 설정 - API 탭에 입력합니다. 거래소 화면이 조금 달라도 API Management, API keys, API and connections 메뉴명을 기준으로 찾으면 됩니다.

이 페이지는 PC와 모바일 캡쳐를 전환해 볼 수 있습니다. PC에서는 PC 화면이 먼저 열리고, 모바일에서는 모바일 캡쳐가 있는 거래소만 모바일 화면이 먼저 열립니다.

모아봇에 입력할 값

App KeyApp SecretAccount NumberAccount Product CodeHTS IDPaper/Real

최소 주문 기준

권장 설정

한투 Open API 앱 발급
국내주식 현금 주문 가능 계좌
계좌상품코드: 입력하지 않으면 01로 처리
체결통보 웹소켓용 HTS ID
모의투자와 실전투자 환경을 키와 동일하게 선택

주의사항

한투는 모의투자와 실전투자 App Key/App Secret이 분리됩니다. 모아봇의 투자 환경 토글과 키 환경이 다르면 검증 또는 주문이 실패합니다.
HTS ID가 잘못되면 체결통보 웹소켓 구독이 거부됩니다. 이 경우 주문 실행 전에 실패로 막고 로그에 남깁니다.
v1은 국내주식 현금 주문을 기준으로 지원합니다.
국내주식은 고정 최소 주문금액이 아니라 최소 1주 단위입니다. 금액 모드에서 현재가 기준 1주 미만이면 0주로 계산되어 주문이 실패합니다.
한투 access token과 websocket approval key는 모아봇 서버가 자동으로 발급/갱신합니다. 사용자가 별도로 토큰을 발급해 입력하지 않습니다.

Capture View

PC 웹 화면으로 따라 하기

PC 브라우저에서 거래소 API 관리 화면을 열고 발급하는 기준 흐름입니다. 화면이 넓어 권한과 IP 제한을 한 번에 확인하기 좋습니다.

PC에서는 PC 화면이 먼저 열리고, 모바일에서는 모바일 캡쳐가 있는 거래소만 모바일 화면이 먼저 열립니다. 이 거래소는 현재 모바일 캡쳐가 없어 PC 화면으로 안내합니다.

01한국투자증권 · PC 웹

한투 Open API 포털 로그인 / 신규 ID 신청

이 화면에서 할 일

한국투자증권 Open API 포털에 접속해 본인의 한투 계정으로 로그인합니다. Open API 전용 ID가 아직 없다면 이용할 아이디와 비밀번호를 입력해 신규 ID를 신청합니다.

체크 포인트

실전 주문용이면 실전투자 앱을, 테스트용이면 모의투자 앱을 사용합니다.
기존 앱을 재사용할 때도 App Key와 App Secret이 현재 투자 환경과 맞는지 확인합니다.
한투 계정 ID와 Open API 신청 ID는 다를 수 있습니다.

다음 단계: API 신청 화면 진입 → 휴대폰 인증

한국투자증권 PC 웹 API 발급 1단계: 한투 Open API 포털 로그인 / 신규 ID 신청 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

02한국투자증권 · PC 웹

API 신청 화면 진입 → 휴대폰 인증

이 화면에서 할 일

로그인 후 API 신청 메뉴로 진입해 휴대폰 본인 인증을 진행합니다. 통신사 동의 → 인증번호 입력 순서대로 진행합니다.

체크 포인트

본인의 통신사를 선택한 뒤 약관에 동의하고 확인을 누릅니다.
인증번호 요청 → 문자로 받은 6자리 인증번호 입력 → 다음 클릭.
인증번호는 통상 3~5분 내 만료되니 도착 즉시 입력하세요.

다음 단계: 실전투자 계좌 선택 + 계좌 비밀번호 인증

한국투자증권 PC 웹 API 발급 2단계: API 신청 화면 진입 → 휴대폰 인증 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

03한국투자증권 · PC 웹

실전투자 계좌 선택 + 계좌 비밀번호 인증

이 화면에서 할 일

필수 약관 항목에 체크한 후, "실전투자계좌"를 체크하고 본인의 계좌를 선택해 계좌 비밀번호를 입력하고 인증합니다.

체크 포인트

계좌번호의 계좌상품코드(예: 01) 앞 번호까지만 입력합니다.
계좌상품코드를 입력하지 않으면 모아봇은 01로 처리합니다.
가급적 계좌상품코드가 01로 시작하는 계좌를 선택하세요. (국내주식 일반)
실제 주문 계좌와 API 앱이 연결된 계정이 일치해야 합니다.

다음 단계: 신청 + PC 공동인증서 인증

한국투자증권 PC 웹 API 발급 3단계: 실전투자 계좌 선택 + 계좌 비밀번호 인증 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

04한국투자증권 · PC 웹

신청 + PC 공동인증서 인증

이 화면에서 할 일

"신청"을 누르면 본인 인증 단계로 진입합니다. 한투 Open API는 **HTS 기반**이므로 MTS(스마트폰) 인증이 아니라 PC 공동인증서로 인증해야 합니다.

체크 포인트

스마트폰 인증은 MTS 한정이라 Open API 발급에는 사용할 수 없습니다.
PC에 등록된 공동인증서로 인증을 완료해야 신청이 마무리됩니다.
인증서가 없다면 한투 HTS에서 발급/등록을 먼저 진행하세요.

※ MTS가 아닌 HTS 인증 — PC 공동인증서로만 신청이 완료됩니다.

다음 단계: App Key / App Secret 확인 후 복사

한국투자증권 PC 웹 API 발급 4단계: 신청 + PC 공동인증서 인증 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

05한국투자증권 · PC 웹

App Key / App Secret 확인 후 복사

이 화면에서 할 일

발급된 App Key와 App Secret을 각각 복사합니다. 모아봇 설정의 한투 항목에 입력할 값입니다.

체크 포인트

App Secret은 공개 채팅이나 메모에 남기지 않습니다.
모의투자 키와 실전투자 키를 섞어 저장하지 않습니다.
모아봇에는 한투 access token을 입력하지 않습니다 — 서버가 자동 발급합니다.

다음 단계: 모아봇 한투 설정 등록 + 텔레그램 인증

한국투자증권 PC 웹 API 발급 5단계: App Key / App Secret 확인 후 복사 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

06한국투자증권 · PC 웹

모아봇 한투 설정 등록 + 텔레그램 인증

이 화면에서 할 일

MOAHook 대시보드 우측 상단의 톱니바퀴 → API 탭에서 한국투자증권을 선택하고 복사한 App Key, App Secret, 계좌번호(계좌상품코드 앞 번호까지), HTS ID, 투자 환경(실전 또는 모의)을 입력합니다. 실전투자를 선택한 뒤 "텔레그램 인증요청"을 누르고, 텔레그램으로 받은 인증번호를 입력해 저장합니다.

체크 포인트

신규 저장 기본값은 모의투자입니다. 실전투자를 사용할 때만 토글을 변경하세요.
HTS ID는 계좌번호와 다릅니다. 값이 틀리면 체결통보 웹소켓이 거부됩니다.
계좌번호는 하이픈 없이 숫자만 입력해도 됩니다.
저장 시 키 검증과 체결통보 준비 여부가 함께 확인됩니다.

다음 단계: TradingView 웹훅 값 확인

한국투자증권 PC 웹 API 발급 6단계: 모아봇 한투 설정 등록 + 텔레그램 인증 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

07한국투자증권 · PC 웹

TradingView 웹훅 값 확인

이 화면에서 할 일

TradingView 알림 값은 기본 전략/인디케이터 예시를 그대로 사용합니다.

체크 포인트

종목코드는 차트의 {{ticker}} 값을 그대로 사용합니다.
전략 알림의 수량은 {{strategy.order.contracts}} 값을 사용합니다.
KRX/NASDAQ/CME 등 실시간 데이터를 트레이딩뷰에서 별도 구매해야 신호가 지연되지 않습니다.

한국투자증권 PC 웹 API 발급 7단계: TradingView 웹훅 값 확인 — 캡쳐 화면에서 단계 제목과 같은 메뉴 또는 입력칸을 찾은 뒤, 왼쪽 설명의 체크 포인트를 순서대로 확인하세요.

Next Step

발급한 키를 모아봇에 등록합니다

모아봇 대시보드에서 설정을 열고 API 탭을 선택한 뒤, 거래소별 API Key, Secret Key, Passphrase 또는 한투 계좌/HTS 값을 입력합니다. 저장 전 텔레그램 인증이 필요할 수 있습니다.

MOAHook 대시보드로 이동