AI에게 맡기는 주식 자동매매 - Codex와 NH투자증권 API로 투자 에이전트 만들기

🖼️ 인포그래픽

🖼️ 4컷 인포그래픽

💡 한 줄 결론

Codex와 NH투자증권 나무 플러그 API를 연결하면 자연어 상담부터 전략 작성·예약 실행·주문 승인·클라우드 운영까지 이어지는 주식 자동매매 에이전트를 만들 수 있다.

📌 핵심 요점

1. 나무 플러그는 프로그램이 NH투자증권 시스템에서 시세·잔고를 조회하고 주문을 실행할 수 있게 하는 API 서비스입니다.
2. Codex에 준비된 프롬프트를 입력하면 저장소 다운로드, 파이썬 설치, 가상환경 구성, API 연결과 전략 파일 수정을 에이전트가 순서대로 처리한다.
3. 사용자는 Codex와 대화하며 투자 대상·성향·종목군을 정하고, 완성된 전략을 바탕으로 한 시간마다 뉴스와 시장을 확인하는 예약 작업을 만들 수 있다.
4. 모의투자에서는 주문 내역·판단 이유·보유 종목·손익을 대시보드로 확인하고, 충분히 시험한 뒤 실전 계좌로 전환할 수 있다.
5. 실전 주문은 텔레그램에서 3분 안에 사람이 승인해야 전송되지만, 설정된 손절·익절 주문은 승인 없이 실행되며 클라우드 배포를 이용하면 로컬 컴퓨터를 꺼도 운영할 수 있다.

🧩 배경과 문제 정의

• 전통적인 증권 API 개발은 파이썬 설치, 코드 작성과 방대한 가이드 문서 분석이 필요했지만, 영상은 이 과정을 Codex 기반의 자연어 작업으로 대체하려 한다.
• 나무 플러그는 투자 프로그램과 NH투자증권 트레이딩 시스템 사이에서 시세·잔고 조회와 주문을 전달하는 공식 API 창구입니다.
• 목표는 개인별 투자 전략을 작성하고 뉴스와 시장을 주기적으로 확인해 거래하되, 모의투자로 검증하고 실전 주문에는 사람의 승인을 추가하는 것입니다.

🕒 시간순 섹션별 상세정리

1. 자동매매 목표와 나무 플러그 소개

• 영상은 투자 원칙과 뉴스 조회를 바탕으로 거래하고, 보유 종목·손익·주문 내역을 대시보드에서 확인하는 자동매매 시스템을 예고합니다. [00:08]
• 나무 플러그는 NH투자증권이 만든 API 서비스로, 정보 조회와 매매를 프로그램에서 수행할 수 있게 합니다. [00:29]

2. API의 역할과 자동 주문 구조

• UI가 사람이 앱의 버튼과 차트를 이용하는 접점이라면, API는 프로그램이 차트를 조회하고 매수·매도 주문을 요청하는 접점으로 설명됩니다. [02:17]
• 나무 플러그를 투자 전략 프로그램과 연결하면 사람이 직접 버튼을 누르지 않아도 시세·잔고 조회와 자동 주문을 실행할 수 있습니다. [03:08]

3. 지원 환경과 API 신청

• 나무 플러그는 운영체제 제약이 적고 여러 보유 계좌에서 거래할 수 있으며, 공식 가이드·SDK·MCP를 제공한다고 소개됩니다. [03:41]
• 사용자는 사이트에서 QR로 로그인하고 약관에 동의한 뒤 앱 키와 앱 시크릿을 발급받아 외부에 노출되지 않게 보관해야 합니다. [05:07]

4. Codex 프로젝트와 자동 구성 프롬프트

• Codex 앱을 설치하고 계정을 연결한 다음 NH 프로젝트와 작업 폴더를 생성합니다. [06:24]
• 제공된 프롬프트는 예제 저장소 다운로드, 파이썬·가상환경 구성, 키 입력, 투자 상담, 전략 검사와 예약 등록을 순서대로 처리하도록 설계됐습니다. [08:09]

5. 비밀키 연결과 모의투자 시작

• 앱 키와 앱 시크릿이 AI 채팅으로 전달되지 않도록 별도 웹 입력 화면에서 키를 저장하고 연결 상태를 확인합니다. [08:53]
• 처음에는 모의계좌를 선택하며, 연결 완료 메시지를 Codex에 보내면 개인별 투자 상담 단계로 이동합니다. [09:08]

6. 자연어 상담을 통한 전략 작성

• Codex가 투자 성향과 관심 종목을 질문하고, 답변을 바탕으로 국내·미국 시장과 반도체·AI 대형주 중심의 전략 후보를 작성합니다. [09:54]
• 사용자가 자연어로 전략을 수정하거나 그대로 진행하면 Codex가 전략 파일을 갱신하고 자동매매 준비를 완료합니다. [10:19]

7. 시간 단위 예약과 모의매매 대시보드

• Codex 예약 기능은 한 시간마다 전략과 최신 뉴스를 확인해 매수·매도 여부를 판단하며, 장이 닫혀 있으면 거래하지 않습니다. [11:35]
• 실행 결과에는 주문 종목과 판단 이유가 기록되고, 대시보드에서 보유 종목·손익과 시간대별 거래 내역을 확인할 수 있습니다. [12:24]

8. 실전 전략 재설정과 텔레그램 준비

• 채팅에 실전 투자라고 입력하면 모의 전략을 유지하거나 실제 자금 상황에 맞춰 국내·미국·프리·애프터마켓 전략을 다시 상담할 수 있습니다. [13:16]
• 실전 자동주문에는 텔레그램 알림과 사람의 승인을 결합하며, BotFather에서 봇을 만들고 토큰을 발급받아 연결합니다. [15:22]

