미니코스피 자동매매 증권사 비교 — API 주간·야간·모의

이 질문은 상담에서 그대로 들어옵니다. "미니코스피로 자동매매하려는데 어느 증권사로 해야 하나요?" 손으로 HTS에서 미니선물을 하던 분이 자동화를 결심하면, 대개 지금 쓰는 증권사 API로 되는지부터 묻습니다. 그런데 HTS에서 미니선물이 되는 것과 API로 미니선물 주문이 되는 것은 별개이고, 야간까지 가면 갈리는 폭이 더 커집니다.

이 글은 그 질문 하나만 답합니다. 증권사 다섯 곳을 주간 주문·야간 주문·모의투자·실시간 시세 네 칸으로 나눠, 각 칸을 어디서 확인했는지 출처와 함께 적었습니다. 확인하지 못한 칸은 추측하지 않고 '미확인'으로 남겼습니다. 증권사 API 전반의 차이는 국내 증권사 API 비교에 있습니다.

2026-11-10 기준으로 각 증권사 공식 저장소·공식 명세(openapi.json)·공식 개발가이드를 읽어 정리했습니다. 실계좌 호출로 검증한 칸은 따로 표시했습니다. API 지원 범위는 증권사 공지로 바뀌므로 계약 전에 다시 확인하십시오. 선물은 손실이 원금을 넘을 수 있는 상품입니다. 알고랩은 프로그램 제작 도구를 제공하며 투자자문업·투자일임업을 영위하지 않습니다.

1. 미니코스피200 선물, 봇이 알아야 할 숫자

증권사를 고르기 전에 상품 자체에서 프로그램에 박아야 하는 값이 몇 개 있습니다. 증권사 상품 안내에 공통으로 나오는 명세는 이렇습니다.

본물이 매 분기 만기인 데 비해 미니는 매달 만기라 월물 교체가 1년에 12번 옵니다. 종목코드를 하드코딩한 봇은 두 번째 목요일 다음 날부터 빈 시세를 받습니다. 그래서 어느 증권사든 종목 마스터에서 그날의 최근월물 코드를 받는 절차가 필요하고, 증권사마다 그 마스터가 어디 있는지가 다릅니다(아래 각 절에 적었습니다).

2. 증권사 5곳 한눈에 — 주간·야간·모의·시세

3. 한국투자증권 KIS — 주간·야간 TR이 갈린다

KIS는 미니 선물을 별도 API로 나누지 않습니다. 국내 선물옵션 API 하나로 본물·미니·코스닥150을 다 다루고, 종목코드로 상품을 가릅니다. 공식 저장소의 종목 마스터 정의 파일 stocks_info/종목마스터정보(지수선물옵션).h에 미니가 따로 표시돼 있습니다.

종목마스터정보(지수선물옵션).h — KIS 공식 저장소 원문 일부

char    info_type[1];   /* 1:지수선물 2:지수SP 3:스타선물 4:스타SP  */
                        /* 5:지수콜옵션 6:지수풋옵션                */
                        ...
                        /* B:미니선물 C:미니SP                      */
                        /* D:미니콜옵션 E:미니풋옵션                */
char    shrn_iscd[SZ_SHRNCODE]; /* 단축코드 */
char    mmsc_cls_code[1];  /* 월물구분코드 (0:연결선물, 1:최근월물 ... */

즉 마스터 파일에서 info_type == "B"이고 mmsc_cls_code == "1"(최근월물)인 행의 shrn_iscd가 오늘 주문할 미니 선물 코드입니다. 이 코드를 주문 본문의 SHTN_PDNO에 넣습니다. 시세 조회 쪽은 시장 구분값이 따로 있어, 공식 Postman 샘플의 설명에 MKI(미니KOSPI200)가 적혀 있습니다.

mini_order_kis.py — 구조 예시 (계좌·토큰은 플레이스홀더)

