키움 ka10065 장중투자자별매매상위 — 1이 순매수다

1. ka10065는 무엇을 주나

"지금 장중에 외국인이 가장 많이 사고 있는 종목"을 한 번에 뽑는 순위 TR입니다. 응답 배열 이름은 opmr_invsr_trde_upper(장중 투자자 매매 상위)입니다. 키움 영웅문 도움말의 같은 화면(장중투자자별매매상위, 잠정)은 이 데이터를 거래소 내 상주회원사 기준으로 집계한 추정치이고 장중 정해진 시간에 주기적으로 갱신된다고 설명합니다. 즉 확정치가 아니라 잠정치이고, 실시간 체결처럼 매 순간 바뀌지도 않습니다. 비슷한 수급 TR과 나란히 놓으면 쓰임새가 갈립니다.

ka10065는 순위정보 TR 묶음 /api/dostk/rkinfo에 속합니다. 같은 경로의 TR 23개 전체 구성은 키움 rkinfo 순위정보 TR 모음에 정리했습니다.

2. 요청·응답 실물

명세의 request_example 원문입니다.

POST https://api.kiwoom.com/api/dostk/rkinfo
api-id: ka10065
authorization: Bearer {접근토큰}

{
    "trde_tp": "1",
    "mrkt_tp": "000",
    "orgn_tp": "9000",
    "amt_qty_tp": "1"
}

response_example 원문입니다(7행 중 3행).

{
    "opmr_invsr_trde_upper": [
        {
            "stk_cd": "005930",
            "stk_nm": "삼성전자",
            "sel_qty": "-39420",
            "buy_qty": "+73452",
            "netslmt": "+34033"
        },
        {
            "stk_cd": "005930",
            "stk_nm": "삼성전자",
            "sel_qty": "-13970",
            "buy_qty": "+25646",
            "netslmt": "+11676"
        },
        ...
        {
            "stk_cd": "005930",
            "stk_nm": "삼성전자",
            "sel_qty": "-27306",
            "buy_qty": "+34853",
            "netslmt": "+7547"
        }
    ],
    "return_code": 0,
    "return_msg": "정상적으로 처리되었습니다"
}

응답 필드는 stk_cd·stk_nm·sel_qty·buy_qty·netslmt 다섯 개가 전부입니다. 순위 번호, 현재가, 등락률이 없으므로 "외국인 순매수 상위인데 오늘 내린 종목" 같은 조건은 ka10001 주식기본정보 등으로 종목마다 한 번 더 조회해야 합니다.

3. 함정 6가지

① trde_tp "1"의 뜻이 TR마다 셋으로 갈린다

명세 337개 TR에서 투자자·거래원 계열의 trde_tp 설명을 전수로 모았습니다.

가장 헷갈리는 쌍이 ka10065와 ka10064입니다. 둘 다 "장중 투자자별 매매"이고 메뉴 이름도 상위·차트만 다른데, ka10064에 ka10065용 상수 "1"을 넣으면 순매수가 아니라 총매수 시계열이 옵니다. 반대로 ka10058에 같은 "1"을 넣으면 순매도 종목 목록이 옵니다. 세 경우 모두 에러 없이 정상 응답(return_code 0)이라 값만 보고는 알아채기 어렵습니다. 수급 TR 여러 개를 함수 하나로 감쌀 때는 "순매수"를 TR별 코드로 바꿔 주는 표를 따로 두십시오.

② 개인 코드가 없다 — 외국계 9100은 여기만 있다

orgn_tp 11개를 다른 투자자 코드표와 비교하면 차이가 보입니다.

명세 전체에서 9100을 받는 곳은 ka10065 하나, 8000(개인)을 받는 곳은 ka10058 하나입니다. "장중 개인 순매수 상위"는 ka10065로 받을 수 없고, 명세에 없는 8000을 넣었을 때 서버가 어떻게 답하는지도 문서에 없습니다. 또 9100 외국계는 외국인 투자자(9000)가 아니라 외국계 증권사 창구 쪽 개념으로 읽히는데, 명세에 정의가 따로 없으니 둘을 합치거나 같은 뜻으로 쓰지 마십시오. 외국계 창구 데이터의 성격은 ka10040 거래원 글을 참고하십시오.

