
10주 매수에 4주만 체결됐다면: 증권사 HTS 클라이언트 개발자가 만드는 것
PC 주문창에서 10주 매수를 눌렀다고 해볼게요. 첫 통보에 CNTG_QTY라는 수량 항목이 있고 값은 10이에요. 이 숫자를 주문내역의 ‘체결수량’ 칸에 옮겨도 될까요? 한국투자증권 공개 예제의 계좌 통보 설명을 보면, 같은 이름의 칸에 같은 숫자가 와도 화면에 쓸 자리가 달라져요. 수량을 읽기 전에 무슨 통보인지부터 읽어야 해요.
HTS(홈트레이딩시스템) 클라이언트 개발자는 고객의 PC에 시세를 보여주고, 고객의 입력을 주문 요청으로 바꾸고, 서버가 알려온 결과를 주문·미체결·잔고 화면에 반영하는 프로그램을 만들어요. 클릭한 버튼이 어느 계좌의 어느 종목을 몇 주 주문하라는 뜻인지 요청에 담는 것은 클라이언트의 일이에요. 그중 몇 주가 실제로 체결됐는지를 클릭만 보고 정하는 것은 아니에요. 신한투자증권 경력직 공고는 이 직무가 원장 개발과 어떻게 구분되는지를, 한국투자증권의 주문·체결 통보 예제는 PC가 받아서 구분해야 할 결과가 무엇인지를 보여줘요. 아래의 채용 공고와 제품 도움말은 각 회사의 사례이지, 한 증권사의 내부 시스템을 재구성한 설계도는 아니에요.
채용 공고에서 ‘주문’보다 눈여겨볼 말은 ‘클라이언트’예요
신한투자증권의 2021년 12월 31일 마감 ICT 경력직 공고에서는 같은 주식 거래를 다뤄도 지원 부문이 달랐어요. 해외주식 주문·체결·결제 원장은 ‘비즈니스 개발·운영’에 속했어요. 원장은 거래 기록을 관리하는 쪽이에요. 반면 HTS는 고객이 거래 기능을 이용하는 통로인 ‘채널 개발’에 들어갔어요. 채널 안에서도 서버, HTS 클라이언트, 모바일(MTS), 웹(WTS)의 지원 자격을 따로 적었어요.
10주 매수 한 건을 놓고 보면 경계가 좀 더 선명해요. PC 프로그램에서 답할 질문은 ‘사용자가 고른 가격과 수량이 요청에 제대로 담겼나’, ‘돌아온 결과가 다른 주문이 아니라 그 주문의 행에 표시됐나’예요. PC와 요청·결과를 주고받는 채널 서버를 개발하는 일, 주문·체결·결제 기록을 관리하는 일까지 ‘HTS 클라이언트 개발·운영’이라는 직무명에 모두 들어 있다고 읽을 필요는 없어요.
이 공고의 HTS 지원 자격에는 Visual C++/MFC, VBScript, Python 애플리케이션 개발 경험이 명시돼 있어요. 지원자에게 유용한 단서는 언어 이름뿐만이 아니에요. 서버 부문과 별도로 고객이 실행하는 PC 애플리케이션 경험을 적었다는 점이에요. 과거 한 회사의 경력직 공고이므로 세 기술이 지금 모든 증권사의 필수 요건이라는 뜻은 아니에요.
화면에 뜬 체결가는 내 주문의 체결 통보가 아니에요
매수를 누르기 직전으로 돌아가 볼게요. 한국투자증권의 국내주식 웹소켓 예제에서 ccnl_total은 종목코드를 받아 통합 실시간 체결가 구독을 등록하거나 해제해요. 이 체결가가 답하는 질문은 ‘시장에서 이 종목이 얼마에 거래됐나’예요. 반면 ccnl_notice는 계좌의 주문·체결 통보를 받는 별도 함수예요. ‘방금 그 가격에 거래가 있었다’는 소식에는 내 10주 주문이 그 거래에 포함됐다는 뜻이 없어요.
이 구분만으로 화면 테스트 두 가지를 만들 수 있어요. 하나는 A종목을 보다가 B종목으로 바꿨을 때 뒤늦게 온 A의 가격이 B의 가격처럼 그려지지 않는지 보는 거예요. 다른 하나는 A종목을 그대로 보고 있을 때 시장 체결가만 바뀌고 내 주문 통보는 오지 않았다면, 내 미체결 수량도 그대로인지 보는 거예요. 앞의 검사는 가격을 표시할 종목을, 뒤의 검사는 수량을 바꿀 근거를 확인해요. 공개 인터페이스에서 도출한 검증 예이지 실제 제품에서 발견한 결함은 아니에요.
보는 시장과 주문할 시장도 별개일 수 있어요. 키움증권 영웅문4의 8545번 통합미니주문 도움말에서는 화면 위쪽에 시세를 보는 시장을, 주문 영역 아래에 주문을 보낼 경로를 표시해요. 시세와 주문거래소를 연동하면 한국거래소(KRX) 시세에 KRX 주문이 대응해요. 하지만 연동을 풀면 KRX 시세를 보면서 넥스트레이드(NXT)로 주문할 수도 있어요.
따라서 위에는 KRX, 아래에는 NXT라고 뜬 화면을 보고 어느 한쪽 이름표가 틀렸다고 단정할 수 없어요. 개발자가 확인할 것은 연동을 켰을 때 주문 대상이 시세 선택을 따라가는지, 연동을 풀었을 때는 고객이 따로 고른 주문 대상이 요청에 담기는지예요. 도움말이 설명하는 것은 고객 화면의 이 조합까지예요. 서버 내부의 주문 경로 결정 방식까지 보여주는 것은 아니에요.
확인창을 껐어도 ‘매수 전부취소’에는 다시 물어요
버튼을 누른 다음에 일어날 일은 클릭 횟수만으로 정해지지 않아요. 유진투자증권 원클릭 주문창 가이드에서는 확인창을 띄우는 것이 기본이에요. 설정을 바꾸면 더블클릭만으로 주문을 접수할 수 있고 원클릭 기능도 선택할 수 있어요. 같은 주문 입력이라도 고객의 설정에 따라 요청을 보내기 전에 한 번 더 묻는 단계가 생기거나 없어져요.
그런데 이 제품에서 ‘확인창 끄기’는 어떤 상황에서도 묻지 말라는 뜻이 아니에요. 매수 미체결 주문을 전부 취소하거나 매도 미체결 주문을 전부 취소할 때에는 확인창을 끈 고객에게도 다시 물어요. 취소의 범위도 버튼마다 달라요. 한 가격에 미체결 주문이 여러 건 있을 때 이 창에서 호가별 취소를 고르면 그 가격의 주문이 모두 대상이에요. 그중 한 건만 골라 취소하려면 다른 창을 써야 해요. 유진투자증권의 호가별 취소·전부취소 안내
그래서 테스트 명세에는 ‘취소 버튼이 작동한다’보다 구체적인 문장이 들어가요. 가령 같은 가격에 미체결 주문 두 건을 둔 뒤 호가별 취소의 대상이 두 건인지 봐요. 별도의 경우로, 확인창을 끄고 매수 전부취소를 선택했을 때에도 확인창이 뜨는지 봐요. 첫 검사는 ‘가격 하나’와 ‘주문 한 건’을 혼동하지 않는지, 둘째 검사는 전부취소의 예외를 지키는지 확인해요. 이 예외는 유진투자증권 해당 주문창의 사양이에요.
‘체결수량’ 자리에 온 10, 접수 직후 체결란에는 0주를 써요
이제 첫 통보를 해독할 차례예요. 한국투자증권 구버전 예제의 필드 설명에서 수량과 짝지어 읽을 항목은 CNTG_YN이에요. 값이 1인 접수 계열 통보에서 CNTG_QTY는 주문수량, 값이 2인 체결 통보에서는 이번 체결수량이에요. 거부 여부는 RFUS_YN이라는 별도 필드로 구분해요. 즉 접수 계열로 분류하는 것과 거부되지 않은 주문임을 확인하는 것도 같은 판단이 아니에요.
같은 저장소의 국내주식 실시간체결통보 사용자 예제에서도 서비스 H0STCNI0로 접수 계열과 체결 통보가 함께 들어와요. 둘을 나누는 값은 14번째 항목인 CNTG_YN이에요. 메시지를 받은 서비스 이름이 ‘체결통보’라는 이유로 모든 메시지를 체결로 처리하면, 주문이 접수됐을 뿐인데 고객 화면에는 이미 샀다고 나오게 돼요.
공개 예제의 수량 해석 규칙을 가상의 10주 신규 매수에 적용하면 아래처럼 돼요. 같은 주문에 거부되지 않은 접수 통보와 4주 체결 통보가 차례로 한 번씩 왔고, 다른 체결이나 취소는 없다는 조건이에요. 실제 주문 기록이나 HTS 내부 통신 포맷을 옮긴 표는 아니에요.
받은 통보 (CNTG_YN, CNTG_QTY) |
이번 수량의 뜻 | 화면의 누적 체결 | 화면의 미체결 |
|---|---|---|---|
| 신규 접수 (1, 10) | 주문한 수량 10주 | 0주 | 10주 |
| 부분체결 (2, 4) | 이번에 체결된 수량 4주 | 4주 | 6주 |
첫 줄의 10은 버릴 숫자가 아니에요. 주문수량 칸에는 꼭 필요하지만, 아직 체결이 없으니 체결란에는 0주를 써요. 둘째 줄에서는 주문수량 10주를 그대로 두고 누적 체결을 4주로 바꿔요. 그래서 미체결은 10에서 4를 뺀 6주예요. 두 통보의 수량을 읽을 때마다 무조건 더하면 10주 주문에서 14주가 체결됐다는 내역이 나와요. 잔고 화면에서도 매수 버튼을 눌렀다는 사실만으로 10주 전부를 산 것처럼 보여줄 수는 없어요. 다만 이 계산이 설명하는 것은 주문 상태이지, 개별 HTS가 잔고를 조회하거나 갱신하는 방식까지는 아니에요.
남은 6주의 거래소정정은 이름 변경이 아니라 취소와 신규예요
부분체결 뒤 고객이 정정하려는 대상은 이미 산 4주가 아니라 아직 남은 6주예요. 이 수량을 키움증권 8545번 화면의 거래소정정 기능에 대입해 볼게요. 정정이 가능한 KRX 미체결 주문을 선택하면 버튼의 방향은 KRX→NXT이고, NXT 미체결 주문을 선택하면 반대예요. 방향을 정하는 근거는 지금 위쪽에 띄운 시세가 아니라 고객이 선택한 미체결 주문의 시장이에요.
키움 도움말에서 거래소정정은 기존 미체결 주문을 취소한 뒤 다른 거래소에 신규 주문을 내는 기능이에요. 주문내역 한 줄의 ‘KRX’를 ‘NXT’로 덮어쓰는 것이 아니에요. 시장가·중간가 주문 등에는 이 기능을 쓸 수 없고, 종목 상태나 호가 상황에 따라 거부될 수도 있어요. 따라서 버튼을 눌렀다는 사실은 새 시장에 6주 주문이 성공했다는 근거가 되지 않아요. 도움말이 밝힌 처리 방식과 제한만으로 취소와 신규를 어느 서버가 조율하는지, 중간에 실패하면 어떤 문구가 뜨는지까지 정할 수는 없어요.
이 차이를 실제 주문 없이 시험해 보세요. 종이에 ‘받은 통보 / 누적 체결 / 남은 수량 / 화면에서 안내할 수 있는 다음 동작’ 네 칸을 만들어요. 같은 주문번호의 첫 줄에는 ‘10주 신규 접수 / 0주 / 10주 / 미체결 주문 선택’, 둘째 줄에는 ‘4주 체결 / 4주 / 6주 / 남은 6주 취소 요청 가능’이라고 적어요.
셋째 줄에서는 고객이 남은 6주의 취소를 요청했지만 아직 취소 확인은 오지 않았다고 놓아요. 추가 체결도 없다면 ‘새 통보 없음 / 4주 / 6주(마지막 확인 기준) / 취소 결과 확인 대기’라고 쓸 수 있어요. ‘취소를 요청했어요’는 지금 안내할 수 있지만 ‘6주가 취소됐어요’는 아직 쓸 수 없어요. 두 문구 사이에 필요한 확인 통보가 바로 화면 코드를 짜기 전에 서버 쪽과 합의할 데이터예요.
미체결 주문이 두 곳에 보이면 주문내역과 따로 대조해요
운영 중 ‘주문이 두 번 보인다’는 문의가 들어왔다고 해볼게요. 키움증권 영웅문4의 8284번 통합주식호가주문 도움말에는 주문 한 건이 두 곳에 보일 수 있는 조건이 나와요. KRX와 NXT 호가를 합쳐 표시하면 매도호가가 매수호가와 같거나 낮아지는 ‘호가역전’이 가능해요. 이때 같은 가격이 매수·매도 영역 양쪽에 나타나면 그 가격의 미체결 주문도 양쪽에 표시될 수 있어요.
이 경우 문의를 확인하는 일은 둘로 나뉘어요. 표시를 재현하려면 고객이 본 창이 8284번인지, 개별 시세가 아니라 통합 시세였는지, 양쪽에 표시된 가격이 같았는지 알아야 해요. 실제로 주문 두 건이 접수됐는지를 판단하려면 화면에서 몇 번 보였는지가 아니라 주문내역과 대조해야 해요. 도움말은 중복 표시가 가능하다는 근거예요. 특정 문의가 표시 문제였다거나 중복 전송이 없었다는 증거는 아니에요.
더블클릭을 고친 뒤에는 원주문번호 121을 따라가요
상상인증권이 제공한 NEW BRIDGEFN+ 활용가이드에는 작은 화면 변경 한 건이 실려 있어요. 주식종합 9601번 화면에서 미체결 행의 어느 열을 더블클릭하든 정정·취소 탭으로 연결되도록 개선했어요. 가이드 그림에서 미체결 표의 주문번호는 121이에요. 아래쪽 정정·취소 입력부로 눈을 옮기면 ‘원주문’ 칸에도 121이 들어가 있어요. 새로 낼 정정·취소 요청이 어느 기존 주문을 대상으로 하는지 보여주는 번호예요.
고객에게는 종목명 칸을 눌러도 수량 칸을 눌러도 된다는 변화예요. 개발자라면 여기서 ‘탭이 열렸다’보다 정밀한 검증 기준을 끌어낼 수 있어요. 어느 열을 눌러도 선택한 행의 번호가 전달되는가. 다른 행을 선택하면 직전 번호 121이 남지 않는가. 가이드가 유사 기능을 추가했다고 밝힌 9501·9511·9600·9603번 창에서도 선택한 행과 입력부의 원주문이 일치하는가. 이는 실제 팀의 시험 기록이 아니라 공개된 개선 사항으로 작성할 수 있는 테스트예요. 이 더블클릭의 성패는 탭이 열렸느냐에서 한 걸음 더 가요. 열린 탭이 고객이 고른 바로 그 주문을 가리켜야 해요.
출처
- 신한투자증권 인재채용 — ICT부문 경력직(정규직) 상시채용, 비즈니스 개발·운영과 채널 개발
- 한국투자증권 Open Trading API — ccnl_notice의 접수·체결 통보 구분
- 키움증권 영웅문4 도움말 — [8545] 통합미니주문: 거래소정정의 처리 방식과 제한
- 유진투자증권 HTS 가이드 — 원클릭 주문창의 확인창 설정과 호가별·전체 취소
- 한국투자증권 Open Trading API — legacy/Sample01/kis_domstk_ws.py의 실시간 계좌 통보 필드 설명
- 키움증권 영웅문4 도움말 — [8284] 통합주식호가주문: 호가역전과 미체결 주문 중복 표시 유의사항
- 상상인증권 제공 NEW BRIDGEFN+ 활용가이드 — 고객요청화면, 주식종합(9601) 미체결내역 연동 개선
댓글0