키움 실시간조회순위 + LS·네이버 뉴스 텔레그램 알림

01흐름

• 트리거 — 30초마다 조회순위 상위 20개를 받아 직전 조회와 집합 차이를 냅니다. 새로 들어온 종목만 다음 단계로.
• A 갈래 · LS 뉴스 — LS증권 실시간 뉴스를 WebSocket으로 구독해 1시간 슬라이딩 버퍼에 쌓아 두고, 진입 종목명으로 대조. 진입 후 5분간 추가 감시.
• B 갈래 · 네이버 뉴스 — 진입 즉시 최근 2시간 기사를 검색하고, 없으면 30초 × 10회 재검색.
• 두 갈래는 독립 — 한쪽이 못 찾아도 다른 쪽은 진행. 종목당 알림 최대 2건. 엑셀에 적은 제외 키워드는 즉시 반영. 재진입 정책은 세 모드.

02"영웅문은 30초인데 왜 1분마다 와요?"

납품 직후 의뢰인이 정확히 이렇게 물었습니다. 30초 만에 들어왔다 나가는 종목은 아예 못 잡는다고요. 원인은 ka00198 요청 본문이었습니다. 정확한 명세를 못 찾아 웹 검색으로 추정한 필드 일곱 개를 채워 보냈는데, 실제 필수 필드는 qry_tp 하나였고 그 값이 문제였습니다.

qry_tp  1 = 1분   2 = 10분   3 = 1시간   4 = 당일 누적   5 = 30초 (영웅문과 동일)

첫 빌드:  {"qry_tp": "1"}   ← 서버가 "1분 단위로 집계한 데이터"를 정확히 돌려주고 있었다
수정 후:  {"qry_tp": "5"}

서버 캐시 문제가 아니라 저희가 잘못된 값을 요청하고 있었던 겁니다. 다행히 요청 본문을 처음부터 config.json으로 빼 두어서 코드 재빌드 없이 고쳤습니다. 이 일 이후로 외부 API의 enum 값은 공식 문서 표 캡처나 고객이 쓰던 호출 예시를 확보하기 전엔 미확정으로 둡니다.

03그 밖에

• 8050 지정단말기 인증 실패 — 첫 실행에서 "초기화 실패" 팝업만 떠 의뢰인이 당황했습니다. 키움 신 REST는 포털에 등록한 PC에서만 토큰이 나옵니다. 이후 8050·지정단말기 문구를 받으면 포털 메뉴 경로를 한국어로 안내합니다. HTTP 200에 비즈니스 오류 코드가 실리는 건 국내 증권사 API의 공통 패턴이라 return_code를 항상 따로 봅니다.
• LS 키를 다른 프로그램과 공유 — 명세 단계에서 의뢰인이 다른 프로그램과 같은 LS 키를 쓰겠다고 했습니다. 동시 접속 차단이 오면 일반 끊김(5초)과 구분해 30초 백오프를 걸고, 설명서에 별도 키 발급을 권했습니다.
• LS 인증 코드를 키움에 복제하면 안 됐다 — 둘 다 OAuth2인데 LS는 form 본문 + appsecretkey + expires_in, 키움은 JSON 본문 + secretkey + expires_dt. 거의 같아 보이는 코드를 그대로 베끼면 동작하지 않습니다.

04납품물 · 기술

• Windows 64bit 실행 파일 — 영웅문 불필요, 트레이 상주, 24시간 실행 가능
• 설정 다이얼로그(API 키 / 동작 설정 / 기타), 엑셀 제외 키워드 파일
• 사용설명서 — 첫 실행 오류(8050 지정단말기, 8051 시간 만료, 8052 IP 제한) 자가 해결 절 포함

05관련 사례 · 더 보기