③ amt_qty_tp는 선택이지만 항상 넣는다

금액·수량 구분을 받는 TR 16개 중 amt_qty_tp가 선택(required N)인 곳은 ka10065와 ka90013 둘뿐이고 나머지 14개는 필수입니다. 빼고 보내면 금액으로 오는지 수량으로 오는지 명세에 없습니다. 공식 예제 함수도 기본값을 amt_qty_tp: str | None = '1'(금액)로 두고 있으니 직접 호출할 때도 늘 명시하는 편이 안전합니다. 필드 이름이 sel_qty·buy_qty라 "수량"처럼 보이지만, "1"을 넣으면 이 칸에 금액(백만원)이 들어옵니다. 명세 한글명도 '매도금액/매도량'입니다.

④ 순매수 = 매수 + 매도, 그런데 ±1 어긋난다

sel_qty는 음수 부호로 옵니다. 그래서 순매수는 buy_qty − sel_qty가 아니라 buy_qty + sel_qty입니다. 공식 응답 예시 7행을 그대로 검산했습니다(Python 3.10.4, 2026-10-26).

buy  73452 + sel  -39420 =  34032  netslmt  34033  diff +1
buy  25646 + sel  -13970 =  11676  netslmt  11676  diff +0
buy  21167 + sel  -10063 =  11104  netslmt  11104  diff +0
buy  47604 + sel  -37542 =  10062  netslmt  10061  diff -1
buy  10874 + sel   -2310 =   8564  netslmt   8564  diff +0
buy  33114 + sel  -24912 =   8202  netslmt   8203  diff +1
buy  34853 + sel  -27306 =   7547  netslmt   7547  diff +0

7행 중 3행이 1씩 어긋납니다. 원 단위 매수·매도·순매수를 각각 백만원으로 반올림해 보내면 이런 차이가 생깁니다(예를 들어 원 단위 값이 매수 73,452.4백만, 매도 −39,419.6백만이었다면 각각 73,452와 −39,420으로 반올림되지만 순매수 34,032.8은 34,033이 됩니다). 합계 검사를 ==로 걸면 정상 데이터를 오류로 버리게 되니 abs(차이) <= 1로 두십시오. 같은 백만원 반올림 문제는 짝 순위 TR인 ka10062의 금액 0 문제에서도 나옵니다. 참고로 netslmt 설명은 단위를 "trde_tp파라미터로 설정"이라고 적고 있는데, 다른 두 필드처럼 amt_qty_tp의 오기로 보입니다.

⑤ 문자열 그대로 정렬하면 순위가 뒤집힌다

string sort desc:  ['+8564', '+8203', '+7547', '+34033', '+11676', '+11104', '+10061']
numeric sort desc: [34033, 11676, 11104, 10061, 8564, 8203, 7547]

값이 "+34033" 같은 부호 붙은 문자열이라 pandas에서 그대로 sort_values를 하면 사전순이 됩니다. 1위 34,033이 4위로 밀립니다. 공식 예제의 NUMERIC_COLUMNS에도 '매도금액/매도량'·'매수금액/매수량' 두 개만 있고 '순매수/순매도'는 빠져 있습니다. 응답 자체는 순매수 내림차순으로 오지만, 여러 시장(001·101)을 합쳐 다시 정렬하는 순간 이 문제가 드러납니다. 숫자로 바꾼 뒤 정렬하십시오.

⑥ stex_tp가 없고, 예시 종목은 전부 005930이다

• 거래소 구분 없음: rkinfo TR 23개 중 17개가 stex_tp(1:KRX, 2:NXT, 3:통합)를 받는데, ka10065는 mrkt_tp는 받으면서 stex_tp는 없습니다(이런 TR은 ka10065와 ka10098 둘). KRX만 집계인지 NXT 포함인지 명세에 없으니, NXT 체결이 늘어나는 구간에서는 HTS 화면과 대조해 보십시오(NXT·KRX 주문 라우팅).
• 예시 7행이 모두 005930: 예시는 자리채움이라 실제로는 행마다 다른 종목이 옵니다. 예시로 중복 제거나 종목명 매핑 테스트를 만들면 7행이 1행으로 줄어 테스트가 의미 없게 됩니다.
• 연속조회: 공식 예제는 MAX_PAGES = 10, 요청 간격 REQUEST_DELAY_SECONDS = 0.2로 cont-yn·next-key를 따라갑니다(연속조회 글).

