키움 실시간 주문체결 00 — 잔고 04와 주문상태 913

키움 REST API 실시간 시세 — 0B·0D 등록과 FID에서 접속·로그인·REG 등록까지의 공통 절차를 다뤘습니다. 이 글은 그중 시세가 아니라 내 계좌에서 벌어진 일을 받는 두 항목만 떼어 정리한 것입니다. 체결 알림을 텔레그램으로 보내거나, 주문을 낸 뒤 붙었는지 확인하려면 결국 여기로 옵니다.

0B와 00은 이름만 비슷하고 완전히 다르다

가장 먼저 정리해야 할 혼동입니다. 둘 다 "체결"이라는 단어가 들어가지만 성격이 반대입니다.

공식 명세는 00 설명에 "ACCESS TOKEN 발급과 상관없이 해당 종목의 체결내역을 보고싶으신 경우에 0B를 이용 부탁드립니다"라고 친절하게 갈라 적어 두었습니다. 남의 체결을 보려면 0B, 내 주문을 보려면 00입니다.

등록 패킷 — item은 비운다

# 주문체결(00)과 잔고(04)를 함께 등록
{
  "trnm": "REG",
  "grp_no": "2",          # 시세용 그룹과 분리해 두면 해지가 쉽다
  "refresh": "1",
  "data": [{"item": [], "type": ["00", "04"]}]
}

item에 값을 넣어도 무시되지만, 넣지 않는 편이 의도가 분명합니다. 공식 파이썬 예제(subscribe_domestic_order_fill_pubsub.py)도 "data": [{"item": [], "type": ['00']}]로 빈 배열을 씁니다.

주문체결(00) FID — 실제로 쓰는 것만

실시간 메시지는 이렇게 들어옵니다.

{
  "trnm": "REAL",
  "data": [{
    "type": "00",
    "name": "주문체결",
    "item": "005930",
    "values": {
      "9201": "1234567890",   # 계좌번호
      "9203": "0000123",      # 주문번호
      "9001": "A005930",      # 종목코드
      "913": "체결",           # 주문상태
      "900": "10",            # 주문수량
      "901": "72000",         # 주문가격
      "902": "4",             # 미체결수량  ← 0이면 끝난 주문
      "910": "72000",         # 체결가
      "911": "6",             # 체결량      ← 이번 이벤트분
      "909": "0000045",       # 체결번호
      "904": "0000000",       # 원주문번호 (정정·취소일 때 채워짐)
      "938": "108",           # 당일매매수수료
      "939": "0"              # 당일매매세금
    }
  }]
}

한 주문에 이벤트가 여러 번 온다

공식 명세가 접수·체결·정정·취소를 모두 수신 대상으로 적고 있습니다. 10주 지정가 매수 하나를 내면 실제로는 대략 이런 순서로 들어옵니다.

seen = set()          # 이미 처리한 (주문번호, 체결번호)
orders = {}           # 주문번호 -> 상태

def on_order_event(v):
    ono  = v.get("9203")                       # 주문번호
    fill = v.get("909")                        # 체결번호
    key  = (ono, fill)
    if fill and key in seen:                   # 중복 이벤트는 버린다
        return
    if fill:
        seen.add(key)

    st = orders.setdefault(ono, {"code": v.get("9001"), "filled": 0, "fee": 0})
    if v.get("919"):                           # 거부사유가 있으면 체결이 아니다
        st["rejected"] = v["919"]
        return

    if v.get("911"):
        st["filled"] += int(v["911"])          # 참고용 누적
    st["remaining"] = int(v.get("902") or 0)   # 판정은 항상 이 값으로
    st["fee"]  = int(v.get("938") or 0)
    st["tax"]  = int(v.get("939") or 0)
    st["done"] = st["remaining"] == 0          # 완료 판정

잔고(04) FID — 체결이 있을 때만 온다

04는 주문 체결이 발생할 경우에 수신된다고 명세에 적혀 있습니다. 보유 종목의 시세가 움직이는 것만으로는 오지 않습니다.

실시간만으로는 부족한 구간

실시간은 붙어 있는 동안의 사건만 밀어 줍니다. 다음 세 구간은 구조적으로 공백이 생깁니다.

• 봇 재시작 사이 — 프로세스가 죽어 있던 동안의 체결은 다시 오지 않습니다.
• 재접속 사이 — 소켓이 끊기면 등록도 사라지므로 LOGIN → REG를 다시 해야 하고, 그 몇 초의 사건은 놓칩니다.
• 수동 주문 — HTS·MTS에서 사람이 낸 주문도 같은 계좌면 옵니다. 봇이 모르는 주문번호가 들어와도 죽지 않도록 방어하십시오.

그래서 실무 구성은 실시간을 신호로, REST를 정답으로 쓰는 이중화입니다. 복귀 직후 체결내역 kt00009와 미체결 ka10075로 상태를 한 번 맞추고, 다음 주문 수량은 내부 장부가 아니라 조회 결과로 계산합니다. 실현손익 집계는 실현손익 ka10072 쪽이 기준입니다.

자주 묻는 질문

모의투자에서도 00·04가 오나요?

모의 도메인은 wss://mockapi.kiwoom.com:10000이고, 실전 키로 모의에 붙으면 8030·8031(투자구분이 달라 앱키·토큰 사용 불가)로 막힙니다. 또 공식 오류 코드에 8104(모의투자에서 지원하지 않는 API)가 있으므로, 모의에서 되는 범위는 계정 기준으로 직접 확인하시는 편이 안전합니다.

계좌가 여러 개면 어떻게 되나요?

수신 기준이 ACCESS TOKEN을 발급한 계좌이므로 9201(계좌번호)로 구분됩니다. 봇이 특정 계좌만 다룬다면 9201이 내 계좌인지 먼저 검사하고 아니면 무시하십시오.

수수료·세금이 실시간으로 정확한가요?

938·939는 당일 기준값입니다. 정산·환급이나 세금 계산 규정에 따라 최종 금액과 달라질 수 있으니, 성과 집계는 실시간 값이 아니라 조회 API 결과로 다시 맞추십시오. 비용을 빼먹은 백테스트가 왜 위험한지는 백테스트 거래비용 반영에 정리해 두었습니다.

2026-08-29 기준으로 키움증권 공식 저장소(Kiwoom-Securities/Kiwoom-REST-API)가 배포하는 API 명세 kiwoom/_data/kiwoom_api_spec.json의 실시간 항목 주문체결(00)·잔고(04) 원문과 공식 예제 examples/국내주식/실시간시세/subscribe_domestic_order_fill_pubsub.py의 항목 매핑에서 확인한 필드명·FID·설명을 기준으로 작성했습니다. 본문의 코드는 구조를 보여주기 위한 예시이며 그대로 실전에 쓰라는 뜻이 아닙니다. FID 구성·수신 조건·모의투자 지원 범위는 증권사 공지로 예고 없이 바뀝니다. 운영 전 개발자 포털의 현재 명세로 대조하십시오. 이 글은 수익이나 시장 방향을 예측하지 않으며 세무 상담이 아닙니다.