나무증권 자동매매 프로그램 만들기 전 확인할 나무 플러그 API의 앱키·접근토큰·자동 해지 규칙

2026-10-22

나무증권 자동매매 프로그램을 찾으면 영상 두 종류가 섞여 나옵니다. 앱 안에서 조건을 걸어 두는 옛 영상, 그리고 코드나 AI로 증권사 API를 부르는 최근 영상입니다.

두 번째 길의 이름이 나무 플러그입니다.

이 글은 코드를 한 줄도 보여 주지 않습니다. 플러그를 쓰기 전에 알아야 할 구조와 규칙만, NH투자증권이 직접 공개한 안내 문장으로 짚습니다.

1.자동매매 프로그램이 증권사와 이어지는 방식

API: 다른 프로그램이 증권사의 시세 조회, 잔고 확인, 주문 기능을 불러 쓰도록 열어 둔 통로입니다.

자동매매 프로그램은 스스로 판단해 주문을 만들고, 그 주문을 증권사 API로 보냅니다. 판단은 내 PC나 서버에서, 체결은 증권사에서 일어납니다.

앱 안 기능도 있습니다. NH투자증권은 2023년 8월 해외주식 시세포착주문을 내놓았고, 미국·중국·홍콩·일본 주식에 조건을 걸어 최대 30일 감시하게 했습니다(머니투데이 2023-08-01). 다만 국내주식 앱 자동주문의 유효기간은 공식 문서를 찾지 못해 이 글에서는 다루지 않습니다.

2.나무 플러그는 무엇을 열어 주나

NH투자증권은 2026년 8월 10일 REST 방식 오픈 API인 Namuh PLUG와 N2 PLUG를 내놓았습니다(디지털데일리).

REST API: 주소로 요청을 보내고 답을 받는 방식이라, 특정 운영체제의 부품을 깔 필요가 없습니다.

쓸 수 있는 상품과 환경

나무 플러그 소개 페이지는 투자 가능 상품을 국내주식, 해외주식, 국내파생, 해외파생, 채권, 금현물 여섯 가지로 적습니다. 윈도우, 맥, 리눅스 어디서든 쓸 수 있다고 합니다.

같은 페이지의 적용 수수료율은 국내주식 0.01%, 해외주식 0.09%이고, 그 밖의 상품은 나무증권 온라인 매매 수수료를 따릅니다.

키 하나와 하루짜리 토큰

신청 순서는 네 단계입니다.

NH투자증권 계좌를 열고, API 사용신청 페이지에서 약관에 동의하고, 보안 인증키를 받은 뒤, 접근토큰을 발급받아 씁니다(서비스 이용안내).

앱키(APP KEY): 내 프로그램이 누구인지 증권사에 밝히는 열쇠. 앱 시크릿과 짝으로 쓴다.

앱키는 고객번호당 1개가 나오고, 계좌가 여러 개여도 그 1개로 씁니다. 예전에는 계좌마다 인증키를 따로 받아야 했는데, 플러그에서 하나로 합쳤고 미성년·주문대리인·일임 계좌도 같이 묶을 수 있다고 보도됐습니다.

접근토큰은 발급 후 24시간만 유효합니다. 만료되면 앱키와 시크릿으로 다시 받습니다. 하루 넘게 켜 두는 프로그램이라면 토큰 재발급을 코드에 넣어 두어야 멈추지 않습니다.

모의투자 주소는 따로 있다

포털이 안내하는 공식 깃허브 SDK에는 운영 주소(api.nhplug.com)와 모의투자 주소(moapi.nhplug.com)가 따로 적혀 있습니다(nhplug-sdk). 계좌구분 01·02는 실제, 03은 모의입니다.

같은 SDK의 주문 예제는 기본이 드라이런(실제로 내지 않는 시험 실행)이고, 실주문은 설정을 바꿔야 나갑니다. REST 호출은 실측 초당 5회 수준이라 SDK가 기본 4회로 맞춘다고 적혀 있습니다.

이 숫자는 SDK 설명에 적힌 실측값입니다. 포털 공개 화면에서 공식 한도표는 찾지 못했습니다.

AI가 주문을 내는가

나무증권 블로그의 자주 묻는 질문은 AI가 알아서 주문하지 않는다고 답합니다. 주문은 사용자가 만든 매매 프로그램이 직접 넣습니다(나무증권 블로그).

3.놓치기 쉬운 해지 규칙

소개 페이지의 해지 조건은 짧습니다.

3개월 단위로 거래가 없으면 다음 달 첫 영업일에 자동으로 해지됩니다.

모의투자 서버로만 로그인하면 서비스가 자동 해지될 수 있다는 문장도 같은 자리에 있습니다. 시험만 오래 하다 보면 실제 연결이 끊길 수 있다는 뜻입니다. 해지돼도 사용신청을 다시 하면 이어서 쓸 수 있다고 안내합니다.

4.옛 QV Open API와 무엇이 다른가

NH투자증권 홈페이지의 옛 Open API 안내는 C++ 윈도우 32bit DLL을 주고, HTS ID를 등록한 고객만 가입하게 했습니다(NH투자증권 Open API 안내). 대상은 주식·선물·옵션·ELW였습니다.

그 Open API 안의 모의투자는 2023년 5월 31일에 끝났습니다. 한동안 실제 계좌로만 시험할 수 있었던 셈이고, 플러그는 모의투자 주소를 다시 열었습니다.

키움증권 자동매매 프로그램 글과 견주면, 키움은 감시 기능과 API가 세 갈래로 나뉘고 나무증권은 직접 코딩하는 길이 플러그 하나로 모였습니다.

5.한 줄 결론

나무증권 자동매매 프로그램은 지금 나무 플러그로 붙이며, 키 1개·토큰 24시간·3개월 미거래 해지 세 규칙을 먼저 코드에 반영해 둡니다.

히든픽은 픽 주인이 공개하지 않는 배팅 규칙을 서버에 두고, 추천 코드로 받은 사람의 PC에서 그대로 돌려 주는 윈도우 프로그램입니다. 지금은 스테이크(stake.com)의 에볼루션 라이브 바카라에서 돌아갑니다. 증권 API와 같이 로그인과 판단, 실행이 어떻게 나뉘는지는 바카라 자동 배팅 프로그램 안내에 있습니다.

국가대표 픽스터 대모집 중입니다. 국가대표가 되면 12,000달러 상당의 혜택(1년 이용권)을 드립니다. 지원: https://hiddenpick.my/pickster

3시간 무료 체험 시작

← 읽을거리