투자 도구 · 2/5

국내 증권사 API 요청 Generator

증권사·종목·매수/매도·주문 유형·가격·수량을 고르면 토큰 발급과 주문 전송 요청이 curl·Python·TypeScript로 나옵니다.

국내 증권사 Open API로 해외주식 주문을 보내려면 증권사마다 엔드포인트·헤더·코드값이 전부 다르고, 공식 문서는 국내주식 위주라 해외주식 주문의 코드표 하나를 찾는 데만 반나절이 갑니다. 이 페이지는 다섯 증권사의 그 조각을 한 폼에 모았습니다.

01 호출 순서

증권사 포털 (1회)Open API 신청 → 앱키 · 시크릿 발급계좌번호 · (토스) 허용 IP 등록앱키 · 시크릿 · 계좌번호내 PC / 서버 환경변수$APPKEY $APPSECRET $ACCOUNT주문 내용 (주문마다)티커 · 거래소매수 / 매도주문 유형 (지정가 · LOC · MOC)가격 · 수량$APPKEY $APPSECRET$ACCOUNT종목 · 수량 · 가격 · 유형① 토큰 발급POST /oauth2/token…client_credentials 방식→ access_token (만료 있음)② 주문 전송POST …/order(s)헤더: Bearer 토큰 (+계좌)→ 주문번호③ 상태 조회GET …/order/{번호}헤더: Bearer 토큰→ 접수 · 체결 · 거부토큰주문번호토큰 (만료 전까지 재사용)
증권사 Open API 호출 순서

02 요청 만들기

티커
매수 / 매도
공식 문서·예제 기준확인일 2026-10-23 · 토큰 24시간 (발급은 1분당 1회) · IP 문서상 없음
① 토큰 발급curl
curl -X POST "https://openapi.koreainvestment.com:9443/oauth2/tokenP" \
  -H "content-type: application/json; charset=utf-8" \
  -d "{
  \"grant_type\": \"client_credentials\",
  \"appkey\": \"$KIS_APPKEY\",
  \"appsecret\": \"$KIS_APPSECRET\"
}"
② 한국투자증권 매수 LOC 주문curl
curl -X POST "https://openapi.koreainvestment.com:9443/uapi/overseas-stock/v1/trading/order" \
  -H "content-type: application/json; charset=utf-8" \
  -H "authorization: Bearer $KIS_TOKEN" \
  -H "appkey: $KIS_APPKEY" \
  -H "appsecret: $KIS_APPSECRET" \
  -H "tr_id: TTTT1002U" \
  -H "custtype: P" \
  -d "{
  \"CANO\": \"$KIS_CANO\",
  \"ACNT_PRDT_CD\": \"01\",
  \"OVRS_EXCG_CD\": \"NASD\",
  \"PDNO\": \"AAPL\",
  \"ORD_QTY\": \"7\",
  \"OVRS_ORD_UNPR\": \"43.21\",
  \"ORD_SVR_DVSN_CD\": \"0\",
  \"ORD_DVSN\": \"34\"
}"
  • 모의투자(VTTT…)는 지정가(00)만 됩니다 — LOC·MOC 분기는 실전 계좌에서 처음 실행됩니다.
  • OVRS_EXCG_CD를 NASD로 고정하면 뉴욕·아멕스 상장 종목 주문이 실패합니다. 티커와 거래소 코드를 한 쌍으로 저장하세요.

한국투자증권 — 공식 GitHub 예제가 1차 출처

포털 apiportal.koreainvestment.com · 토큰 24시간 (발급은 1분당 1회) · IP 문서상 없음 · 코드값 확인 2026-10-23

공식 저장소 koreainvestment/open-trading-api의 overseas_stock_functions.py에 해외주식 주문 함수가 그대로 있어 코드값을 1차 출처에서 확인할 수 있습니다. 엔드포인트는/uapi/overseas-stock/v1/trading/order 하나이고, 매수·매도와 국가는 헤더 tr_id로 가릅니다(미국 매수 TTTT1002U · 매도 TTTT1006U, 모의투자는 앞글자 V).

ORD_DVSN (주문구분, 미국)

코드의미매수매도
00지정가OO
32LOO (장개시 지정가)OO
34LOC (장마감 지정가)OO
31MOO (장개시 시장가)XO
33MOC (장마감 시장가)XO

거래소 코드 OVRS_EXCG_CD

NASD(나스닥) · NYSE(뉴욕) · AMEX(아멕스). NASD로 고정하면 뉴욕·아멕스 상장 종목 주문이 실패하므로 티커와 거래소를 한 쌍으로 저장하세요.

주의

  • 모의투자는 지정가(00)만 받습니다 — LOC·MOC 분기는 실전 계좌에서 처음 실행됩니다.
  • 미국 매수에는 시장가가 없습니다. 바로 사려면 지정가에 여유를 두는 방식으로 대체합니다.
  • 가격(OVRS_ORD_UNPR)·수량은 문자열이고 가격은 소수 둘째 자리까지 고정합니다.
  • 응답 rt_cd 0은 접수일 뿐 체결이 아닙니다. 정정·취소에 쓰는 주문번호 ODNO를 보관하세요.
  • 토큰 발급(/oauth2/tokenP)은 1분당 1회 제한 — 호출마다 새로 받으면 막힙니다.
  • 공식 예제의 주석과 코드가 모의 매도 tr_id에서 다릅니다(주석 VTTT1001U, 코드 VTTT1006U) — 모의 매도는 표로 관리하세요.

키·토큰·계좌번호는 입력칸이 없습니다. $KIS_TOKEN처럼 환경변수 자리만 비워 두니, 본인 PC에서 값을 채워 실행하세요. 이 페이지는 어떤 값도 서버로 보내지 않습니다.

03 증권사를 바꿀 때 꼭 다시 볼 것

04 여기 없는 증권사

코드값은 증권사가 공지 없이 바꿀 수 있습니다. 설명에 적힌 확인일과 출처를 보고, 실제 주문 전엔 한 번은 포털 명세와 대조하세요. 틀린 값을 발견하면 문의로 알려 주시면 고칩니다.