미국주식 LOC 주문, 증권사 API마다 되는 범위가 다릅니다
세 곳 모두 됩니다. 미국주식 장마감 지정가(LOC) 매수는 한국투자증권 KIS API에서 ORD_DVSN 34, 키움 REST API에서 trde_tp 30, 토스증권 Open API에서 orderType LIMIT에 timeInForce CLS를 붙이면 나갑니다. LOC로 나눠 사는 분할매수를 봇으로 옮길 때 증권사를 가르는 건 LOC 매수 자체보다 그 주변입니다. 매도 쪽에 장마감 시장가(MOC)가 있는지, 모의투자에서 LOC를 시험할 수 있는지, 걸어 둔 주문의 수량을 정정할 수 있는지, 낮에 미리 넣어 둘 수 있는지가 세 곳이 다릅니다.
저희는 한투로 미국 3배 ETF 봇을 만들면서 정규장 보유분을 LOC로 종가에 정리하는 기능을 넣은 적이 있습니다. SOXL, SOXS 3세션 봇 사례입니다. 그때는 한투만 봤고, 이번에 키움과 토스까지 공식 문서 원문을 다시 대조했습니다. 2026년 11월 16일에 받은 파일 기준입니다.
세 곳의 LOC 매수 주문
같은 주문을 세 증권사 형식으로 적으면 이렇습니다. TQQQ 10주를 50.00달러 LOC로 사는 주문입니다. 계좌번호는 가렸습니다.
한국투자증권 KIS, POST /uapi/overseas-stock/v1/trading/order (tr_id TTTT1002U)
{
"CANO": "12345678",
"ACNT_PRDT_CD": "01",
"OVRS_EXCG_CD": "NASD",
"PDNO": "TQQQ",
"ORD_QTY": "10",
"OVRS_ORD_UNPR": "50.00",
"ORD_SVR_DVSN_CD": "0",
"ORD_DVSN": "34"
}
키움 REST, POST /api/us/ordr (api-id ust20000)
{
"stex_tp": "ND",
"stk_cd": "TQQQ",
"ord_qty": "10",
"trde_tp": "30",
"ord_uv": "50.00"
}
토스증권, POST /api/v1/orders
{
"symbol": "TQQQ",
"side": "BUY",
"orderType": "LIMIT",
"timeInForce": "CLS",
"quantity": "10",
"price": "50.00"
}
거래소 코드부터 서로 다릅니다. 한투는 주문에 NASD 네 글자를 쓰고, 키움은 ND 두 글자를 씁니다. 토스는 거래소를 받지 않고 티커만 받습니다. 한투에서 매수와 매도는 tr_id로 갈리고(TTTT1002U, TTTT1006U), 키움은 api-id로(ust20000, ust20001), 토스는 바디의 side로 갈립니다. 한 증권사 코드를 다른 곳으로 옮길 때 가장 먼저 깨지는 데가 여기입니다.
토스는 조합을 틀리면 이렇게 돌려줍니다. 공식 openapi.json(v1.2.28)에 실린 오류 예시 그대로입니다.
{
"error": {
"code": "invalid-request",
"message": "종가 주문(CLS)은 미국 주식 지정가 주문에만 사용할 수 있습니다.",
"data": {
"field": "timeInForce",
"allowedConditions": { "marketCountry": "US", "orderType": "LIMIT" }
}
}
}
그러니 토스에서 MARKET에 CLS를 붙여 장마감 시장가를 만드는 길은 없습니다.
한 표로 놓고 보면
| 항목 | 한투 KIS | 키움 REST | 토스증권 |
|---|---|---|---|
| LOC 매수 | 34 | 30 | LIMIT + CLS |
| LOC 매도 | 34 | 30 | LIMIT + CLS |
| MOC 매도 | 33 | 33 | 없음 |
| 장 시작 주문 | 매수 LOO 32, 매도 MOO 31 | 없음 | OPG는 국내 주식 전용 |
| 일반 시장가 | 없음 | 03 | MARKET |
| 모의에서 LOC | 안 됨 (VTTT1002U는 지정가만) | 확인 못 함 | 모의 환경을 찾지 못함 |
| 미국 주문 수량 정정 | 필드는 있음, 확인 못 함 | 안 됨 (가격만) | 안 됨 (us-modify-quantity-not-supported) |
출처는 한투 공식 저장소 open-trading-api의 examples_llm/overseas_stock/order/order.py 주석, 키움 공식 저장소 Kiwoom-REST-API의 kiwoom_api_spec.json과 mcp_exec/README.md, 토스 openapi.json입니다. 키움은 매수 쪽 trde_tp에 33이 없습니다. MOC는 매도에만 있습니다. 한투도 MOC는 매도 TR에만 적혀 있습니다.
매도 쪽에서 갈립니다
LOC 분할매수는 쓰는 사람마다 규칙이 다르지만, 매일 LOC로 나눠 사고 정해 둔 수익 구간에서 지정가나 LOC로 판다는 골격은 대체로 같습니다. 매수는 세 곳 다 되니 문제는 매도입니다.
규칙에 "이 조건이면 그날 종가에 전량 정리"가 들어 있으면 MOC가 필요해집니다. 한투와 키움은 매도 33으로 바로 됩니다. 토스는 MOC가 없으니 LOC 매도에 아주 낮은 가격을 넣어 사실상 종가에 팔리게 하거나, 마감 직전에 시장가로 파는 쪽으로 바꿔야 합니다. 둘 다 원래 규칙과 체결가가 조금씩 달라집니다. 백테스트를 MOC 가정으로 돌렸다면 그 차이를 고객께 먼저 말씀드립니다.
한투는 반대로 일반 시장가가 없습니다. 장중에 급히 팔아야 하는 조건이 있으면 호가를 보고 바로 체결될 지정가를 계산해 넣습니다. SOXL 봇도 그렇게 했습니다. 키움 REST는 미국주식 시장가 03이 있어서 이 부분이 단순합니다.
정정으로 수량을 바꿀 수 없을 때
분할매수 봇은 하루에도 몇 번씩 미체결 주문을 고칩니다. 평단이 바뀌면 다음 LOC 가격도 바뀌고, 남은 예산이 줄면 수량도 줄어듭니다. 그런데 키움 REST의 미국주식 정정 ust20002은 바디에 mdfy_uv(가격)와 stop_pric만 있고, 공식 README의 알려진 제약에도 "수량은 바꿀 수 없고 가격만" 바꿀 수 있다고 적혀 있습니다. 취소 ust20003은 전량만 됩니다. 토스도 미국주식 정정에 quantity를 보내면 400 us-modify-quantity-not-supported를 돌려줍니다.
그래서 두 곳에서는 수량이 바뀌면 취소하고 새로 넣는 흐름으로 짭니다. 이때 취소 응답을 받기 전에 새 주문을 넣으면 잠깐 두 주문이 같이 살아 있게 됩니다. 예수금이 넉넉하면 둘 다 체결될 수도 있습니다. 그래서 취소가 주문 조회에서 확인된 뒤에 새 주문을 내게 짭니다.
def replace_loc(api, order, new_qty, new_price):
if new_qty == order.qty:
return api.modify_price(order.no, new_price) # 가격만 바꿀 때는 정정
api.cancel(order.no)
if not api.wait_cancelled(order.no, timeout=10):
raise RuntimeError(f"취소 미확인 {order.no}, 새 주문 보류")
return api.place_loc(order.symbol, new_qty, new_price)
한투 order-rvsecncl은 ORD_QTY 필드를 받긴 합니다. 미국주식에서 수량 정정이 실제로 먹는지는 아직 실계좌로 확인하지 못했습니다. 그래서 한투에서도 같은 흐름을 권합니다.
낮에 미리 넣어 둘 수 있나
LOC는 미국 정규장 시간에 넣는 주문입니다. 한투 예약주문 order-resv(TTTT3014U)는 한국 시간 10:00부터 23:20까지(서머타임에는 22:20까지) 접수하고 정규장 시작에 전송하는데, 공식 주석에 "지정가주문만 가능"이라고 적혀 있습니다. 예약으로 LOC를 걸어 둘 수는 없다는 뜻입니다. 예약매도 TTTT3016U만 MOO를 받습니다.
결국 한투로 LOC 분할매수를 돌리려면 정규장이 열린 뒤 23:30(서머타임 22:30) 이후에 깨어 있는 프로그램이 필요합니다. 집 PC를 켜 두거나 서버에 올립니다. 키움과 토스에서 장 시작 전에 LOC를 미리 접수할 수 있는지는 공식 문서에서 찾지 못했습니다. 토스는 금액 주문 orderAmount와 소수점 매도에 "정규장 시작부터 정규장 종료 1시간 전까지만 접수"라는 시간 제한을 따로 적어 두었는데, CLS 주문의 접수 시간은 적혀 있지 않습니다. 확인되면 이 글에 덧붙이겠습니다.
모의투자로는 LOC를 못 돌려 봅니다
한투는 order.py 주석에 "모의투자 VTTT1002U(미국 매수 주문)로는 00:지정가만 가능"이라고 박아 두었습니다. 매도 VTTT1001U도 같습니다. 키움은 모의 도메인 mockapi.kiwoom.com이 미국주식 주문에도 열려 있지만, 모의에서 환율과 주문가능금액 조회가 거절된다고 README에 적혀 있고 LOC가 모의에서 받아지는지는 적혀 있지 않습니다. 토스는 공식 문서에 모의 서버가 없습니다.
그래서 LOC 로직은 두 단계로 나눠 확인하는 게 맞습니다. 모의에서는 주문을 지정가로 바꿔 흐름(가격 계산, 수량, 취소 후 재주문)만 보고, 실계좌에서는 1주로 며칠 돌려 LOC 접수와 종가 체결을 체결 내역으로 대조합니다. 한투 모의의 다른 제약은 KIS 모의투자 한계 정리에 있습니다.
소수점은 LOC와 같이 못 씁니다
토스는 미국주식 소수점을 지원하지만 LOC와는 묶이지 않습니다. quantity의 소수점은 시장가 매도에만 허용되고, 금액으로 사는 orderAmount는 시장가 매수 전용입니다. LOC 매수는 정수 주만 됩니다. 하루 예산을 금액으로 정해 두는 분할매수는 매일 예산을 그날 LOC 가격으로 나눠 내림한 주수만 사고, 남는 돈은 다음 날로 넘기는 식으로 처리합니다.
어느 증권사로 할지 정하실 때
이미 쓰는 계좌가 있으면 그 증권사로 하는 게 보통 낫습니다. 셋 다 LOC 매수가 되니 분할매수 때문에 계좌를 옮길 이유는 크지 않습니다. 규칙에 종가 전량 정리가 있으면 토스보다 한투나 키움이 편하고, 장중 시장가 매도가 자주 나오면 한투보다 키움이나 토스가 편합니다. 한투 해외주식 주문 전반은 KIS 미국주식 주문 글에, 한투로 하루치 루프를 짜는 과정은 LOC 분할매수 KIS 함정 정리에 따로 적었습니다. 키움 REST가 미국주식에서 되는 범위는 이 글, 토스 첫 주문은 이 글에 있습니다.
만들어 달라고 하실 때는 쓰시는 증권사, 나눠 사고파는 규칙, 종가 전량 정리 규칙이 있는지를 알려 주세요. 비용은 견적 안내에서 보실 수 있습니다.
자주 받는 질문
미국주식 LOC 주문은 어느 증권사 API에서 되나요?
한국투자증권 KIS API(ORD_DVSN 34), 키움 REST API(trde_tp 30), 토스증권 Open API(LIMIT에 timeInForce CLS) 세 곳 모두 미국주식 LOC 매수와 매도가 됩니다. 장마감 시장가(MOC) 매도는 한투와 키움(둘 다 33)에만 있고 토스에는 없습니다.
모의투자에서 LOC 주문을 시험할 수 있나요?
한투는 안 됩니다. 공식 예제에 모의 미국 주문은 지정가만 된다고 적혀 있습니다. 키움은 모의에서 LOC가 받아지는지 공식 문서에 나오지 않고, 토스는 모의 서버가 없습니다. 모의에서는 지정가로 흐름만 보고 LOC는 실계좌 1주로 확인하는 게 안전합니다.
걸어 둔 LOC 주문의 수량을 바꾸려면 어떻게 하나요?
키움 REST와 토스는 미국주식 정정으로 가격만 바꿀 수 있고 수량은 못 바꿉니다. 수량이 바뀌면 기존 주문을 취소하고, 취소가 확인된 뒤에 새 LOC 주문을 넣어야 두 주문이 같이 체결되는 일을 막을 수 있습니다.
2026년 11월 16일에 받은 한국투자증권, 키움증권, 토스증권 공식 문서와 예제 원문을 보고 썼습니다. 주문 유형과 접수 시간은 증권사 공지로 바뀔 수 있으니 실제 주문 전에 각 증권사 문서를 확인하세요. 특정 증권사나 투자 방법을 권하지 않으며, 분할매수의 수익을 보장하지 않습니다. 레버리지 ETF는 기초지수보다 손실이 크게 날 수 있습니다. 알고랩은 프로그램 제작 도구를 제공하며 투자자문업과 투자일임업을 영위하지 않습니다.