KB증권(H-able) 실시간잔고 내보내기 — 엑셀을 CSV로 바꿔 Multifolios에 올리기

KB증권의 PC HTS H-able 은 잔고 화면의 데이터를 파일로 저장하는 기능을 공식 도움말에 명시하고 있습니다. 다만 저장 형식이 엑셀이라 CSV 직접 내보내기가 아닙니다. 그래서 이 글은 "엑셀로 저장 → 스프레드시트에서 CSV로 다시 저장 → Multifolios 미리보기로 확인 → 등록"이라는 한 단계 더 붙은 순서로 정리합니다. 확인한 것과 확인하지 못한 것을 본문에 그대로 구분해 두었습니다.

이 글에서 공식 자료로 확인한 범위는 H-able 의 [0345] 실시간잔고(주식) 화면까지입니다. HTS 버전과 화면 구성은 업데이트로 달라질 수 있으니, 화면이 다르면 잔고 화면의 저장 기능을 먼저 찾아 주세요.

어떤 형식이어야 하는지 먼저 보고 싶다면 샘플 CSV 내려받기(가상 데이터 · 계좌 2개 · 시장 3개 · 통화 3종)로 미리 확인할 수 있습니다.

2. H-able 에서 잔고 내보내기

1. H-able 에 로그인하고 화면번호 0345 (실시간잔고(주식)) 를 엽니다.
2. 내보낼 계좌를 선택합니다.
3. [종목합산]을 선택합니다. 이걸 켜지 않으면 같은 종목이 주문 단위로 여러 줄에 나뉘어 나옵니다. Multifolios 는 같은 종목이 여러 줄이어도 가져오기는 하지만, 종목별 한 줄로 합쳐 두는 편이 확인하기 쉽습니다.
4. 필요하면 [조회순서설정] 에서 표시 항목을 정리합니다. 쓸 열은 종목코드·수량·평균 매입단가 세 가지뿐이라, 나머지를 꺼 두면 다음 단계가 편합니다.
5. 화면의 엑셀 저장 버튼을 눌러 파일로 저장합니다.

여기까지가 공식 도움말로 확인되는 범위입니다. 버튼의 위치·아이콘 모양은 도움말에 그림으로만 표시되어 있어 글로 옮기지 않았습니다.

3. 앱 입력 형식으로 정리하기

저장한 엑셀 파일을 열어 아래 형태로 다듬은 뒤 CSV(쉼표로 분리)로 다시 저장합니다. Multifolios 가 실제로 요구하는 열은 세 개뿐입니다.

정리할 때 알아 두면 편한 규칙입니다.

• 통화 열은 없어도 됩니다 — 6자리 숫자 코드(005930)는 KRW, .T 로 끝나면 JPY, 그 밖의 티커는 USD 로 자동 판정됩니다. 통화를 적을 거라면 KRW·USD·JPY 중 하나로 적으세요. EUR 처럼 지원하지 않는 통화를 적은 줄은 가져오지 않고 건너뜁니다.
• 헤더에 괄호 주석이 붙어도 됩니다 — 수량(주) 는 수량 으로 읽습니다. 대소문자·공백·밑줄도 무시합니다.
• 숫자에 쉼표·통화기호가 섞여도 됩니다 — 71,200, ₩71,200, 185.50 모두 그대로 읽습니다.
• 구분자는 쉼표·탭·세미콜론 모두 인식합니다. 엑셀에서 "CSV UTF-8" 로 저장하는 것이 가장 무난합니다.
• 종목명이 아니라 코드를 적어야 시세가 연결됩니다. "삼성전자" 가 아니라 005930 입니다.

엑셀에서 CSV 로 저장할 때 — 종목코드 앞의 0 을 지키세요

가장 자주 데이터가 망가지는 지점입니다. 스프레드시트는 005930 을 숫자로 보고 5930 으로 바꿔 버립니다. 통화 열이 없거나 비어 있을 때는 통화를 종목코드 모양으로 추론하는데, 여섯 자리가 아니게 되면 KRW 가 아니라 USD 로 판정됩니다. 삼성전자가 달러 종목으로 들어가는 셈입니다. (통화 열에 KRW 를 명시했다면 그 값이 우선합니다.)