4. 안전하게 받는 코드

토큰은 환경변수에서 읽고 ①~⑤를 코드에서 막습니다. 응답 해석부(parse)는 명세의 response_example로 실행해 확인했습니다.

import os, time, requests
import pandas as pd

BASE  = "https://api.kiwoom.com"                     # 모의: https://mockapi.kiwoom.com
NET   = {"buy": "1", "sell": "2"}                    # ① ka10065 전용 (ka10064는 0이 순매수)
ORGN  = {"외국인": "9000", "외국계": "9100", "금융투자": "1000", "투신": "3000",
         "기타금융": "5000", "은행": "4000", "보험": "2000", "연기금": "6000",
         "국가": "7000", "기타법인": "7100", "기관계": "9999"}   # ② 개인 없음
NUM   = ["sel_qty", "buy_qty", "netslmt"]

def parse(rows):
    df = pd.DataFrame(rows)
    for c in NUM:                                      # ⑤ 문자열 → 숫자
        df[c] = pd.to_numeric(df[c].str.replace("+", "", regex=False), errors="coerce")
    gap = df["netslmt"] - (df["buy_qty"] + df["sel_qty"])   # ④ 매도는 음수
    bad = df[gap.abs() > 1]
    if len(bad):
        print("순매수 검산 불일치(±1 초과):", bad["stk_cd"].tolist())
    return df.sort_values("netslmt", ascending=False).reset_index(drop=True)

def ka10065(investor="외국인", side="buy", market="000", unit="1", max_pages=3):
    token = os.environ["KIWOOM_TOKEN"]
    body = {"trde_tp": NET[side], "mrkt_tp": market,
            "orgn_tp": ORGN[investor], "amt_qty_tp": unit}   # ③ 항상 명시
    rows, cont, key = [], None, None
    for _ in range(max_pages):
        h = {"api-id": "ka10065", "authorization": f"Bearer {token}",
             "Content-Type": "application/json;charset=UTF-8"}
        if cont == "Y":
            h.update({"cont-yn": "Y", "next-key": key})
        r = requests.post(BASE + "/api/dostk/rkinfo", headers=h, json=body, timeout=(3.05, 10))
        j = r.json()
        if j.get("return_code") not in (0, None):
            raise RuntimeError(f'ka10065 {j.get("return_code")} {j.get("return_msg")}')
        rows += j.get("opmr_invsr_trde_upper", [])
        cont, key = r.headers.get("cont-yn"), r.headers.get("next-key")
        if cont != "Y":
            break
        time.sleep(0.2)
    return parse(rows)

명세 예시 7행을 parse에 넣은 결과입니다. ±1 차이 3행은 경고 없이 통과하고 숫자 순으로 정렬됩니다.

   stk_cd stk_nm  sel_qty  buy_qty  netslmt
0  005930   삼성전자   -39420    73452    34033
1  005930   삼성전자   -13970    25646    11676
2  005930   삼성전자   -10063    21167    11104
3  005930   삼성전자   -37542    47604    10061
4  005930   삼성전자    -2310    10874     8564
5  005930   삼성전자   -24912    33114     8203
6  005930   삼성전자   -27306    34853     7547

장중 잠정치는 정해진 시각에 갱신되므로 몇 초 간격으로 계속 부를 이유가 없습니다. 투자자 유형 11개 × 시장 3개를 루프로 돌리면 한 번에 33회 호출이 되어 키움 429 호출 제한에 걸리기 쉬우니, 필요한 조합만 몇 분 간격으로 받는 구성을 권합니다. 장 마감 뒤 확정치는 ka10066(장마감후투자자별매매)이나 ka10058(일별)로 따로 받으십시오.

외국인이 장중에 순매수했다는 사실은 잠정 집계일 뿐 이후 가격을 알려 주지 않습니다. 이 글은 특정 종목이나 전략을 권하지 않으며, 수급 필터의 효과는 본인 데이터로 백테스트해 확인하십시오. 명세는 바뀔 수 있으니 키움 REST API 공식 문서로 현재 값을 확인하십시오.

5. 자주 묻는 질문