자동매매 연동 실패, API 키·권한 7단계 점검법

조건은 딱 하나!!! 자동매매가 "연결 안 됨"일 때 당황하지 말 것.

증권사 앱·웹, 자동매매 소프트웨어, 내 PC·서버 세 부분을 차례로 점검하면 해결 확률이 높습니다.

개미:

"API 키 똑같이 복사했는데 왜 연결이 안 돼요?"

있을 수 있습니다. 복사 실수보다 권한·만료·IP 제한에서 걸리는 경우가 더 많습니다.

어디서부터 답을 주냐, 우선 이게 맞는지 확인?

→ 1. API 키 존재 여부 확인

→ 2. 키 만료일·재발급 여부 확인

→ 3. 키 권한(주문/조회/출금 등) 확인

키가 있어도 권한이 없으면 연결은 되지만 기능이 제한됩니다.

API 키 → 자동매매 프로그램이 증권사에 "나 이 계좌로 이런 행동 해도 돼요"라고 확인해주는 비밀번호입니다.

API 키를 잘못 입력했나, 어디서 틀리기 쉬운가?

복사 붙여넣기시 공백·줄바꿈으로 오류 납니다.

대소문자·하이픈까지 그대로 붙여넣으세요.

키 입력 후 테스트조회 버튼이 있으면 먼저 눌러보세요.

권한 설정은 어떻게 봐야 하나?

주문 권한과 계좌조회 권한은 별도입니다.

출금(송금) 권한은 절대 불필요하면 비활성화하세요.

권한 변경 후엔 자동매매 쪽에서 새 키를 반영해야 합니다.

네트워크·방화벽 탓일 수 있나?

사내망·공용와이파이에서 포트 차단으로 실패합니다.

서버에선 IP 화이트리스트 설정을 확인하세요.

증권사 API는 특정 포트·프로토콜을 요구하는 경우가 있습니다.

토큰·인증 흐름은 어디서 막히나?

OAuth·토큰 방식이면 토큰 만료가 흔한 원인입니다.

리프레시 토큰 처리 로직이 있나 확인하세요.

토큰 재발급 로그를 먼저 보시면 됩니다.

로그는 어떻게 보나, 어디에 힌트가 있나?

자동매매 프로그램의 에러 로그와 증권사의 API 응답 코드가 핵심입니다.

에러 코드·메시지를 검색하거나 증권사 고객센터에 문의하세요.

그래서, 뭐부터 하냐

→ 1. 증권사 API 콘솔에서 키 존재·만료일 확인

→ 2. 권한(조회/주문/출금) 중 출금 권한 비활성화 확인

→ 3. 프로그램 로그·응답 코드 확인, IP 화이트리스트 검토

이래도 안 되면: 증권사 고객센터에 에러코드·타임스탬프·내 IP 제출해서 문의하세요.

요건 참고만 해주세요~!

픽스톡 💡

※ 이 글은 정보 제공 목적이며 투자 권유가 아닙니다.
※ 투자 판단과 책임은 투자자 본인에게 있습니다.
※ API·인증 관련 최신 기준은 증권사 고객센터나 개발자 문서에서 확인하세요.