• 엑셀에서 종목코드 열을 텍스트 서식으로 지정한 뒤 값을 넣거나, 파일을 열 때 해당 열을 텍스트로 가져오세요.
• 구글 시트는 파일 > 가져오기 에서 "텍스트를 숫자·날짜로 변환" 을 끄면 앞의 0 이 유지됩니다.
• CSV 로 저장한 뒤 메모장·텍스트 편집기로 한 번 열어 종목코드가 005930 여섯 자리 그대로인지 눈으로 확인하는 것이 가장 확실합니다.
• 마지막 확인은 앱 미리보기의 “가져올 값” 목록에서 합니다 — 국내 종목의 통화가 KRW 로 적혀 있는지, 종목코드가 005930.KS 처럼 여섯 자리를 유지했는지 보세요. 통화 열을 비워 둔 채 앞의 0 이 날아갔다면 추론 결과가 USD 로 표시됩니다.

정리된 모습 (가상 예시 — 실제 계좌·보유 데이터가 아닙니다)

symbol,buyPrice,shares,accountName
005930,71200,30,KB증권
000660,178500,12,KB증권
AAPL,185.5,10,KB증권

한국어 헤더로 적어도 똑같이 동작합니다.

종목코드,평균단가,보유수량,계좌명
005930,"71,200",30,KB증권
000660,"178,500",12,KB증권
AAPL,185.5,10,KB증권

위 예시는 설명을 위해 지어낸 값입니다.

업로드 전에 식별정보 열을 지우세요

증권사 엑셀 저장본에는 계좌번호·고객번호 같은 열이 함께 들어 있는 경우가 있습니다. CSV 로 저장하기 전에 그 열들을 삭제하세요. 이유가 두 가지입니다.

• 계좌번호 열이 계좌명으로 인식될 수 있습니다. Multifolios 는 계좌 로 시작하는 헤더를 계좌명 열로 잡습니다. 계좌번호 열을 남겨 두면 계좌번호가 그대로 계좌 이름이 되어 화면과 저장 데이터에 남습니다.
• 계좌번호·고객번호는 포트폴리오 계산에 전혀 필요하지 않습니다. 파일을 옮기거나 공유할 때만 위험이 됩니다.

계좌명 열에는 "KB증권", "KB-연금"처럼 본인이 알아볼 별칭을 적으세요. 별칭이면 계좌별로 나눠 보는 데 충분합니다.

4. 합계·소계 행은 먼저 지우세요

증권사 엑셀 저장본에는 맨 아래에 합계·소계 행이 붙어 있는 경우가 많습니다. 이런 행은 종목코드 자리에 "합계" 같은 글자가, 수량·금액 자리에 숫자가 들어 있습니다.

앱이 알아서 걸러 준다고 믿지 마세요. 종목코드 형태가 아닌 값은 미리보기에서 경고로 표시될 뿐 가져오기에서 제외되지 않을 수 있습니다. 합계 행이 그대로 들어오면 존재하지 않는 종목이 큰 수량으로 추가됩니다.

• CSV 로 저장하기 전에 합계·소계·계좌 요약 행을 삭제하세요. 헤더 행 위쪽에 붙은 조회 조건 줄도 같이 지웁니다.
• 그래도 미리보기에서 경고 표시와 실제로 가져올 행 수를 직접 확인하세요. 보유 종목 수와 숫자가 맞지 않으면 파일로 돌아가야 합니다.

5. 미리보기로 확인하기

1. Multifolios 대시보드를 엽니다.
2. 상단 CSV 메뉴 → CSV 가져오기를 선택합니다.
3. 이미 등록해 둔 보유가 있다면 창 위쪽에서 모드(새 종목만 추가 / 보유현황 교체)와 적용 범위를 먼저 고릅니다. 이 선택이 파일 선택보다 앞에 있습니다.
4. 파일 선택에서 방금 저장한 CSV 를 지정합니다.
5. 미리보기에서 확인합니다. 위쪽은 가져올 종목 수 · 수량 변화 · 적용 범위(어느 계좌를 바꾸는지, 새로 만들어질 계좌 이름)이고, 그 아래 “가져올 값” 목록에 실제로 저장될 값이 행마다 나옵니다 — 종목코드 · 통화 · 수량 · 평균 매입단가 · 계좌.
   • 통화는 목록에 적힌 코드(KRW/USD/JPY)를 그대로 보세요. 파일에 통화를 적었으면 그 값이 우선이고, 없거나 비어 있으면 기존 규칙으로 추론한 결과가 표시됩니다. 어느 쪽이든 금액을 다른 통화로 환산하지는 않습니다. 심볼 뒤의 .KS·.T 는 참고 표시일 뿐이니 꼬리표만으로 통화를 판단하지 마세요.
   • 평균 매입단가가 파일의 값과 같은지 확인하세요. 반올림 없이 그대로 표시되므로 소수점 아래가 있는 단가도 여기서 바로 비교할 수 있습니다.
   • 계좌 칸에 계좌번호가 들어와 있지 않은지 확인하세요. 새로 만들어질 계좌에는 “신규” 표시가 붙습니다.
   • 대상 계좌를 골라야 하는 경우에는 계좌 칸에 “대상 계좌 선택 필요” 안내가 표시됩니다. 대상 계좌를 고르면 그 이름으로 바뀝니다. 기존 계좌가 하나도 없는 첫 가져오기는 이 선택 없이 계좌 미지정으로 진행할 수 있습니다.
   • “이미 보유 → 건너뜀” 으로 표시된 행은 가져오지 않는 행이라 행 수에도 포함되지 않습니다.
