나무PLUG 사용후기 — NH투자증권 OpenAPI 서비스로 나만의 투자전략 설정하기 (신청부터 AI 활용까지)

솔직히 저는 그동안 주식투자를 하면서 단기적인 매매를 많이 해왔어요. 특히 어떤 기업에 좋은 뉴스가 나오면 '이거 더 오르는 거 아니야?' 하는 생각에 이미 주가가 급등하고 있는 종목을 뒤늦게 따라 들어갔다가, 막상 제가 매수하고 나면 주가가 꺾이는 경우가 정말 많았는데요.

 

이런 매매가 반복되다 보니 손실도 늘어나고 주식에 쏟는 시간과 에너지도 자연스럽게 많아지더라고요. 그래서 이제는 단기적인 주가 움직임을 따라가기보다 AI 시대를 이끌어갈 주요 기업들을 미리 살펴보고, 장기적인 관점에서 투자하는 전략을 세워보기로 했습니다.

 

그래서 얼마 전 출시된 NH투자증권의 '나무 PLUG'를 활용해 'AI 시대를 대비하는 장기투자 포트폴리오'를 직접 만들어봤습니다. 이번 포스팅에서 그 과정을 기록으로 남겨보려 합니다.

 

---

나무 PLUG 인증키 발급방법

나무 PLUG를 활용하여 서비스를 만들려면 우선 NH투자증권 계좌를 개설한 후 Namuh PLUG 서비스 신청을 진행하고, API 연동에 필요한 APPKEY·APP Secret을 발급받아야 합니다. 이후 Access Token을 발급받으면 API를 활용하여 서비스를 이용할 수 있는데요. Access Token은 ChatGPT나 Claude 같은 AI에게 개발해달라고 위임하면 알아서 발급받아 서비스를 제작합니다.

 

먼저 아래 링크된 나무 PLUG에 접속하셔서 우측 상단의 "Login" 버튼을 클릭하여 로그인을 진행합니다.

https://myip.kr/QvgKR

 

로그인은 스마트폰으로 QR코드를 스캔하는 간단한 방식입니다. 카메라로 QR코드를 스캔하면 나무증권의 인증서 로그인 화면으로 이동합니다. 해당 화면에서 로그인 해주시면 됩니다.

 

로그인이 끝났으면 메인 페이지의 나무 PLUG "신청하기" 버튼을 클릭해서 API 사용 신청을 진행해 주세요.

 

이용약관의 필수 사항들을 동의하고 스크롤을 내려 하단에 있는 "신청하기" 버튼을 클릭해 주시면 됩니다.

 

마지막으로 API 사용신청에서 "예"를 누르고 QR인증을 완료하시면 API 사용 신청이 완료됩니다.

 

사용 신청 내역 확인 페이지로 이동하면, 스크롤을 밑으로 내려보시면 "보안인증키 확인"이라는 버튼이 있어요. 이 버튼을 클릭하셔서 발급받은 API키를 확인해주시면 됩니다.

 

복사 버튼을 누르셔서 위의 APP KEY와 APP Secret을 복사해둔 뒤 클로드 같은 AI에게 알려주면 됩니다.

 

---

나무 PLUG를 활용하여 나만의 투자 전략 만들어보기 (Feat. 클로드코드)

'이제 어떻게 개발해야하지?' 예전에는 이런 걱정들이 정말 많았을 것 같은데요. 이전에는 API 문서를 처음부터 끝까지 읽어가며 하나하나 만들어야 했겠지만 요즘은 그렇게 걱정할 필요가 없어요. 이 과정 자체를 AI에게 맡길 수 있거든요.

 

다만 저는 AI에게 단순히 "아무 종목이나 추천해줘"라고 맡기고 싶지는 않았습니다. 그동안 투자하면서 생겼던 문제 중 하나가 결국 '느낌으로 판단'했다는 것이었기 때문에, 이번에는 최근 3년 주가 흐름, 수익률, 변동성, 현재 주가 수준, 산업/테마 종목별 목표 비중, 총 투자금 대비 집행률 등을 고려하여 종목을 선정하고 AI가 이 종목을 선택한 이유를 구체적으로 알려달라고 했습니다.

 

결론적으로 제가 주로 사용하고 있는 AI 클로드코드에게 아래와 같은 스크립트를 전달해주고 만들어달라고 했는데요. AI의 확률적 특성으로 인해 아래의 스크립트를 그대로 입력하더라도 실행 결과나 만들어지는 프로그램의 형태가 달라질 수 있다는 점은 참고 부탁드립니다.

 

NH투자증권의 '나무 PLUG'를 활용해서 'AI 시대를 대비하는 장기투자 포트폴리오'를 직접 만들어보려고 해.

