🔑 키움증권 Open API+ 신청 및 App Key / App Secret 발급 가이드
테마지도 PC에서 키움 실시간 시세를 연동받기 위해 API 사용신청, 사용 IP 등록, 계좌 등록 절차를 순서대로 진행해 주세요.
[계좌 App Key 관리] 화면에서 보안 통신을 위한 2가지 필수 설정을 진행합니다.
- ① IP 주소 등록: '현재 나의 IP' 항목에 표시된 IP 주소를 확인하여 [IP 주소등록] 입력란에 넣고 우측 [추가] 버튼을 클릭합니다. (프로그램을 사용할 PC의 IP 등록 필수)
- ② 계좌 등록하기: 하단 [계좌 등록하기] 버튼을 클릭하여 본인 실전투자 계좌를 등록합니다.
- ③ App Key / App Secret 다운로드: 계좌 등록 후 생성된 App Key와 App Secret의 [다운로드] 버튼을 눌러 키 파일을 PC에 저장합니다. (※ 1회만 다운로드 가능하므로 안전한 곳에 보관해 주세요.)
- ④ 키움 API 입력: 다운로드받은 API 키 파일을 열어 파일 내부의 키값(App Key / Secret Key)을 복사한 후, 테마지도 PC버전 우측 상단 ⚙️ [환경설정]의 입력란에 각각 붙여넣고 [저장하기]를 누릅니다.
📌 [Step 2-1] IP 등록 및 현황 설정 화면
📌 [Step 2-2] 계좌 등록하기 및 App Key / App Secret 다운로드 화면
위에서 발급받아 보관 중인 App Key와 App Secret을 테마지도 PC 프로그램 우측 상단의 ⚙️ [환경설정] 톱니바퀴 버튼을 누른 후 그대로 입력해 주세요.
입력 후 하단의 [🔌 연결 테스트] ➔ [💾 저장하기]를 클릭하면 키움증권 실시간 시세 연동이 최종 완성됩니다!
🛡️ 보안 및 로컬 암호화 안심 보장
입력하신 Kiwoom App Key와 Secret Key는 외부 서버로 절대 전송되지 않으며, 오직 본인 PC 로컬에만 안전하게 보관됩니다.
키움증권 Open API+ 신청 후 받은 App Key와 Secret Key를 입력합니다. (키움 서버 실시간 시세 연동용)
키움 API 서버의 IP 차단(HTTP 429 Error) 및 계정 차단을 방지하기 위해 최소 10초 이상으로 자동 보호 세팅됩니다. 10초 (권장) 설정을 추천합니다.
한국거래소(KRX) 공식 2,700여 개 전종목 리스트를 이용자 PC 단독으로 수집하여, 신규 상장 종목 반영 및 사명이 변경된 종목을 내 로컬 테마에 자동으로 최신화/동기화합니다.
보관 중인 테마 파일(.json)을 선택해 내 로컬 테마 및 종목 구성 데이터로 즉시 적용합니다.
[🔌 연결 테스트]를 눌러 키움 API 연동 통신이 정상인지 확인 후, [💾 저장하기]를 누르면 설정 조작이 저장 적용됩니다.
📌 위의 실행 이미지 번호별 기능 연계 안내
이미지 좌측 상단의 [상승률순 ∨] 드롭다운을 통해 시장 상황에 맞춘 테마 산정 기준을 지정할 수 있으며, 옆의 [상승률순 (▲/▼)] 버튼으로 내림차순/오름차순 정렬을 원클릭 전환합니다.
모니터 크기와 매매 환경에 맞춰 한 화면에 노출될 테마 카드 수를 [6개], [8개], [9개] 버튼으로 조절합니다. (이미지는 6개 뷰 설정 상태)
키움 Open API 통신이 정상 연결되면 초록색 [키움 연동완료] 뱃지가 표시되며, [+테마 추가], 로그인 계정 정보, ⚙️ 환경설정(톱니바퀴) 버튼이 제공됩니다.
[List (리스트 뷰)](기본 뷰), [Map (트리맵)](테마 자금 쏠림 시각화), [Macro (글로벌 지수)], [Manage (테마 관리)] 탭을 클릭하여 즉시 화면 모드를 전환합니다.
각 카드 상단에는 순위, 테마명, 평균 등락률, [📌상단고정] 버튼이 위치하며, 내부에는 실시간 상승률 상위 5개 종목의 코드, 현재가, 등락률, 미니 차트(스파크라인)가 자동 갱신됩니다.
카드 하단의 [📊 차트 로드] 버튼을 누르면 해당 테마의 주도 종목 차트가 키움 HTS와 자동 연동되며, [+ 종목 관리/더보기]로 구성 종목을 관리에 바로 추가합니다.
카드 우측 하단의 [🔍 전체 종목 (N개)] 버튼을 클릭하면 테마의 전체 구성 종목 시세, 등락률, 스파크라인 차트, 거래대금을 한눈에 모니터링하는 스마트 팝업창이 열립니다.
• 총 거래대금 뱃지: 헤더 상단에서 테마 내 전 종목 합산 거래대금(예: 거래대금 3,516억원)을 1초 만에 확인합니다.
• 정렬 & 검색: [상승률순 / 거래대금순 / 시가총액순] 정렬 및 테마 내 종목명/코드 빠른 검색을 지원합니다.
• 네이버 증권 연동: 종목 클릭 시 네이버 증권 세부 기업 정보 페이지로 바로 연결됩니다.
🌐 Macro - 마켓 터미널 PRO & 실시간 차트/호가창 연동
코스피, 나스닥 선물, VIX, WTI 원유 등 국내외 주요 매크로 지표를 실시간 1분 주기로 통합 모니터링합니다. 지수 카드를 클릭하면 실시간 캔들차트, 이동평균선(5/20/60), 분봉/일봉 스위처, 5호가 매도/매수 잔량 오더북 창이 이쁘게 팝업됩니다.
📌 위의 실행 이미지 번호별 기능 연계 안내
[한국 관련] (KOSPI, KOSDAQ, MSCI South Korea ETF, SK하이닉스 ADR)
[미국 관련] (나스닥 선물, S&P 500 선물, 다우 선물, VIX 공포지수, 필라델피아 반도체 등)
[거시 경제 · 원자재] (WTI 원유, 금, 미 10년물 국채금리, 환율 등)
[M7 + AI 반도체] (엔비디아, 애플, 마이크로소프트, 테슬라 등 글로벌 주도주 현황)
마켓 터미널의 임의의 지수 카드를 클릭하면 sonmul.co.kr 스타일의 고해상도 실시간 캔들차트 모달이 즉시 실행됩니다.
상단 탭으로 [1분 / 5분 / 15분 / 일봉]을 원클릭 전환할 수 있으며, 캔들뷰/영역뷰 및 MA5, MA20, MA60 이동평균선과 거래량 차트가 동시 표시됩니다.
차트 모달 우측 영역에는 실시간 매도 5호가와 매수 5호가 잔량이 시각적 그래픽 바와 함께 실시간 갱신되어 체결 강도와 매매 호가 흐름을 한눈에 간편하게 파악할 수 있습니다.
⚙️ Manage - 사용자 맞춤형 테마 노출/숨김 & 종목 관리
79여 개 전체 테마 중 내 매매 스타일과 관심사에 맞춰 자주 안 보는 테마는 OFF(숨김) 처리하고, 주력 테마만 ON(노출)으로 설정하여 나만의 깔끔한 맞춤 테마지도를 구성합니다.
📌 위의 실행 이미지 번호별 기능 연계 안내
테마 목록 오른쪽의 [👁️ON (노출중)] / [🙈OFF (숨김)] 스위치를 클릭하면 해당 테마가 메인 List 뷰에서 즉시 숨겨지거나 다시 노출 복원됩니다.
(※ 비활성화(OFF) 처리된 테마도 데이터는 안전하게 보존되며, 언제든 클릭 한 번으로 [ON] 복원이 가능합니다.)
상단 필터 버튼 [전체 보기 (79개)], [👁️ 노출 중 ON], [🙈 비활성화 OFF]를 사용하여 현재 숨겨진 테마 목록이나 활성화된 테마 목록만 한눈에 골라 필터링할 수 있습니다.
[✏️ 종목 관리]: 클릭 시 해당 테마에 포함된 종목 리스트를 직접 수정(종목 추가/삭제/우선순위 변경)할 수 있습니다.
[🗑️ 영구 삭제]: 사용자가 직접 추가한 나만의 커스텀 테마를 완전히 삭제 처리합니다.