DAY   = {"order": "TTTO1101U", "cancel": "TTTO1103U", "balance": "CTFO6118R"}
NIGHT = {"order": "STTN1101U", "cancel": "TTTN1103U", "balance": "CTFN6118R"}
PAPER = {"order": "VTTO1101U", "cancel": "VTTO1103U", "balance": "VTFO6118R"}

def mini_code(master_rows):
    # info_type B = 미니선물, mmsc_cls_code 1 = 최근월물
    return next(r["shrn_iscd"] for r in master_rows
                if r["info_type"] == "B" and r["mmsc_cls_code"] == "1")

body = {
    "ORD_PRCS_DVSN_CD": "02",
    "CANO": "<계좌 앞 8자리>", "ACNT_PRDT_CD": "<뒤 2자리>",
    "SLL_BUY_DVSN_CD": "02",          # 01 매도 · 02 매수
    "SHTN_PDNO": mini_code(rows),      # 주식의 PDNO가 아니다
    "ORD_QTY": "1", "UNIT_PRICE": "0", # 시장가는 0
    "NMPR_TYPE_CD": "02", "KRX_NMPR_CNDT_CD": "0", "ORD_DVSN_CD": "02",
}
tr_id = NIGHT["order"] if is_night_session() else DAY["order"]

함정은 야간입니다. 야간 주문은 STTN인데 야간 정정취소는 TTTN, 야간 잔고는 CTFN이라 문자열 치환으로 만들면 틀립니다. 그리고 모의투자 TR은 주간에만 있습니다. 공식 예제 examples_llm/domestic_futureoption/order/order.py는 모의(env_dv="demo")에서 야간을 요청하면 ValueError("ord_dv can only be 'day' for demo environment")를 냅니다. 그래서 야간 로직은 실계좌 최소 수량(미니 1계약)으로 확인하는 단계를 따로 잡아야 합니다. 실시간도 갈려서 주간 체결은 H0IFCNT0, 야간 선물 체결은 H0MFCNT0, 야간 체결통보는 H0MFCNI0입니다. 주간 주문 필드는 KIS 선물옵션 주문 TTTO1101U 함정 6가지, 야간 배선은 KIS 야간선물옵션 API에 자세히 있습니다.

알고랩은 KIS로 미니코스피200 주간·야간 자동매매를 납품했습니다. 그때 겪은 문제(청산 주문 타임아웃 재전송으로 1계약이 5계약 매도된 일, 야간 분봉을 API가 주지 않는 문제)는 한투 KIS 미니코스피200 선물 제작 사례에 정리했습니다.

4. NH투자증권 PLUG — 미니 전용 실시간 채널

NH투자증권의 NH PLUG는 국내파생 명세를 https://www.nhplug.com/openapi-docs/krfuture/openapi.json으로 공개합니다. 다섯 곳 중 유일하게 실시간 채널이 미니 전용으로 따로 있습니다.

주문은 주간 /krfuture/order/v1/day, 야간 /krfuture/order/v1/night로 경로가 나뉩니다. 본문은 Input_0 안에 넣습니다.

POST /krfuture/order/v1/day — openapi.json 필드 기준 예시

{
  "Input_0": {
    "act_no": "<계좌 11자리>",   // /n2/acctinfo 의 acct_no
    "sby_dit_cd": "2",              // 1 매도 · 2 매수
    "iem_cd": "<미니 최근월물 코드>",
    "orr_qty": 1,
    "orr_pr": 0,
    "fno_nmn_pr_tp_cd": "M",        // L 지정가 · M 시장가 · B 최유리 · C 조건부
    "frs_orr_cnd_dit_cd": "0"       // 0 일반 · 1 IOC · 2 FOK
  }
}