# 참고 자료
아래 세 페이지를 먼저 조사해서 인증 방식과 필요한 엔드포인트를 파악해줘.
- 공식 소개 사이트: https://www.nhplug.com/intro
- API 가이드 문서: https://www.nhplug.com/apiservice-category
- 테스트베드 콘솔: https://www.nhplug.com/testbed-console
상세 스펙(엔드포인트, 파라미터명 등)이 있으면 GitHub(PLUG-OpenAPI) 같은 공개 저장소나
API 문서 파일(openapi.json 등)도 같이 확인해줘.

# 하고 싶은 것
1. 위 자료들을 학습해서 인증(접근토큰 발급) → 시세 조회 → 포트폴리오 계산까지 되는 구조를 설계해줘.
2. 실제 매수/매도 주문은 실행하지 말고, "포트폴리오 설계 + 리포트 생성"까지만 해줘.
3. 투자 대상은 국내 5종목 + 해외(미국) 5종목, 총 10종목.
4. 종목 고를 때 "그냥 AI 테마니까"로 대충 넣지 말고, 장기 성장 가능성, 최근 3년 주가 흐름,
   수익률, 변동성, 현재 주가 수준, 산업/테마 종목별 목표 비중, 총 투자금 대비 집행률을
   고려하여 지금 가격이 부담스러운 수준은 아닌지, 그리고 특정 종목에 비중이 쏠리지
   않는지까지 같이 따져서 골라줘. 자동매매·단기 트레이딩용이 아니라 오래 들고 갈
   장기투자 목적이야.
5. 종목마다 왜 골랐는지 이유(어떤 AI 관련 테마인지)를 표에 같이 적어줘.
6. 총 투자 예산은 1,000만원이고, 10종목에 동일가중(종목당 100만원), 차등가중(비중을
   조정해 좀 더 적극적으로 담는 방식) 2가지로 배분해서 보여줘. 해외 종목은 환율까지
   반영한 원화 환산 기준으로 계산해줘.
7. 계산 결과(종목별 현재가, 매수 가능 수량, 투자금액, 잔액, 집행률 등)를 한눈에 보기
   좋은 형태로 정리해줘. 가능하면 웹 대시보드(HTML)로도 보여줘.
8. 그 외에 이 포트폴리오를 더 잘 만들 수 있는 방법이 있다면 (예: 리밸런싱 기준, 분산
   로직, 추가로 고려하면 좋을 테마 등) 자유롭게 제안해줘.

# 지켜야 할 것
- APP_KEY / APP_SECRET은 코드에 직접 쓰지 말고 환경변수(.env)로 분리해줘.
- 실제 주문 실행 코드는 만들지 마.
- 모의투자로 먼저 검증 가능한 구조면 더 좋아.

내 APP KEY / APP Secret은 이거야:

APP_KEY: (여기에 본인 값 붙여넣기)
APP_SECRET: (여기에 본인 값 붙여넣기)

 

위 과정을 직접 따라해보고 싶으시다면

1. 먼저 컴퓨터에 Node.js가 설치되어 있어야 합니다 (터미널에 node --version을 입력했을 때 18 이상 버전이 나오면 됩니다. 없다면 nodejs.org에서 먼저 설치해주세요).
2. 터미널을 열고 npm install -g @anthropic-ai/claude-code를 입력해서 클로드코드를 설치합니다.
3. 아무 폴더에서나 claude라고 입력해서 실행하면, 처음 한 번은 브라우저가 열리면서 Anthropic 계정으로 로그인하는 절차를 안내해줍니다. 로그인만 해두면 다음부터는 다시 로그인할 필요 없이 바로 실행됩니다.
4. 로그인이 끝나면 터미널에 프롬프트 입력창이 뜨는데, 여기에 위 스크립트를 그대로(APP_KEY/APP_SECRET은 발급받은 값으로 바꿔서) 붙여넣고 엔터를 누르면 됩니다.

터미널이 낯설다면 어렵게 느껴질 수 있지만, 사실 "복사해서 붙여넣고 엔터"만 하면 되는 정도라 크게 걱정하지 않으셔도 됩니다.

 

결과적으로 AI가 필요한 토큰도 직접 발급받고, 사용 방법까지 파악해서 실제로 동작하는 프로그램을 만들어주었습니다. 이렇게 Token이 발급되었다는 문자를 직접 받아보니, '생각보다 AI가 잘하고 있구나'라는 생각이 들더군요.

 

