시세 데이터 읽기
화면의 숫자는 거래소에서 앱까지 여러 단계를 거쳐 도착합니다. 체결과 호가의 차이, OHLCV 생성 원리, 틱·초·분·일봉의 기준과 데이터 품질을 기초부터 익힙니다.
1. KRX에서 앱까지 데이터 경로
KRX에서 생성된 시세가 증권사 API를 거쳐 앱에 표시되는 흐름과 REST·WebSocket의 역할을 설명할 수 있습니다.
- KRX 시장
- 증권사 시세 시스템
- OAuth 인증
- REST 조회·WebSocket 구독
- IUreplay·IUalgo
KRX의 주문과 체결 결과가 시장 데이터의 출발점입니다. 증권사는 이를 받아 고객에게 제공하고, 앱은 증권사가 정한 API 규격과 권한 안에서 데이터를 요청합니다. OAuth 방식에서는 App Key와 App Secret 등으로 접근 토큰을 발급받고, 이후 요청에 토큰을 사용합니다. 키와 토큰은 비밀번호처럼 공개하면 안 됩니다.
| 단계 | 예시 시간 | 누적 지연 예시 |
|---|---|---|
| KRX 이벤트 | 09:00:00.000 | 0ms |
| 증권사 처리 | 09:00:00.015 | 15ms |
| 네트워크 수신 | 09:00:00.038 | 38ms |
| 앱 표시·저장 | 09:00:00.045 | 45ms |
위 숫자는 구조를 이해하기 위한 예시일 뿐 실제 지연 보장이 아닙니다. REST는 현재가·과거 데이터처럼 요청 후 응답받는 조회에 주로 쓰이고, WebSocket은 연결을 유지하면서 체결·호가 갱신을 실시간으로 받는 데 적합합니다. API별 제공 항목, 호출 제한과 메시지 순서는 공식 명세를 따라야 합니다.
앱 화면에 보이는 시각이 곧 거래소에서 사건이 발생한 정확한 시각이라고 단정할 수 없습니다. 거래소 시각, 증권사 제공 시각, 앱 수신 시각과 PC 시각은 서로 다를 수 있습니다.
- 실시간 갱신을 지속적으로 받는 데 주로 쓰는 연결은 무엇인가요?
- App Secret을 영상이나 문의 글에 올려도 되나요?
정답 보기
WebSocket이며, App Secret은 절대 공개하면 안 됩니다.
실시간 수신 상태와 저장 시작 시각을 기록하세요. 네트워크를 통한 실시간 수신과 저장 파일 리플레이를 구분하고, 기록하지 않은 과거 호가가 나중에 자동으로 만들어지지 않는 이유를 데이터 경로로 설명해 보세요.
2. 체결 데이터와 호가 데이터
체결 이벤트와 주문장 스냅숏·갱신을 구분하고 거래량과 잔량을 혼동하지 않습니다.
체결 데이터는 실제로 매수자와 매도자가 만나 거래된 가격·수량·시각을 나타냅니다. 모든 체결에는 반드시 매수자와 매도자가 함께 있습니다. 호가 데이터는 아직 체결되지 않은 매수·매도 주문의 가격과 잔량을 보여 줍니다.
| 시각 | 메시지 | 해석 |
|---|---|---|
| 09:05:00.100 | 매도 10,010원 잔량 300→200 | 잔량 감소 100주; 원인은 추가 정보로 확인 |
| 09:05:00.105 | 체결 10,010원 60주 | 매수자와 매도자 사이 60주 거래 |
| 09:05:00.110 | 매도 10,010원 잔량 200→240 | 새 매도 주문 등으로 40주 증가 |
첫 번째 잔량 감소 100주를 체결 100주라고 단정하면 안 됩니다. 예시에서 확인된 체결은 60주뿐이며 나머지는 취소, 정정 또는 메시지 처리 방식과 관련될 수 있습니다. 반대로 적극적 매수는 매도호가를 들어 올려 체결되고, 적극적 매도는 매수호가를 때려 체결됩니다. ‘매수 체결’도 반대편 매도자가 있어야 성립합니다.
| 상태 | 최우선 매도 | 최우선 매수 | 최근 체결 |
|---|---|---|---|
| 이전 | 10,010원 80주 | 10,000원 120주 | 10,000원 |
| 100주 적극 매수 후 가능 상태 | 10,020원 잔량 일부 감소 | 10,000원 120주 | 10,020원 |
호가 잔량 감소는 항상 체결이 아닙니다. 체결 없이 주문이 취소되거나 정정될 수 있으므로 체결 스트림과 호가 스트림을 함께 봐야 합니다.
- 호가 잔량과 거래량 중 실제 소유권 이전을 나타내는 것은 무엇인가요?
- 적극적 매도는 어느 호가를 때리나요?
정답 보기
거래량이며, 적극적 매도는 매수호가를 때립니다.
재생을 20틱 진행하며 호가 변화와 체결을 두 열에 따로 기록하세요. 잔량이 줄었지만 같은 시각대 체결로 모두 설명되지 않는 사례를 찾아 ‘확인 불가’를 표시하는 연습을 하세요.
3. OHLCV와 봉 만들기
일정 구간의 체결에서 시가·고가·저가·종가·거래량(OHLCV)을 직접 계산할 수 있습니다.
봉은 정해진 구간의 체결을 요약합니다. 시가(Open)는 구간 첫 체결가, 고가(High)는 최고 체결가, 저가(Low)는 최저 체결가, 종가(Close)는 마지막 체결가입니다. 거래량(Volume)은 그 구간에 체결된 수량의 합입니다.
| 시각 | 체결가 | 체결량 |
|---|---|---|
| 09:10:05 | 10,000원 | 20주 |
| 09:10:17 | 10,020원 | 30주 |
| 09:10:31 | 9,990원 | 10주 |
| 09:10:58 | 10,010원 | 40주 |
| 09:10 1분봉 | O 10,000 / H 10,020 / L 9,990 / C 10,010 | V 100주 |
봉의 몸통은 시가와 종가, 꼬리는 고가와 저가를 표현합니다. 종가가 시가보다 높아도 구간 내내 상승한 것은 아닙니다. 위 예시는 10,020원까지 올랐다가 9,990원까지 내려간 뒤 10,010원으로 끝났습니다. 거래대금은 보통 각 체결의 가격×수량을 합산하므로 단순히 종가×거래량과 같지 않을 수 있습니다.
1분봉의 고가는 그 1분 동안의 가장 높은 매도호가가 아니라 가장 높은 체결가입니다. 호가만 올라갔고 체결되지 않았다면 OHLC에 반영되지 않습니다.
- 예시의 시가와 종가는 얼마인가요?
- 체결량 5주, 15주, 30주가 있으면 해당 봉의 거래량은 얼마인가요?
정답 보기
시가 10,000원, 종가 10,010원이며 거래량은 50주입니다.
1분 구간을 선택해 체결 목록에서 첫가·최고가·최저가·마지막가와 수량 합계를 직접 구하세요. 앱의 1분봉과 비교하고 경계 시각, 누락 데이터 또는 집계 기준 차이가 있으면 기록하세요.
4. 틱·초·분·일봉과 데이터 품질
틱봉·초봉·분봉·일봉의 집계 기준을 구분하고 누락·중복·순서·구간 경계 문제를 점검할 수 있습니다.
| 봉 종류 | 구간 기준 | 예시 | 주의점 |
|---|---|---|---|
| 틱봉 | 정해진 체결 이벤트 수 | 10틱봉 = 체결 10건씩 | 10주가 아니라 보통 10건; API·앱 정의 확인 |
| 초봉 | 시간(초) | 5초봉 = 09:00:00~04 구간 등 | 체결 없는 구간 처리 방식 확인 |
| 분봉 | 시간(분) | 1분봉 = 09:00:00~09:00:59… | 경계 시각과 세션 기준 확인 |
| 일봉 | 거래일·세션 | 한 거래일의 OHLCV | 정규장 외 거래, 수정주가 기준 확인 |
틱봉은 시간이 아니라 체결 건수를 기준으로 하므로 거래가 활발할 때는 10틱이 0.1초 안에 만들어지고, 한산할 때는 수분이 걸릴 수 있습니다. 초봉·분봉은 시간이 기준이라 같은 길이의 시간 구간을 비교하지만 체결 건수는 다릅니다. 일봉은 거래일의 데이터를 요약하며 액면분할·배당 등 기업행동을 반영한 수정주가 사용 여부에 따라 과거 값이 달라질 수 있습니다.
| 품질 검사 | 숫자 예시 | 확인 방법 |
|---|---|---|
| 누락 | 수신 순번 101, 102, 104 | 103 누락 가능성 조사 |
| 중복 | 동일 식별자 205가 2회 | 중복 저장 여부 확인 |
| 순서 | 09:01:00.200 뒤 .150 도착 | 발생 시각과 수신 순서를 분리 |
| 봉 검산 | O 100, H 98 | 고가는 시가보다 낮을 수 없으므로 오류 |
완전한 봉이라면 고가는 O·C·L 이상이고 저가는 O·C·H 이하이며, 거래량은 음수가 될 수 없습니다. 단, 실제 API의 부호 표기나 정정 데이터는 명세에 맞게 먼저 정규화해야 합니다. 저장 중 네트워크가 끊기면 빈 구간을 임의 가격으로 채우지 말고 누락 상태를 보존하는 것이 분석에 더 정직합니다.
1틱은 주가의 최소 변동 단위라는 뜻으로도 쓰이지만, ‘틱봉’에서 틱은 보통 체결 이벤트 한 건을 뜻합니다. 문맥과 프로그램의 정의를 반드시 확인하세요.
- 100틱봉은 보통 몇 분을 뜻하나요?
- O=10,000, H=10,100, L=9,900일 때 C=10,200은 유효한가요?
정답 보기
고정된 분 수가 아니라 체결 100건 기준입니다. C가 H보다 높으므로 주어진 OHLC 조합은 유효하지 않습니다.
같은 구간을 10틱봉과 1분봉으로 바꿔 봉 개수와 각 봉의 시간 폭을 비교하세요. 이후 저장 데이터의 시작·종료 시각, 긴 무체결 구간, 비정상 OHLC가 있는지 점검표를 작성하세요.
공식 자료와 학습 유의사항
- 한국거래소(KRX) 한국 주식시장 거래 안내 — 시장 운영과 거래 데이터가 생성되는 제도적 배경
- 키움 REST API 가이드 — OAuth, REST 요청과 WebSocket 실시간 시세의 공식 명세
시세 데이터와 차트는 과거와 현재의 거래를 요약할 뿐 미래 가격이나 수익을 보장하지 않습니다. 이 교재와 IUreplay는 교육·훈련용이며 종목 추천, 투자 자문 또는 자동 매매 신호가 아닙니다. 실제 데이터는 지연·누락·정정될 수 있고 실제 거래에는 미체결, 슬리피지, 수수료와 세금이 발생합니다. 모든 투자 판단과 책임은 사용자에게 있습니다.