6. 건너뛴 줄과 경고를 확인합니다. 종목코드가 비었거나, 숫자를 읽지 못했거나, 지원하지 않는 통화를 적은 줄은 제외됩니다. 종목코드 형태가 아닌 값은 제외가 아니라 경고이므로 직접 판단해야 합니다.

6. 등록하기

순서가 중요합니다. 설정 → 파일 → 미리보기 확인 → 마지막에 가져오기 실행입니다.

이미 등록해 둔 보유가 있을 때

1. 모드를 고릅니다. 기존 보유는 두고 새 종목만 더하려면 새 종목만 추가, 파일 내용대로 맞추려면 보유현황 교체.
2. 교체를 골랐다면 적용 범위를 확인합니다. 기본값은 "파일에 있는 계좌만" 이라 다른 증권사 계좌의 보유는 그대로 남습니다. 계좌 열이 없거나 값이 모두 비어 있고 등록된 계좌가 있다면 교체할 계좌를 먼저 지정해야 합니다. 등록된 계좌가 없으면 계좌 미지정으로 진행할 수 있습니다. 같은 계좌명으로 나눈 파일은 뒤에 올린 파일이 그 계좌를 교체하므로, 한 파일로 합치거나 계좌명을 구분하세요.
3. 파일을 선택하고 미리보기를 확인합니다(5번 섹션).
4. 맞으면 그때 가져오기를 누릅니다. 보유가 종료되는 종목이 있으면 확인 절차가 한 번 더 있습니다.

처음 가져오는 경우

보유도 계좌도 아직 없다면 모드·적용 범위 선택이 화면에 나타나지 않습니다. 빈 상태에서는 "추가"와 "교체"의 결과가 같아 고를 것이 없기 때문입니다. 파일 선택 → 미리보기 확인 → 가져오기 순서로만 진행하면 됩니다.

종목이 서너 개뿐이라면 CSV 를 만들 것 없이 대시보드의 종목 추가 폼에서 코드·수량·매입단가를 바로 입력하는 편이 빠릅니다. 계좌를 먼저 만들어 두고 종목을 추가하면 CSV 로 가져온 것과 똑같이 계좌별로 잡힙니다.

7. 자주 걸리는 문제

"필수 컬럼을 찾을 수 없습니다"

첫 행이 헤더가 아닌 경우가 대부분입니다. 엑셀 저장본은 위쪽에 계좌 요약·조회 조건 같은 줄이 붙어 있을 수 있으니, 헤더 행 위의 줄을 모두 지우고 다시 저장하세요. 헤더에 종목코드·매입단가·수량에 해당하는 이름이 하나씩 있으면 됩니다.

한글이 깨져 보인다

Multifolios 는 EUC-KR 인코딩을 자동 감지하지만, 그래도 계좌명 등이 깨져 보이면 "CSV UTF-8" 형식으로 다시 저장해 재시도하세요.

같은 종목이 여러 줄로 들어온다

[종목합산]을 켜지 않고 내보낸 파일입니다. 2번 단계로 돌아가 합산 후 다시 저장하거나, 스프레드시트에서 수량을 합치고 단가를 수량가중평균으로 계산해 한 줄로 만드세요.

8. 출처

• KB증권 H-able 도움말 — [0345] 실시간잔고(주식) (확인일 2026-09-21)
• KB증권 고객서비스 — 이용가이드 > 매체활용가이드 > H-able (확인일 2026-09-21)

본문의 "확인하지 못함" 항목은 위 자료에 적혀 있지 않은 것들입니다. 추측으로 채우지 않았습니다.