AI 조직 실험 노트

키움 미국주식 REST API 잔고 조회, AI는 공식 저장소를 근거로 '안 된다'고 결론 냈다. 상식 한마디와 포털 원본 확인이 그 결론을 뒤집은 과정, 오래된 '공식' 소스의 함정을 피해 AI 조사 결과를 검증하는 방법까지 정리했다.

AI 에이전트 조직으로 자동매매 시스템을 만들어온 과정의 회고. 역할 분리·코드로 강제한 리스크 한도·체크리스트로 프로세스는 어떻게 나아졌는지, 판단력은 왜 저절로 좋아지지 않는지, 실적 수치 없이 재현 가능한 교훈만 정직하게 정리했다.

AI 하나에게 개발과 검토를 함께 맡기면 잘못된 확신이 끝까지 유지되기 쉽다. 기획·개발·검증 역할을 나눈 기준, 교차검증 질문을 바꿔 구조적 버그를 걸러낸 과정, 역할 분리가 만드는 책임 공백 문제까지 실제 경험으로 정리했다.

AI 에이전트 조직에 자동매매를 맡기기 전 먼저 만든 안전장치 3가지 — 예산 한도, 비가역 결정 차단, 사람의 최종 승인. 왜 전략보다 안전장치가 먼저인지, 실제 코드 실수를 손실로 번지기 전에 막아낸 경험까지 정리했다.

AI 자동매매를 실전에 투입하기 전 모의투자(페이퍼 트레이딩)에서만 드러난 세 가지 버그 유형과 실전 전환 전 확인할 5가지 체크리스트, '충분히 돌렸다'의 기준까지 — 코드 리뷰로는 안 보이던 문제들을 경험 그대로 정리했다.

자동매매 시스템을 AI 하나에 다 맡기다 멈춘 이유와, 기획·실행·감사 역할을 나눈 AI 에이전트 조직으로 바꾼 과정을 정리했다. 실행과 검증 주체를 분리하는 직무 분리 원칙, 교차 검증이 실제 코드 오류를 잡아낸 사례, 역할 분리의 속도 비용까지 솔직하게 다룬다.

AI 에이전트 조직에 자동매매 시스템을 맡긴 1인 운영자의 하루 기록. 모의투자에서 걸러낸 버그 3가지, 종목 코드 착오를 교차 검증이 잡아낸 순간, 안전장치가 돈 실수를 막아준 이유까지 실전 투입 전 교훈으로 정리했다.

자동매매 전략을 하나에서 여러 개로 늘릴 때 자본을 어떻게 나누고, 같은 종목에 신호가 겹치는 충돌을 어떻게 막는지 개념과 의사코드로 정리했다. 전략별 리스크 한도를 전체 포트폴리오 한도에 종속시키는 설계도 함께 다룬다.

2026년 상반기 새로 열린 토스증권 오픈API를 파이썬으로 처음 붙여본 과정을 정리했다. 신청과 client_id·secret 발급, OAuth2 토큰 발급 흐름, 잔고·시세 조회 첫 연동까지 공식 문서 기준으로 확인하며 정리했고, 시작 전 알아둘 함정도 짚었다.

파이썬 자동매매를 어디에 올릴지 고민이라면, 키움·한국투자·토스증권 API를 설치 방식·서버 배포·모의투자·문서 관점에서 비교했다. 종목 추천이 아니라 개발·운영 기준으로 고르는 법을 익명 운영자 시점으로 정리한다.

증권사 API의 요청 한도(레이트리밋)에 걸렸을 때 무작정 재시도하면 상황이 악화되는 이유와, 지수 백오프와 요청 큐로 안전하게 재시도를 설계하는 방법을 의사코드로 정리했다. 에러 종류별로 재시도 여부를 나누는 기준도 함께 다룬다.

자동매매를 while 반복문으로 돌리다 겪은 한계와, 주기가 다른 여러 작업을 스케줄러 구조로 옮겨 관리하는 방법을 파이썬 의사코드로 정리했다. 개별 작업의 실패가 전체 운영을 멈추지 않게 만드는 예외 처리 설계도 함께 다룬다.

증권사 REST API를 연동하며 마주치는 에러코드를 일시적·설정·치명적 세 갈래로 분류하고, 무인 자동매매가 에러 앞에서 조용히 멈추지 않도록 대응 로직을 설계하는 방법을 파이썬 의사코드와 자주 하는 실수 사례로 정리했다.

키움 미국주식 REST API로 잔고·예수금을 조회하고 매수·매도 주문을 넣는 실전 구조를 정리했다. 시장가·지정가에 따라 주문단가가 필수·금지로 갈리는 함정과, 조용히 거부되는 주문을 코드로 막는 방법, 실전 투입 전 안전장치까지 다룬다.