9. 인간 승인 기반 실전 주문

• 실제 계좌로 전환하면 주문마다 텔레그램 알림이 오고, 사람이 3분 안에 승인하지 않으면 주문이 취소됩니다. [15:49]
• 일반 주문은 명시적 승인 후 전송되지만 사전에 정한 손절·익절은 승인 없이 실행되며, 이후 대시보드에서 판단 이유와 보유 현황을 볼 수 있습니다. [16:45]

10. 클라우드를 이용한 상시 운영

• 로컬 예약은 Codex가 설치된 컴퓨터가 켜져 있어야 하므로, 상시 실행 장비가 없다면 DigitalOcean의 원격 클라우드 컴퓨터를 이용할 수 있습니다. [17:35]
• 플러그인으로 원격 SSH 호스트와 Codex를 연결하고 클라우드 프로젝트에 같은 설정을 적용하면 로컬 컴퓨터를 꺼도 자동매매가 실행됩니다. [19:50]

11. 프로모션 안내와 최종 권고

• 영상은 국내주식 수수료 혜택, 신규 고객 수수료 무료 기간, ChatGPT Plus 이용권과 굿즈 이벤트를 소개하며 정확한 조건은 공식 이벤트 페이지에서 확인하라고 안내합니다. [20:43]
• 전체 과정은 예시이므로 사용자가 자신의 전략을 만들고 모의환경에서 충분히 시험한 뒤 실거래에 적용해야 한다고 강조하며 마무리합니다. [21:29]

🧾 결론

• 이 구현의 핵심은 투자 판단을 전부 AI에 위임하는 것이 아니라 API 연결, 전략 자동화, 예약 실행과 사람의 최종 승인을 하나의 흐름으로 묶는 데 있다.
• 자연어 프롬프트가 개발 환경 구성과 전략 파일 수정을 대신하므로 직접 코드를 다루기 어려운 사용자도 자동매매 프로토타입을 구성할 수 있다.
• 실전 적용 전에는 모의환경에서 전략과 주문 흐름을 충분히 시험하고, 실제 투자 상황에 맞춰 전략을 다시 조정해야 한다.
• 상시 운영에는 Codex가 실행되는 컴퓨터가 필요하며, 별도 장비가 없다면 DigitalOcean 같은 유료 클라우드 환경을 사용할 수 있다.

📈 투자·시사 포인트

• 증권사 API와 AI 코딩 에이전트의 결합은 자동매매 개발의 진입장벽을 코드 작성 능력에서 전략 설계와 운영 통제 능력으로 이동시킵니다.
• 뉴스와 사전에 합의한 투자 원칙을 함께 참조하고 판단 이유를 기록하는 구조는 주문 결과를 사후 검토할 수 있게 한다.
• 텔레그램 승인 절차는 실전 주문에 인간을 포함하지만, 손절·익절의 자동 실행과 예약 주기 등 예외 규칙은 별도로 점검해야 한다.
• 영상에 나온 모의계좌의 플러스 손익은 구현 시연 결과일 뿐, 전략의 실전 수익성이나 재현성을 입증하는 자료로 제시되지는 않았습니다.

⚠️ 불확실하거나 확인이 필요한 부분

• 영상은 AI가 제안한 전략의 백테스트 결과, 장기 수익률, 최대 손실폭이나 거래비용을 제시하지 않으므로 실전 성과는 확인되지 않았습니다.
• 앱 키와 앱 시크릿은 계좌 접근에 필요한 비밀정보이므로 채팅창에 입력하거나 외부에 노출하지 말아야 하며, 영상의 입력 웹페이지가 정보를 어떻게 저장·보호하는지는 별도 확인이 필요하다.
• 실전 주문은 3분 이내 텔레그램 승인을 요구하지만, 설정된 손절·익절은 승인 없이 실행되므로 해당 가격과 주문 조건이 의도대로 작성됐는지 검증해야 한다.
• 자막 기반 정리: 타임스탬프가 있는 자막을 기준으로 정리했으며, 고유명사·수치·인용은 원문 확인 필요 시 별도 검증한다.
• 영상 속 주장: 발표자의 해석·전망·비교는 확인된 외부 사실이 아니라 영상 속 주장으로 분리해 읽는다.
• 검증 필요: 수치, 기업 실적, 정책·시장 전망은 발행 전 최신 자료로 별도 검증이 필요하다.

✅ 액션 아이템

• 나무 플러그를 신청하고 앱 키·앱 시크릿을 발급받은 뒤 채팅과 분리된 비공개 위치에 보관한다.
• Codex 프로젝트에서 제공된 프롬프트를 실행하고 처음에는 반드시 모의투자 계좌로 연결한다.
• 투자 대상, 종목군, 매수·매도 기준과 한 시간 단위 실행 주기를 자신의 조건에 맞게 조정한다.
• 모의환경에서 주문 이유, 대시보드 기록, 장 마감 시 동작과 예약 실행 여부를 충분히 확인한다.

❓ 열린 질문

• AI가 뉴스와 투자 원칙을 실제로 어떤 우선순위와 조건식으로 결합해 매수·매도를 결정합니까?
• 네트워크 장애, API 오류, 중복 예약 또는 텔레그램 알림 실패가 발생했을 때 주문 중복과 누락을 어떻게 방지합니까?
• 승인 없이 실행되는 손절·익절 주문의 가격, 수량과 예외 조건을 사용자가 어디까지 통제할 수 있습니까?