API가 없는 증권사 데이터는 어떻게 모으나: HTS 업무 자동화
김대환 · 비브라이트코드 대표 ·
API를 제공하지 않는 증권사의 계좌 데이터는 HTS 업무 자동화로 모읍니다. 담당자가 HTS에서 하던 계좌 조회와 내려받기를 프로그램이 대신하게 만드는 방식입니다. API를 제공하는 증권사는 API로 연결하고, 두 경로로 가져온 데이터를 한곳에 모아 원본과 대조한 뒤 업무에 씁니다.
투자자문·투자일임사는 왜 여러 증권사 데이터를 모아야 하나요?
투자자문사와 투자일임사의 고객계좌는 한 증권사에 모여 있지 않은 경우가 많습니다. 고객마다 거래하는 증권사가 다르고, 회사는 그 계좌 전체가 계약대로 운용되고 있는지 매일 확인해야 합니다.
규모가 작은 회사일수록 이 일을 담당자가 직접 합니다. 증권사마다 다른 프로그램에 접속해 고객 계좌를 하나씩 조회하고, 예수금과 보유 종목, 잔고를 엑셀로 옮겨 합칩니다. 시간이 오래 걸릴 뿐 아니라, 옮기는 과정에서 숫자가 틀려도 알아채기 어렵습니다.
API를 제공하는 증권사와 제공하지 않는 증권사는 무엇이 다른가요?
API를 제공하는 증권사는 프로그램이 증권사가 정한 규격에 맞춰 계좌 정보를 직접 요청하고 받을 수 있습니다. 이 경우 연동은 API 문서를 읽고 예외 흐름을 정리하는 일이 중심이 됩니다.
API를 제공하지 않는 증권사는 이 길이 없습니다. 데이터를 볼 수 있는 곳은 담당자가 로그인해서 쓰는 HTS 화면뿐입니다. 그래서 회사 안에서는 같은 업무라도 증권사에 따라 방법이 달라지고, 결국 가장 손이 많이 가는 증권사 때문에 전체 업무가 엑셀에 머무르게 됩니다.
HTS 업무 자동화란 무엇인가요?
HTS 업무 자동화는 담당자가 HTS에서 하던 계좌 조회와 내려받기를 프로그램이 같은 순서로 대신하게 만드는 일입니다. 담당자가 매일 HTS를 열어 화면을 넘기고 파일을 내려받던 과정을 프로그램이 정해진 시각에 실행합니다.
가져오는 데이터는 담당자가 보던 것과 같습니다. 고객계좌의 국내·해외 예수금, 국내·해외 보유 종목, 잔고입니다. 바뀌는 것은 사람이 화면을 오가며 옮기던 과정이 없어진다는 점입니다.
수집은 언제, 어떤 순서로 실행되나요?
체슬리투자자문에서는 매 영업일 06:00, 10:00, 15:00에 수집이 자동으로 실행됩니다. 담당자가 출근하면 그날 아침 기준의 계좌 현황이 이미 들어와 있고, 장이 끝난 뒤에는 그날의 평가 금액이 계산됩니다.
수집은 사내망 수집 서버에서 증권사별로 순서대로 실행합니다. 한 증권사에서 수집이 실패하면 전체를 다시 돌리지 않고 실패한 증권사만 다시 실행합니다.
자동으로 가져온 데이터는 그대로 믿어도 되나요?
그대로 쓰지 않습니다. 자동으로 가져온 데이터도 증권사 원본과 대조한 뒤에 반영합니다. 틀린 숫자가 보고서나 수수료 계산에 그대로 쓰이는 일을 막기 위해서입니다.
수집 자체가 멈추는 경우도 대비해야 합니다. 수집 상태는 화면에서 실시간으로 확인할 수 있고, 수집이 실패하거나 정해진 시간에 시작되지 않으면 담당자에게 알림과 메일이 갑니다. 담당자가 매번 화면을 열어 확인하지 않아도 문제가 생기면 먼저 알 수 있습니다.
모은 데이터는 어디에 쓰나요?
한곳에 모인 데이터는 고객계좌 잔고 확인, 고객 자산이 계약대로 운용되는지 매일 점검하는 운용 모니터링, 잔고가 달라진 계좌를 찾아 알리는 잔고 변경 감지, 분기 운용보고서 작성에 바로 쓰입니다.
체슬리투자자문에서는 펀드 정보를 하나펀드서비스 힌츠(HINTS)에서 가져와 계약 정보와 연결했습니다. 그래서 담당자는 고객마다 계약과 계좌, 펀드를 한 화면에서 함께 봅니다.
도입하기 전에 무엇을 확인해야 하나요?
먼저 계좌 권한입니다. 회사가 어떤 계좌를 어떤 권한으로 조회할 수 있는지, 증권사별로 API를 쓸 수 있는지 HTS로 접근해야 하는지를 정리해야 합니다.
다음은 수집 범위입니다. 예수금과 보유 종목만 필요한지, 해외 계좌까지 필요한지, 하루에 몇 번 필요한지에 따라 만드는 범위가 달라집니다. 실제로 쓰지 않는 데이터까지 모으면 확인할 것만 늘어납니다.
마지막은 보안과 운영입니다. 고객 계좌 정보를 다루기 때문에 수집은 회사 안의 사내망에서 돌리는 것을 기준으로 설계합니다. 수집 서버를 누가 관리하고, 실패 알림을 누가 받아 처리할지도 미리 정해야 합니다.
자주 묻는 질문
API를 제공하지 않는 증권사의 계좌 데이터도 자동으로 가져올 수 있나요?
가능합니다. 담당자가 HTS에서 하던 계좌 조회와 내려받기를 프로그램이 대신하게 만드는 HTS 업무 자동화로 가져옵니다. API를 제공하는 증권사는 API로 연결하고, 두 경로의 데이터를 한곳에 모읍니다.
어떤 데이터를 가져오나요?
고객계좌의 국내·해외 예수금, 국내·해외 보유 종목, 잔고를 가져옵니다. 담당자가 HTS 화면에서 확인하던 것과 같은 데이터입니다.
하루에 몇 번 수집하나요?
체슬리투자자문에서는 매 영업일 06:00, 10:00, 15:00에 자동으로 수집합니다. 수집 시각과 횟수는 회사의 업무 흐름에 맞춰 정합니다.
수집이 실패하면 어떻게 되나요?
실패한 증권사만 다시 실행합니다. 수집이 실패하거나 정해진 시간에 시작되지 않으면 담당자에게 알림과 메일이 가고, 수집 상태는 화면에서 실시간으로 확인할 수 있습니다.
어느 증권사와 연동했는지 알 수 있나요?
고객사 관계상 연동한 증권사명은 공개하지 않습니다. 미팅에서는 필요한 범위 안에서 설명드릴 수 있습니다.
함께 보면 좋은 글과 사례
- 증권사 API 연동과 자동매매 시스템 개발
증권사 OpenAPI 연동과 HTS 업무 자동화로 여러 증권사의 계좌 데이터를 모으는 작업입니다.
- 금융 업무 자동화와 운용 모니터링 시스템 개발
계좌 조회, 펀드 정보 확인, 보고서 작성처럼 반복하던 확인과 입력을 시스템이 대신하게 만드는 작업입니다.
- (주)체슬리투자자문 운용·업무 자동화 시스템
계약, 증권사 계좌 데이터 수집, 펀드 설정·해지 반영, 운용보고서 발송까지 하나로 묶은 실제 운영 사례입니다.
- 투자일임사 자산 모니터링은 무엇을 매일 확인하나
모은 계좌 데이터를 계약 정보와 맞춰 매일 확인하는 방법을 정리한 글입니다.
최종 수정: