키움 0F 당일거래원 — FID 57개와 증감의 함정

REST의 ka10040(당일주요거래원)을 몇 초마다 부르다가 유량 제한에 걸리면 다음 후보가 0F입니다. 이 글은 0F 하나만 다룹니다. 웹소켓 접속과 LOGIN·PING은 키움 웹소켓 REG·FID 가이드를 먼저 보십시오.

1. FID 57개 — 번호가 붙어 있지 않다

kiwoom_api_spec.json의 주식당일거래원(0F) 응답을 그대로 옮겼습니다. 한 순위의 값이 나란히 있지 않고 항목별로 다섯 칸씩 띄엄띄엄 있어서, 순위 번호를 더해 찾아야 합니다.

나머지 7개는 다음과 같습니다.

271대의 색깔은 예시 값이 !!!!이고 명세에 설명이 없습니다. 파서에서 버려도 됩니다.

2. REG 패킷 — 명세 예시를 복사하면 안 된다

0s와 마찬가지로 명세의 요청 예시가 깨져 있습니다. data가 null이고 항목이 - item이라는 이상한 키로 빠져 있습니다.

# 명세 request_example (이대로 보내지 말 것)
{ "trnm": "REG", "grp_no": "1", "refresh": "1", "data": null, "- item": "005930", "- type": "0F" }

# 공식 예제 subscribe_domestic_stock_today_brokers_async.py
{ "trnm": "REG", "grp_no": "1", "refresh": "1",
  "data": [{ "item": ["005930"], "type": ["0F"] }] }

• item은 거래소별 종목코드입니다. 명세 설명에 따라 KRX 039490, NXT 039490_NX, SOR 039490_AL로 씁니다.
• refresh는 1입니다. 0은 기존 등록을 해지하므로 0B·0D를 쓰는 소켓에서 시세가 끊길 수 있습니다.
• 공식 예제의 주석 등록("0"이면 해제)은 명세의 REG·REMOVE와 맞지 않습니다. 해지는 "trnm": "REMOVE"로 보내십시오.
• 2026-07-02 기준 키움 공지(seqid 49)의 실시간 등록 상한은 200종목입니다. 다른 수치는 키움 429 유량 제한에 있습니다.

3. 거래원별증감이 수상하다

이 글을 쓰며 찾은 가장 중요한 점입니다. 명세 설명은 "단위: 1주, 부호가 포함된 숫자"뿐이고 무엇 대비 증감인지 적혀 있지 않습니다. 그래서 응답 예시의 숫자로 계산해 봤습니다.

매수 쪽도 같습니다. 2~4위의 별증감 -5,935, -13,918, -8,537,310이 윗 순위와의 차이와 모두 일치합니다. 1위와 5위는 맞지 않습니다. 또 4위 수량이 757,643주인데 증감이 -8,547,897주라면, '이 거래원의 직전 수량 대비 변화'로 읽기가 어렵습니다.

prev = {}  # (종목, 쪽, 거래원코드) → 직전 수량

def my_delta(stock, side, code, qty):
    key = (stock, side, code)
    delta = qty - prev[key] if key in prev else None   # 첫 수신은 비교 대상 없음
    prev[key] = qty
    return delta

순위는 바뀌므로 키를 순위가 아니라 거래원코드로 잡습니다. 수량이 5위 밖으로 밀린 거래원은 값이 오지 않아 변화를 볼 수 없다는 점도 함께 기억하십시오.

4. 파서와 실행 결과

예시의 1~4위는 거래원명이 비어 있고 코드만 있습니다. 표시에는 코드를 기본으로 쓰고 이름은 ka10102 회원사 목록으로 채우는 편이 안전합니다. 수량에는 +·-가 올 수 있고 int()는 둘 다 처리합니다.

SIDES = {"sell": (141, 161, 166, 146), "buy": (151, 171, 176, 156)}

def parse_0f(values):
    out = {}
    for side, (nm, qty, chg, cd) in SIDES.items():
        rows = []
        for i in range(5):
            rows.append({
                "rank": i + 1,
                "name": values.get(str(nm + i), ""),
                "code": values.get(str(cd + i), ""),
                "qty": int(values.get(str(qty + i)) or 0),
                "chg": int(values.get(str(chg + i)) or 0),
            })
        out[side] = rows
    out["foreign_net"] = int(values.get("267") or 0)
    return out

명세의 응답 예시를 넣어 실행한 출력입니다.

sell
  1 993 (빈값) qty=9350409 chg=+8593585 윗순위와차이=None
  2 994 (빈값) qty=9341349 chg=-9060 윗순위와차이=-9060
  3 991 (빈값) qty=9305540 chg=-35809 윗순위와차이=-35809
  4 992 (빈값) qty=757643 chg=-8547897 윗순위와차이=-8547897
  5 005 미래에셋 qty=100 chg=+0 윗순위와차이=-757543
buy
  1 993 (빈값) qty=9321128 chg=+8557163 윗순위와차이=None
  2 991 (빈값) qty=9315193 chg=-5935 윗순위와차이=-5935
  3 994 (빈값) qty=9301275 chg=-13918 윗순위와차이=-13918
  4 992 (빈값) qty=763965 chg=-8537310 윗순위와차이=-8537310
  5 005 미래에셋 qty=50100 chg=+0 윗순위와차이=-713865

5. 외국계 추정합과 337

261·263·267과 그 변동값은 이름 그대로 추정입니다. 외국인 전체 순매수의 확정치로 쓰면 안 됩니다. 확정치에 가까운 투자자별 수치는 다른 TR에서 보며, 외국계 창구 순위는 ka10037 외국계창구매매상위를 보십시오. 응답 예시는 여섯 값이 모두 0이라 예시로 계산식을 검증할 수 없었습니다. 267이 263에서 261을 뺀 값인지는 실서버에서 확인하십시오.

337은 예시 값이 2인데 설명이 비어 있습니다. 명세의 실시간 항목을 전부 훑어 보니 337이 있는 항목은 0F뿐이고 값표는 어디에도 없었습니다. 2가 어느 시장인지 추측하지 말고, 시장 구분은 등록한 item의 접미사(_NX, _AL)로 관리하십시오.

6. 재접속 — ka10040으로 초기값을 채운다

파서의 표는 0F 메시지를 받아야 채워지므로 접속 직후나 재접속 뒤에는 비어 있습니다. 메시지가 언제 오는지 주기도 명세에 없습니다. 그래서 먼저 REST로 초기값을 받습니다.

1. 소켓 접속과 LOGIN 응답을 확인합니다.
2. REG를 보낸 뒤 return_code 0을 확인합니다.
3. ka10040을 한 번 불러 코드별 수량 표를 채웁니다.
4. 이후 0F 수신분으로 표를 덮어씁니다. 재접속할 때마다 1~3을 반복합니다.

순서를 바꿔 REST를 먼저 부르면 그 사이의 변경을 놓칠 수 있습니다. 재접속 처리 전반은 봇 장애 복구 플레이북에 있습니다. 어느 증권사가 강한지를 하루치로 보려면 ka10039 증권사별매매상위, 대량 체결을 보려면 ka10052 거래원순간거래량이 맞습니다.

알고랩은 프로그램 제작 도구를 제공하며 투자자문업·투자일임업을 영위하지 않습니다. 거래원 수량은 창구 기준 정보이고 매매 주체나 향후 가격을 뜻하지 않습니다. 명세는 바뀔 수 있으니 wss://api.kiwoom.com:10000 실서버 또는 wss://mockapi.kiwoom.com:10000 모의 서버에서 실제 수신을 확인한 뒤 주문 로직에 연결하십시오.

자주 묻는 질문