처음에는 NH PLUG에 대한 정보가 많지 않아서 과연 AI가 제대로 이해하고 프로그램까지 개발해줄 수 있을까 하는 걱정도 있었습니다. 하지만 직접 사용해보니 예상했던 것보다 훨씬 빠르게 내용을 이해하고, 필요한 부분을 찾아가면서 프로그램을 만들어주더라고요.

 

참고로 어떤 방식으로 AI가 프로그램을 개발했는지 궁금하시다면, AI가 함께 만들어준 README.md 파일을 열어보시면 됩니다. README에는 프로그램의 구성과 사용 방법뿐만 아니라, AI가 NH PLUG를 어떤 기준으로 활용해서 프로그램을 만들었는지도 확인할 수 있습니다.

 

계획대로, 국내 5종목 + 해외(미국) 5종목 총 10종목에 1,000만원을 동일배분, 차등배분으로 포트폴리오를 구성하는 프로젝트가 만들어졌습니다.

 

그리고 왜 이 10종목을 선택했는지에 대한 상세 내용도 만들어줬습니다. 이밖에도 데이터가 오는 경로, 이 다음에 할 일 같은 것을 추가로 만들었습니다. 궁금하시다면 아래 html 파일을 다운받아서 직접 확인해보시면 될 것 같아요.

dashboard.html

0.05MB

 

Before / After

이렇게 오늘은 NH PLUG를 활용해서 간단한 주식 포트폴리오를 만드는 프로그램을 만들어봤는데요. 신기했던 건, 제가 API 문서를 하나하나 다 읽지 않아도 "이런 전략을 짜고 싶다"고 말하니 AI가 알아서 사이트를 조사하고, 필요한 조건을 되묻고, 코드를 작성하고, 심지어 설계의 허점까지 먼저 짚어서 대안을 제시해줬다는 점입니다. 코딩을 몰라도 시작할 수 있다는 말이 실제로 체감됐던 부분입니다.

 

특히 제가 생각했던 투자 기준을 AI와 대화하면서 하나씩 구체적인 조건으로 바꿔나가다 보니, 저 역시 "나는 어떤 기준으로 투자하고 있었지?"라는 질문을 다시 생각해보게 됐습니다. 결국 이번에 느낀 NH PLUG의 가장 큰 장점은 단순히 주식 데이터를 조회하거나 주문할 수 있다는 것보다, 내가 생각하는 투자전략을 데이터와 연결하고 나만의 투자환경으로 만들어볼 수 있다는 점이 아닐까 싶습니다.

 

참고로 이 표는 특정 시점 시세를 기준으로 계산된 스냅샷이고, 종목 구성이나 배분 비중은 제가 정한 조건과 예시일 뿐 매수 추천은 아닙니다. 실전 반영 전에는 모의투자로 먼저 충분히 검증해보시길 권합니다. 투자 판단과 그 결과에 대한 책임은 투자자 본인에게 있습니다.

 

https://myip.kr/QvgKR

NAMUH PLUG OpenAPI - NH투자증권

 

- NH투자증권으로부터 경제적 대가를 받고 제작되었음
- 투자자는 금융투자상품<주식>에 대하여 증권사로부터 충분한 설명을 받을 권리가 있으며, 투자전 상품설명서 등을 반드시 읽어보시기 바랍니다.

- 금융투자상품(주식)은 <자산가격 변동>, <환율 변동>, <신용등급 하락> 등에 따라 투자원금의 손실(0~100%)이 발생할 수 있으며, 그 손실은 투자자에게 귀속됩니다.
- 국내주식매매시 수수료 온라인 0.01%~0.50%, 오프라인 0.40%~0.50% (소수점셋째자리 반올림기준, 거래금액별/매체별 상이, KRX, NXT 포함)이며, 기타 수수료에 대한 상세내용은 홈페이지 등을 참고하시기 바랍니다. NXT(넥스트레이드)는 자본시장법상 다자간매매체결회사로 대체거래소(ATS: Alternative Trading System)입니다.
- 해외주식매매시 수수료 및 제비용 발생하며, 상세 내용은 홈페이지 등을 참고하시기 바랍니다. (예시) 미국주식 매매시 수수료 0.25%(온라인 기준) 및 제비용(미국주식 매도시 SEC Fee(0.00206%)) / (예시) 중국주식 매매시 수수료 0.3%(선강퉁/후강퉁 동일, 온라인 기준) 및 제비용(중국 선강퉁/후강퉁 기준, 매수시 Handling Fee 0.00341%, Securities Management Fee 0.002%, Transfer Fee 0.003%, 매도시 Stamp Fee(인지세) 0.05%, 온/오프라인 동일)
NH투자증권 준법감시인 심사필 제2026-1632호(2026-09-21~2026-12-20)