키움증권 REST API로 잔고와 계좌평가를 조회하는 요청 구조와 응답 필드 개념을 공개 문서 수준에서 정리했다. 조회 결과를 포지션 한도 점검 같은 리스크 관리 로직에 연결하는 방법과 조회 빈도·실패 처리 등 자주 하는 실수 4가지까지 다룬다.

키움증권 REST API 접근토큰 발급부터 만료 감지, 자동 재발급까지 파이썬 의사코드로 정리했다. 만료 60초 전 선제 재발급, 인증 에러 시 1회 재시도, 재발급 실패 시 알림 후 중단까지 무인 자동매매가 토큰 때문에 멈추지 않게 하는 방어 로직을 담았다.

키움증권 REST API 개발자센터 가입부터 앱 등록·App Key/Secret 발급, 모의투자 계좌 신청까지 순서대로 정리했다. 키 보관 원칙, 모의·실전 접속 주소 혼동 방지법, 처음 신청할 때 흔한 실수 3가지까지 한 번에 잡을 수 있다.

파이썬 자동매매 프로젝트를 데이터·전략·리스크·실행·설정 다섯 레이어로 나누는 기준과 디렉터리 구조 예시, API 키·한도값을 환경변수로 분리하는 settings.py 코드까지 담았다. 설정 누락 시 조용한 기본값 대신 즉시 실패해야 하는 이유도 정리했다.

자동매매 시스템을 실전에 투입하기 전 점검할 체크리스트. API 키 관리, 손실 한도, 데이터·전략 검증, 모니터링·알림, 승인·개입 절차 5개 영역을 예/아니오로 답할 수 있는 항목과 구체적인 확인 방법으로 정리했다.

AI 조직으로 만든 자동매매 시스템을 24시간 무인 운영하며 겪은 첫 장애, 알림을 3층위로 나눈 기준, 자동 복구와 사람 개입의 경계, 로그 설계 원칙까지 실제 경험으로 정리했다. 실적 수치 없이 무인 운영에서 배운 것만 담았다.

자동매매를 실전 계좌에 연결하기 전 거쳐야 할 모의투자(페이퍼 트레이딩) 환경 설계법. 파이썬 가상 체결 엔진과 잔고·포지션 영속화, 슬리피지·주문 지연 시뮬레이션까지, 백테스팅으로는 못 잡는 문제를 실전 투입 전에 걸러내는 구조를 예제 코드로 정리했다.

자동매매의 입력단인 시세 데이터를 파이썬으로 수집·정제·저장하는 기초를 정리했다. OHLCV 구조, 결측치를 명시적으로 남기는 처리, 이상치 의심 플래그, 원본·정제본 분리 저장까지 — 백테스팅을 조용히 틀어뜨리는 데이터 결함을 막는 방법을 의사코드로 다룬다.

골든크로스·데드크로스 이동평균 교차 전략을 파이썬으로 구현했다. '지금 상태'가 아니라 '교차 순간'을 잡는 신호 생성 코드, 백테스팅 연결, 리스크 관리 계층 분리까지 — 단순한 전략 하나를 처음부터 끝까지 완주하는 예제다.

자동매매에서 손절·포지션 한도·서킷브레이커가 각각 어떤 실패를 막는지 개념과 파이썬 의사코드로 정리했다. 전략 로직과 리스크 체크를 분리하는 설계 원칙, 세 장치를 계층으로 쌓아야 하는 이유까지 초보자 눈높이로 설명한다.

자동매매 전략을 실거래에 넣기 전 반드시 거치는 백테스팅의 개념을 초보자 눈높이로 설명한다. 미래참조·과최적화·생존편향 세 가지 함정과 최소한의 백테스트 구조를 파이썬 의사코드로 정리해, 내 전략의 검증 결과를 어디까지 믿어도 되는지 판단할 수 있다.

증권사 REST API를 파이썬으로 처음 연동할 때 막히는 인증 절차를 정리했다. App Key·Secret으로 접근토큰을 발급받아 만료 시 자동 재발급하는 구조, Bearer 헤더로 잔고·예수금을 조회하는 흐름을 의사코드로 설명하고 키 유출 등 흔한 실수 4가지를 짚는다.

파이썬 주식 자동매매 시스템의 4대 구성요소(시세 수집·전략·주문 실행·리스크 관리)를 코드 예시와 함께 정리했다. 어떤 순서로 만들어야 안전한지, 왜 리스크 관리를 전략보다 먼저 갖춰야 하는지까지 개념 위주로 다룬다.