웹소켓 구독은 {"header":{"token":"<access_token>","tr_type":"1"},"body":{"tr_cd":"hC","tr_key":"<종목코드>"}} 형식이고, 경로 /websocket을 빼면 접속이 안 됩니다. 종목 목록 REST API는 없고 정적 마스터 파일(https://www.nhplug.com/instruments/)을 받아 씁니다.

5. LS·키움·유안타 — 확인된 것과 안 된 것

LS증권 OPEN API — 납품으로 확인

LS증권은 알고랩이 OPEN API(REST+WebSocket)로 KOSPI200 선물 자동매매를 납품한 곳입니다. 미니와 본물을 2계좌로 나눠 각각 다른 설정으로 돌렸고, 주간과 KRX 야간 세션을 모두 자동으로 처리했습니다. 개발 중 확인한 제약은 하나입니다. LS 모의 환경은 선물 시장가 주문을 받지 않아 현재가 ±틱 지정가로 바꿔 내고 미체결이면 다시 내는 폴백을 넣었습니다. 야간 모의 지원 여부는 이 글에서 확인하지 못했습니다. LS는 앱키에 따라 실전·모의 서버가 자동으로 갈리므로 설정 파일에 모드를 명시해 두는 편이 안전합니다. 자세한 내용은 LS증권 KOSPI200 선물 자동매매 사례와 LS증권 OPEN API REST 주문 가이드에 있습니다.

키움증권 — REST는 선물이 없다

키움 REST API의 공식 저장소 Kiwoom-Securities/Kiwoom-REST-API는 2026-11-10 현재 examples/ 최상위가 OAuth 인증·국내주식·미국주식 세 개뿐입니다. 선물옵션 예제가 없습니다. 구형 OpenAPI+(32bit COM)는 개발가이드 1.7에 GetFutureList(지수선물 코드 목록, 예시 101J9000)와 체결 구분 FJ:선물옵션이 있지만, 메서드 표의 주문 함수는 SendOrder·SendOrderCredit(둘 다 주식)뿐입니다. 미니선물 주문이 되는지는 가이드로 확인하지 못했습니다. 야간은 키움 OpenAPI 공식 게시판 답변(2026-06-11)이 "현재 야간선물 상품 지원계획은 없습니다"입니다.

유안타증권 티레이더 Open API — 착수 전 확인 필요

유안타증권 티레이더 Open API는 COM 방식이고, TR 목록이 공개 웹 문서가 아니라 설치형 개발 도구 안에만 있습니다. 그래서 미니 선물 주문·실시간 체결·실시간 호가 TR이 있는지는 이 글에서 확인하지 못했습니다. 유안타로 미니코스피 자동매매를 맡기려면 계약 전에 실시간 호가 TR부터 확인하는 단계를 넣으십시오. 호가가 안 들어오면 상대호가·대기호가 같은 주문 방식은 만들 수 없습니다.

대신증권 CybosPlus도 선물옵션 데이터는 강하지만 야간 API 지원은 공식 문서로 확인되지 않았습니다. 정리한 내용은 대신·LS증권 API 가이드에 있습니다.

6. 고르는 기준 3가지

1. 야간을 돌릴 건가. 야간까지면 KIS·NH·LS 중에서 고릅니다. 키움은 빠집니다. 어느 쪽이든 야간은 실계좌 1계약 검증 일정을 따로 잡아야 합니다.
2. 어디서 돌릴 건가. KIS·NH·LS는 REST라 리눅스 VPS에서도 돕니다. 유안타 티레이더나 키움 OpenAPI+ 같은 COM 방식은 32bit 윈도우 PC가 켜져 있어야 합니다. 24시간 운영이면 이 차이가 운영비로 이어집니다.
3. 지금 쓰는 증권사를 바꿀 수 있나. 수수료 우대나 기존 계좌 때문에 증권사를 못 바꾸는 경우가 많습니다. 그렇다면 위 표에서 '미확인' 칸을 계약 전에 먼저 확인하는 순서로 갑니다. 확인 없이 착수하면 개발 중간에 증권사를 바꾸게 될 수 있습니다.

견적 전에 정할 나머지는 자동매매 견적 전에 정할 5가지, 레버리지 상품에 넣어야 할 안전장치는 선물·레버리지 자동매매 가이드에 있습니다.

자주 묻는 질문