KIS Developers menu

API 문서 HOME API 문서 해외주식주문


해외주식주문

해외주식 주문[v1_해외주식-001]

REST

해외주식 주문[v1_해외주식-001]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/order
  • Format
    JSON
  • Content-Type
    application/json; charset=UTF-8

개요

해외주식 주문 API입니다.

* 모의투자의 경우, 모든 해외 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

* 해외 거래소 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
* 해외 거래소 운영시간(한국시간 기준)
1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
3) 상해 : 10:30 ~ 16:00
4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTT1002U : 미국 매수 주문
TTTT1006U : 미국 매도 주문
TTTS0308U : 일본 매수 주문
TTTS0307U : 일본 매도 주문
TTTS0202U : 상해 매수 주문
TTTS1005U : 상해 매도 주문
TTTS1002U : 홍콩 매수 주문
TTTS1001U : 홍콩 매도 주문
TTTS0305U : 심천 매수 주문
TTTS0304U : 심천 매도 주문
TTTS0311U : 베트남 매수 주문
TTTS0310U : 베트남 매도 주문

[모의투자]
VTTT1002U : 미국 매수 주문
VTTT1001U : 미국 매도 주문
VTTS0308U : 일본 매수 주문
VTTS0307U : 일본 매도 주문
VTTS0202U : 상해 매수 주문
VTTS1005U : 상해 매도 주문
VTTS1002U : 홍콩 매수 주문
VTTS1001U : 홍콩 매도 주문
VTTS0305U : 심천 매수 주문
VTTS0304U : 심천 매도 주문
VTTS0311U : 베트남 매수 주문
VTTS0310U : 베트남 매도 주문
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 ※ 필수 아님 (기존 필수 사항으로 옵션으로 유지)

[POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
PDNO 상품번호 String Y 12 종목코드
ORD_QTY 주문수량 String Y 10 주문수량 (해외거래소 별 최소 주문수량 및 주문단위 확인 필요)
OVRS_ORD_UNPR 해외주문단가 String Y 31 1주당 가격
* 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력
CTAC_TLNO 연락전화번호 String N 20
MGCO_APTM_ODNO 운용사지정주문번호 String N 12
SLL_TYPE 판매유형 String N 2 제거 : 매수
00 : 매도
ORD_SVR_DVSN_CD 주문서버구분코드 String Y 1 "0"(Default)
ORD_DVSN 주문구분 String Y 2 [Header tr_id TTTT1002U(미국 매수 주문)]
00 : 지정가
32 : LOO(장개시지정가)
34 : LOC(장마감지정가)
* 모의투자 VTTT1002U(미국 매수 주문)로는 00:지정가만 가능

[Header tr_id TTTT1006U(미국 매도 주문)]
00 : 지정가
31 : MOO(장개시시장가)
32 : LOO(장개시지정가)
33 : MOC(장마감시장가)
34 : LOC(장마감지정가)
* 모의투자 VTTT1006U(미국 매도 주문)로는 00:지정가만 가능

[Header tr_id TTTS1001U(홍콩 매도 주문)]
00 : 지정가
50 : 단주지정가
* 모의투자 VTTS1001U(홍콩 매도 주문)로는 00:지정가만 가능

[그외 tr_id]
제거

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Object Y
-KRX_FWDG_ORD_ORGNO 한국거래소전송주문조직번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
-ODNO 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
-ORD_TMD 주문시각 String Y 6 주문시각(시분초HHMMSS)

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"OVRS_EXCG_CD": "NASD",
"PDNO": "AAPL",
"ORD_QTY": "1",
"OVRS_ORD_UNPR": "145.00",
"CTAC_TLNO": "",
"MGCO_APTM_ODNO": "",
"ORD_SVR_DVSN_CD": "0",
"ORD_DVSN": "00"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "KRX_FWDG_ORD_ORGNO": "01790",
    "ODNO": "0000004336",
    "ORD_TMD": "160524"
  }
}

해외주식 정정취소주문[v1_해외주식-003]

REST

해외주식 정정취소주문[v1_해외주식-003]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/order-rvsecncl
  • Format
    JSON
  • Content-Type
    application/json; charset=UTF-8

개요

접수된 해외주식 주문을 정정하거나 취소하기 위한 API입니다.
(해외주식주문 시 Return 받은 ODNO를 참고하여 API를 호출하세요.)

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

* 해외 거래소 운영시간 외 API 호출 시 애러가 발생하오니 운영시간을 확인해주세요.
* 해외 거래소 운영시간(한국시간 기준)
1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
3) 상해 : 10:30 ~ 16:00
4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTT1004U : 미국 정정 취소 주문
TTTS1003U : 홍콩 정정 취소 주문
TTTS0309U : 일본 정정 취소 주문
TTTS0302U : 상해 취소 주문
TTTS0306U : 심천 취소 주문
TTTS0312U : 베트남 취소 주문

[모의투자]
VTTT1004U : 미국 정정 취소 주문
VTTS1003U : 홍콩 정정 취소 주문
VTTS0309U : 일본 정정 취소 주문
VTTS0302U : 상해 취소 주문
VTTS0306U : 심천 취소 주문
VTTS0312U : 베트남 취소 주문
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 ※ 필수 아님 (기존 필수 사항으로 옵션으로 유지)

[POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
PDNO 상품번호 String Y 12
ORGN_ODNO 원주문번호 String Y 10 정정 또는 취소할 원주문번호
(해외주식_주문 API ouput ODNO
or 해외주식 미체결내역 API output ODNO 참고)
RVSE_CNCL_DVSN_CD 정정취소구분코드 String Y 2 01 : 정정
02 : 취소
ORD_QTY 주문수량 String Y 10
OVRS_ORD_UNPR 해외주문단가 String Y 32 취소주문 시, "0" 입력
MGCO_APTM_ODNO 운용사지정주문번호 String N 12
ORD_SVR_DVSN_CD 주문서버구분코드 String N 1 "0"(Default)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Object Y
-KRX_FWDG_ORD_ORGNO 한국거래소전송주문조직번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
-ODNO 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
-ORD_TMD 주문시각 String Y 6 주문시각(시분초HHMMSS)

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"OVRS_EXCG_CD": "NYSE",
"PDNO": "BA",
"ORGN_ODNO": "30135009",
"RVSE_CNCL_DVSN_CD": "01",
"ORD_QTY": "1",
"OVRS_ORD_UNPR": "226.00",
"CTAC_TLNO": "",
"MGCO_APTM_ODNO": "",
"ORD_SVR_DVSN_CD": "0"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "KRX_FWDG_ORD_ORGNO": "01790",
    "ODNO": "0000004338",
    "ORD_TMD": "160710"
  }
}

해외주식 예약주문접수[v1_해외주식-002]

REST

해외주식 예약주문접수[v1_해외주식-002]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/order-resv
  • Format
     
  • Content-Type
    application/json; charset=UTF-8

개요

미국거래소 운영시간 외 미국주식을 예약 매매하기 위한 API입니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

* 아래 각 국가의 시장별 예약주문 접수 가능 시간을 확인하시길 바랍니다.

미국 예약주문 접수시간
1) 10:00 ~ 23:20 / 10:00 ~ 22:20 (서머타임 시)
2) 주문제한 : 16:30 ~ 16:45 경까지 (사유 : 시스템 정산작업시간)
3) 23:30 정규장으로 주문 전송 (서머타임 시 22:30 정규장 주문 전송)
4) 미국 거래소 운영시간(한국시간 기준) : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)

홍콩 예약주문 접수시간
1) 09:00 ~ 10:20 접수, 10:30 주문전송
2) 10:40 ~ 13:50 접수, 14:00 주문전송

중국 예약주문 접수시간
1) 09:00 ~ 10:20 접수, 10:30 주문전송
2) 10:40 ~ 13:50 접수, 14:00 주문전송

일본 예약주문 접수시간
1) 09:10 ~ 12:20 까지 접수, 12:30 주문전송

베트남 예약주문 접수시간
1) 09:00 ~ 11:00 까지 접수, 11:15 주문전송
2) 11:20 ~ 14:50 까지 접수, 15:00 주문전송

* 예약주문 유의사항
1) 예약주문 유효기간 : 당일
- 미국장 마감 후, 미체결주문은 자동취소
- 미국휴장 시, 익 영업일로 이전
(미국예약주문화면에서 취소 가능)
2) 증거금 및 잔고보유 : 체크 안함
3) 주문전송 불가사유
- 매수증거금 부족: 수수료 포함 매수금액부족, 환전, 시세이용료 출금, 인출에 의한 증거금 부족
- 기타 매수증거금 부족, 매도가능수량 부족, 주권변경 등 권리발생으로 인한 주문불가사유 발생
4) 지정가주문만 가능
* 단 미국 예약매도주문(TTTT3016U)의 경우, MOO(장개시시장가)로 주문 접수 가능

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTT3016U : 미국 매도 예약 주문
TTTT3014U : 미국 매수 예약 주문
TTTS3013U : 중국/홍콩/일본/베트남 예약 매수/매도/취소 주문

[모의투자]
VTTT3016U : 미국 매도 예약 주문
VTTT3014U : 미국 매수 예약 주문
VTTS3013U : 중국/홍콩/일본/베트남 예약 매수/매도/취소 주문
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 ※ 필수 아님 (기존 필수 사항으로 옵션으로 유지)

[POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
SLL_BUY_DVSN_CD 매도매수구분코드 String N 2 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
01 : 매도
02 : 매수
RVSE_CNCL_DVSN_CD 정정취소구분코드 String Y 2 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
00 : "매도/매수 주문"시 필수 항목
02 : 취소
PDNO 상품번호 String Y 12
PRDT_TYPE_CD 상품유형코드 String Y 3 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
515 : 일본
501 : 홍콩 / 543 : 홍콩CNY / 558 : 홍콩USD
507 : 베트남 하노이거래소 / 508 : 베트남 호치민거래소
551 : 중국 상해A / 552 : 중국 심천A
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
FT_ORD_QTY FT주문수량 String Y 10
FT_ORD_UNPR3 FT주문단가3 String Y 27
ORD_SVR_DVSN_CD 주문서버구분코드 String N 1 "0"(Default)
RSVN_ORD_RCIT_DT 예약주문접수일자 String N 8 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용
ORD_DVSN 주문구분 String N 20 tr_id가 TTTT3016U(미국 예약 매도 주문)인 경우만 사용
00 : 지정가
31 : MOO(장개시시장가)
OVRS_RSVN_ODNO 해외예약주문번호 String N 10 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 사용

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Object Y
-ODNO 한국거래소전송주문조직번호 String Y 10 tr_id가 TTTT3016U(미국 예약 매도 주문) / TTTT3014U(미국 예약 매수 주문)인 경우만 출력
-RSVN_ORD_RCIT_DT 예약주문접수일자 String Y 8 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 출력
-OVRS_RSVN_ODNO 해외예약주문번호 String Y 10 tr_id가 TTTS3013U(중국/홍콩/일본/베트남 예약 주문)인 경우만 출력

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"AAPL",
"PDNO": "AAPL",
"OVRS_EXCG_CD": "NASD",
"FT_ORD_QTY": "1",
"FT_ORD_UNPR3": "148.00"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK0013",
  "msg1": "주문 전송 완료 되었습니다.",
  "output": {
    "ODNO": "0030138295"
  }
}

해외주식 예약주문접수취소[v1_해외주식-004]

REST

해외주식 예약주문접수취소[v1_해외주식-004]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/order-resv-ccnl
  • Format
    JSON
  • Content-Type
    application/json; charset=UTF-8

개요

접수된 미국주식 예약주문을 취소하기 위한 API입니다.
(해외주식 예약주문접수 시 Return 받은 ODNO를 참고하여 API를 호출하세요.)

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTT3017U : 미국예약주문접수 취소

[모의투자]
VTTT3017U : 미국예약주문접수 취소
(일본, 홍콩 등 타국가 개발 진행 예정)
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 ※ 필수 아님 (기존 필수 사항으로 옵션으로 유지)

[POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
RSYN_ORD_RCTT_DT 해외주문접수일자 String Y 8
OVRS_RSVN_ODNO 해외예약주문번호 String Y 10 해외주식_예약주문접수 API Output ODNO(주문번호) 참고

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Object Y
-OVRS_RSVN_ODNO 해외예약주문번호 String Y 10

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD": "01",
"RSVN_ORD_RCIT_DT": "20211124",
"OVRS_RSVN_ODNO": "30135682"
}

Response

{
  "rt_cd": "0",
  "msg_cd": "APBK1711",
  "msg1": "취소주문이 접수되었습니다.",
  "output": {
    "OVRS_RSVN_ODNO": "0030138295"
  }
}

해외주식 미체결내역[v1_해외주식-005]

REST

해외주식 미체결내역[v1_해외주식-005]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/inquire-nccs
  • Format
     
  • Content-Type
     

개요

접수된 해외주식 주문 중 체결되지 않은 미체결 내역을 조회하는 API입니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

※ 해외 거래소 운영시간(한국시간 기준)
1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
3) 상해 : 10:30 ~ 16:00
4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTS3018R

[모의투자]
VTTS3018R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민

* NASD 인 경우만 미국전체로 조회되며 나머지 거래소 코드는 해당 거래소만 조회됨
SORT_SQN 정렬순서 String Y 2 DS : 정순
그외 : 역순

[header tr_id: TTTS3018R]
""(공란)
CTX_AREA_FK200 연속조회검색조건200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터)
CTX_AREA_NK200 연속조회키200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output 응답상세 Array Y
-ord_dt 주문일자 String Y 8 주문접수 일자
-ord_gno_brno 주문채번지점번호 String Y 5 계좌 개설 시 관리점으로 선택한 영업점의 고유번호
-odno 주문번호 String Y 10 접수한 주문의 일련번호
-orgn_odno 원주문번호 String Y 10 정정 또는 취소 대상 주문의 일련번호
-pdno 상품번호 String Y 12 종목코드
-prdt_name 상품명 String Y 60 종목명
-sll_buy_dvsn_cd 매도매수구분코드 String Y 2 01 : 매도
02 : 매수
-sll_buy_dvsn_cd_name 매도매수구분코드명 String Y 60 매수매도구분명
-rvse_cncl_dvsn_cd 정정취소구분코드 String Y 2 01 : 정정
02 : 취소
-rvse_cncl_dvsn_cd_name 정정취소구분코드명 String Y 60 정정취소구분명
-rjct_rson 거부사유 String Y 60 정상 처리되지 못하고 거부된 주문의 사유
-rjct_rson_name 거부사유명 String Y 60 정상 처리되지 못하고 거부된 주문의 사유명
-ord_tmd 주문시각 String Y 6 주문 접수 시간
-tr_mket_name 거래시장명 String Y 60
-tr_crcy_cd 거래통화코드 String Y 3 USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동
-natn_cd 국가코드 String Y 3
-natn_kor_name 국가한글명 String Y 60
-ft_ord_qty FT주문수량 String Y 10 주문수량
-ft_ccld_qty FT체결수량 String Y 10 체결된 수량
-nccs_qty 미체결수량 String Y 10 미체결수량
-ft_ord_unpr3 FT주문단가3 String Y 26 주문가격
-ft_ccld_unpr3 FT체결단가3 String Y 26 체결된 가격
-ft_ccld_amt3 FT체결금액3 String Y 23 체결된 금액
-ovrs_excg_cd 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
-prcs_stat_name 처리상태명 String Y 60
-loan_type_cd 대출유형코드 String Y 2 00 해당사항없음
01 자기융자일반형
03 자기융자투자형
05 유통융자일반형
06 유통융자투자형
07 자기대주
09 유통대주
11 주식담보대출
12 수익증권담보대출
13 ELS담보대출
14 채권담보대출
15 해외주식담보대출
16 기업신용공여
31 소액자동담보대출
41 매도담보대출
42 환매자금대출
43 매입환매자금대출
44 대여매도담보대출
81 대차거래
82 법인CMA론
91 공모주청약자금대출
92 매입자금
93 미수론서비스
94 대여
-loan_dt 대출일자 String Y 8 대출 실행일자
-usa_amk_exts_rqst_yn 미국애프터마켓연장신청여부 String Y 1 Y/N
ctx_area_fk200 연속조회검색조건200 String Y 200
ctx_area_nk200 연속조회키200 String Y 200

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"01",
"OVRS_EXCG_CD": "NYSE",
"SORT_SQN": "DS",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}

Response

{
  "ctx_area_fk200": "81055689^01^NYSE^DS^                                                                                                                                                                                    ",
  "ctx_area_nk200": "                                                                                                                                                                                                        ",
  "output": [
    {
      "ord_dt": "20220112",
      "ord_gno_brno": "01790",
      "odno": "0030138112",
      "orgn_odno": "",
      "pdno": "BA",
      "prdt_name": "보잉",
      "sll_buy_dvsn_cd": "02",
      "sll_buy_dvsn_cd_name": "매수",
      "rvse_cncl_dvsn_cd": "00",
      "rvse_cncl_dvsn_cd_name": "",
      "rjct_rson": "",
      "rjct_rson_name": "",
      "ord_tmd": "163209",
      "tr_mket_name": "뉴욕거래소",
      "tr_crcy_cd": "USD",
      "natn_cd": "840",
      "natn_kor_name": "미국",
      "ft_ord_qty": "1",
      "ft_ccld_qty": "0",
      "nccs_qty": "1",
      "ft_ord_unpr3": "200.00000000",
      "ft_ccld_unpr3": "0.00000000",
      "ft_ccld_amt3": "0.00000",
      "ovrs_excg_cd": "NYSE",
      "prcs_stat_name": "",
      "loan_type_cd": "10",
      "loan_dt": ""
    },
    {
      "ord_dt": "20220112",
      "ord_gno_brno": "01790",
      "odno": "0030138113",
      "orgn_odno": "",
      "pdno": "BA",
      "prdt_name": "보잉",
      "sll_buy_dvsn_cd": "02",
      "sll_buy_dvsn_cd_name": "매수",
      "rvse_cncl_dvsn_cd": "00",
      "rvse_cncl_dvsn_cd_name": "",
      "rjct_rson": "",
      "rjct_rson_name": "",
      "ord_tmd": "163211",
      "tr_mket_name": "뉴욕거래소",
      "tr_crcy_cd": "USD",
      "natn_cd": "840",
      "natn_kor_name": "미국",
      "ft_ord_qty": "1",
      "ft_ccld_qty": "0",
      "nccs_qty": "1",
      "ft_ord_unpr3": "200.00000000",
      "ft_ccld_unpr3": "0.00000000",
      "ft_ccld_amt3": "0.00000",
      "ovrs_excg_cd": "NYSE",
      "prcs_stat_name": "",
      "loan_type_cd": "10",
      "loan_dt": "",
      "loan_dt": ""
    }
  ],
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

해외주식 잔고[v1_해외주식-006]

REST

해외주식 잔고[v1_해외주식-006]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/inquire-balance
  • Format
     
  • Content-Type
     

개요

해외주식 잔고를 조회하는 API 입니다.
한국투자 HTS(eFriend Plus) > [7600] 해외주식 종합주문 화면의 좌측 하단 '실시간잔고' 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

* 미니스탁 잔고는 해당 API로 확인이 불가합니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTS3012R

[모의투자]
VTTS3012R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 ※ 필수 아님
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 [모의]
NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스

[실전]
NASD : 미국전체
NAS : 나스닥
NYSE : 뉴욕
AMEX : 아멕스

[모의/실전 공통]
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
TR_CRCY_CD 거래통화코드 String Y 3 USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동
CTX_AREA_FK200 연속조회검색조건200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터)
CTX_AREA_NK200 연속조회키200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
ctx_area_fk200 연속조회검색조건200 String Y 200
ctx_area_nk200 연속조회키200 String Y 200
output1 응답상세1 Array Y
-cano 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
-acnt_prdt_cd 계좌상품코드 String Y 2 계좌상품코드
-prdt_type_cd 상품유형코드 String Y 3
-ovrs_pdno 해외상품번호 String Y 12
-ovrs_item_name 해외종목명 String Y 60
-frcr_evlu_pfls_amt 외화평가손익금액 String Y 30 해당 종목의 매입금액과 평가금액의 외회기준 비교 손익
-evlu_pfls_rt 평가손익율 String Y 10 해당 종목의 평가손익을 기준으로 한 수익률
-pchs_avg_pric 매입평균가격 String Y 23 해당 종목의 매수 평균 단가
-ovrs_cblc_qty 해외잔고수량 String Y 19
-ord_psbl_qty 주문가능수량 String Y 10 매도 가능한 주문 수량
-frcr_pchs_amt1 외화매입금액1 String Y 23 해당 종목의 외화 기준 매입금액
-ovrs_stck_evlu_amt 해외주식평가금액 String Y 32 해당 종목의 외화 기준 평가금액
-now_pric2 현재가격2 String Y 25 해당 종목의 현재가
-tr_crcy_cd 거래통화코드 String Y 3 USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동
-ovrs_excg_cd 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 하노이거래소
VNSE : 호치민거래소
-loan_type_cd 대출유형코드 String Y 2 00 : 해당사항없음
01 : 자기융자일반형
03 : 자기융자투자형
05 : 유통융자일반형
06 : 유통융자투자형
07 : 자기대주
09 : 유통대주
11 : 주식담보대출
12 : 수익증권담보대출
13 : ELS담보대출
14 : 채권담보대출
15 : 해외주식담보대출
16 : 기업신용공여
31 : 소액자동담보대출
41 : 매도담보대출
42 : 환매자금대출
43 : 매입환매자금대출
44 : 대여매도담보대출
81 : 대차거래
82 : 법인CMA론
91 : 공모주청약자금대출
92 : 매입자금
93 : 미수론서비스
94 : 대여
-loan_dt 대출일자 String Y 8 대출 실행일자
-expd_dt 만기일자 String Y 8 대출 만기일자
output2 응답상세2 Object Y
-frcr_pchs_amt1 외화매입금액1 String Y 24
-ovrs_rlzt_pfls_amt 해외실현손익금액 String Y 20
-ovrs_tot_pfls 해외총손익 String Y 24
-rlzt_erng_rt 실현수익율 String Y 32
-tot_evlu_pfls_amt 총평가손익금액 String Y 32
-tot_pftrt 총수익률 String Y 32
-frcr_buy_amt_smtl1 외화매수금액합계1 String Y 25
-ovrs_rlzt_pfls_amt2 해외실현손익금액2 String Y 24
-frcr_buy_amt_smtl2 외화매수금액합계2 String Y 25

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"01",
"OVRS_EXCG_CD": "NASD",
"TR_CRCY_CD": "USD",
"CTX_AREA_FK200": "",
"CTX_AREA_NK200": ""
}

Response

{
  "ctx_area_fk200": "                                                                                                                                                                                                        ",
  "ctx_area_nk200": "                                                                                                                                                                                                        ",
  "output1": [
    {
      "cano": "810XXXXX",
      "acnt_prdt_cd": "01",
      "prdt_type_cd": "512",
      "ovrs_pdno": "TSLA",
      "ovrs_item_name": "테슬라",
      "frcr_evlu_pfls_amt": "-3547254.185235",
      "evlu_pfls_rt": "-81.75",
      "pchs_avg_pric": "5832.2148",
      "ovrs_cblc_qty": "744",
      "ord_psbl_qty": "744",
      "frcr_pchs_amt1": "4339167.78523",
      "ovrs_stck_evlu_amt": "791913.60000000",
      "now_pric2": "1064.400000",
      "tr_crcy_cd": "USD",
      "ovrs_excg_cd": "NASD",
      "loan_type_cd": "10",
      "loan_dt": "",
      "expd_dt": ""
    },
    {
      "cano": "",
      "acnt_prdt_cd": "",
      "prdt_type_cd": "",
      "ovrs_pdno": "",
      "ovrs_item_name": "",
      "frcr_evlu_pfls_amt": "0.000000",
      "evlu_pfls_rt": "0.00",
      "pchs_avg_pric": "0.0000",
      "ovrs_cblc_qty": "0",
      "ord_psbl_qty": "0",
      "frcr_pchs_amt1": "0.00000",
      "ovrs_stck_evlu_amt": "0.00000000",
      "now_pric2": "0.000000",
      "tr_crcy_cd": "",
      "ovrs_excg_cd": "",
      "loan_type_cd": "",
      "loan_dt": "",
      "expd_dt": ""
    }
  ],
  "output2": {
    "frcr_pchs_amt1": "4339167.78523",
    "ovrs_rlzt_pfls_amt": "-4836.71476",
    "ovrs_tot_pfls": "-3547254.18524",
    "rlzt_erng_rt": "-82.93101266",
    "tot_evlu_pfls_amt": "791913.60000000",
    "tot_pftrt": "-81.74964327",
    "frcr_buy_amt_smtl1": "5832.214765",
    "ovrs_rlzt_pfls_amt2": "-5780841.48713",
    "frcr_buy_amt_smtl2": "6970663.087128"
  },
  "rt_cd": "0",
  "msg_cd": "KIOK0510",
  "msg1": "조회가 완료되었습니다                                                           "
}

해외주식 주문체결내역[v1_해외주식-007]

REST

해외주식 주문체결내역[v1_해외주식-007]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443
  • URL
    /uapi/overseas-stock/v1/trading/inquire-ccnl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

일정 기간의 해외주식 주문 체결 내역을 확인하는 API입니다.
실전계좌의 경우, 한 번의 호출에 최대 20건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.
모의계좌의 경우, 한 번의 호출에 최대 15건까지 확인 가능하며, 이후의 값은 연속조회를 통해 확인하실 수 있습니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

※ 해외 거래소 운영시간(한국시간 기준)
1) 미국 : 23:30 ~ 06:00 (썸머타임 적용 시 22:30 ~ 05:00)
2) 일본 : (오전) 09:00 ~ 11:30, (오후) 12:30 ~ 15:00
3) 상해 : 10:30 ~ 16:00
4) 홍콩 : (오전) 10:30 ~ 13:00, (오후) 14:00 ~ 17:00

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTS3035R

[모의투자]
VTTS3035R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
PDNO 상품번호 String Y 12 전종목일 경우 "%" 입력
※ 모의투자계좌의 경우 ""(전체 조회)만 가능
ORD_STRT_DT 주문시작일자 String Y 8 YYYYMMDD 형식 (현지시각 기준)
ORD_END_DT 주문종료일자 String Y 8 YYYYMMDD 형식 (현지시각 기준)
SLL_BUY_DVSN 매도매수구분 String Y 2 00 : 전체
01 : 매도
02 : 매수
※ 모의투자계좌의 경우 "00"(전체 조회)만 가능
CCLD_NCCS_DVSN 체결미체결구분 String Y 2 00 : 전체
01 : 체결
02 : 미체결
※ 모의투자계좌의 경우 "00"(전체 조회)만 가능
OVRS_EXCG_CD 해외거래소코드 String Y 4 전종목일 경우 "%" 입력
NASD : 미국시장 전체(나스닥, 뉴욕, 아멕스)
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
※ 모의투자계좌의 경우 ""(전체 조회)만 가능
SORT_SQN 정렬순서 String Y 2 DS : 정순
AS : 역순
ORD_DT 주문일자 String Y 8 "" (Null 값 설정)
ORD_GNO_BRNO 주문채번지점번호 String Y 5 "" (Null 값 설정)
ODNO 주문번호 String Y 10 "" (Null 값 설정)
※ 주문번호로 검색 불가능합니다. 반드시 ""(Null 값 설정) 바랍니다.
CTX_AREA_NK200 연속조회키200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터)
CTX_AREA_FK200 연속조회검색조건200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
ctx_area_fk200 연속조회검색조건200 String Y 200
ctx_area_nk200 연속조회키200 String Y 200
output 응답상세 Array Y
-ord_dt 주문일자 String Y 8 주문접수 일자 (현지시각 기준)
-ord_gno_brno 주문채번지점번호 String Y 5 계좌 개설 시 관리점으로 선택한 영업점의 고유번호
-odno 주문번호 String Y 10 접수한 주문의 일련번호
※ 정정취소주문 시, 해당 값 odno(주문번호) 넣어서 사용
-orgn_odno 원주문번호 String Y 10 정정 또는 취소 대상 주문의 일련번호
-sll_buy_dvsn_cd 매도매수구분코드 String Y 2 01 : 매도
02 : 매수
-sll_buy_dvsn_cd_name 매도매수구분코드명 String Y 60
-rvse_cncl_dvsn 정정취소구분 String Y 2 01 : 정정
02 : 취소
-rvse_cncl_dvsn_name 정정취소구분명 String Y 60
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-ft_ord_qty FT주문수량 String Y 10 주문수량
-ft_ord_unpr3 FT주문단가3 String Y 26 주문가격
-ft_ccld_qty FT체결수량 String Y 10 체결된 수량
-ft_ccld_unpr3 FT체결단가3 String Y 26 체결된 가격
-ft_ccld_amt3 FT체결금액3 String Y 23 체결된 금액
-nccs_qty 미체결수량 String Y 10 미체결수량
-prcs_stat_name 처리상태명 String Y 60
-rjct_rson 거부사유 String Y 60 정상 처리되지 못하고 거부된 주문의 사유
-ord_tmd 주문시각 String Y 6 주문 접수 시간
-tr_mket_name 거래시장명 String Y 60
-tr_natn 거래국가 String Y 3
-tr_natn_name 거래국가명 String Y 3
-ovrs_excg_cd 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 베트남 하노이
VNSE : 베트남 호치민
-tr_crcy_cd 거래통화코드 String Y 60
-dmst_ord_dt 국내주문일자 String Y 8
-thco_ord_tmd 당사주문시각 String Y 6
-loan_type_cd 대출유형코드 String Y 2
-mdia_dvsn_name 매체구분명 String Y 60 ex) OpenAPI, 모바일
-loan_dt 대출일자 String Y 8
-rjct_rson_name 거부사유명 String Y 60
-usa_amk_exts_rqst_yn 미국애프터마켓연장신청여부 String Y 1 Y/N

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"01",
"PDNO": ""%,
"ORD_STRT_DT": "20211027",
"ORD_END_DT": "20211027",
"SLL_BUY_DVSN": "00",
"CCLD_NCCS_DVSN": "00",
"OVRS_EXCG_CD": "%",
"SORT_SQN": "DS",
"ORD_DT": "",
"ORD_GNO_BRNO":"02111",
"ODNO": "",
"CTX_AREA_NK200": "",
"CTX_AREA_FK200": ""
}

Response

{
  "ctx_area_nk200": "                                                                                                                                                                                                        ",
  "ctx_area_fk200": "81055689^01^^20211027^20211027^00^00^NASD^^                                                                                                                                                             ",
  "output": {
      "ord_dt": "",
      "ord_gno_brno": "",
      "odno": "",
      "orgn_odno": "",
      "sll_buy_dvsn_cd": "",
      "sll_buy_dvsn_cd_name": "",
      "rvse_cncl_dvsn": "",
      "rvse_cncl_dvsn_name": "",
      "pdno": "",
      "prdt_name": "",
      "ft_ord_qty": "0",
      "ft_ord_unpr3": "0.00000000",
      "ft_ccld_qty": "0",
      "ft_ccld_unpr3": "0.00000000",
      "ft_ccld_amt3": "0.00000",
      "nccs_qty": "0",
      "prcs_stat_name": "",
      "rjct_rson": "",
      "rjct_rson_name": "",
      "ord_tmd": "",
      "tr_mket_name": "",
      "tr_natn": "",
      "tr_natn_name": "",
      "ovrs_excg_cd": "",
      "tr_crcy_cd": "",
      "dmst_ord_dt": "",
      "thco_ord_tmd": "",
      "loan_type_cd": "",
      "loan_dt": "",
      "mdia_dvsn_name": ""
    },
  "rt_cd": "0",
  "msg_cd": "KIOK0560",
  "msg1": "조회할 내용이 없습니다                                                          "
}

해외주식 체결기준현재잔고[v1_해외주식-008]

REST

해외주식 체결기준현재잔고[v1_해외주식-008]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    https://openapivts.koreainvestment.com:29443 (output3만 이용 가능)
  • URL
    /uapi/overseas-stock/v1/trading/inquire-present-balance
  • Format
     
  • Content-Type
     

개요

해외주식 잔고를 체결 기준으로 확인하는 API 입니다.

HTS(eFriend Plus) [0839] 해외 체결기준잔고 화면을 API로 구현한 사항으로 화면을 함께 보시면 기능 이해가 쉽습니다.

(※모의계좌의 경우 output3(외화평가총액 등 확인 가능)만 정상 출력됩니다.
잔고 확인을 원하실 경우에는 해외주식 잔고[v1_해외주식-006] API 사용을 부탁드립니다.)

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

해외주식 체결기준현재잔고 유의사항
1. 해외증권 체결기준 잔고현황을 조회하는 화면입니다.
2. 온라인국가는 수수료(국내/해외)가 반영된 최종 정산금액으로 잔고가 변동되며, 결제작업 지연등으로 인해 조회시간은 차이가 발생할 수 있습니다.
- 아시아 온라인국가 : 매매일 익일 08:40 ~ 08:45분 경
- 미국 온라인국가 : 당일 장 종료후 08:40 ~ 08:45분 경
※ 단, 애프터연장 참여 신청계좌는 10:30 ~ 10:35분 경(Summer Time : 09:30 ~ 09:35분 경)에 최종 정산금액으로 변동됩니다.
3. 미국 현재가 항목은 주간시세 및 애프터시세는 반영하지 않으며, 정규장 마감 후에는 종가로 조회됩니다.
4. 온라인국가를 제외한 국가의 현재가는 실시간 시세가 아니므로 주문화면의 잔고 평가금액 등과 차이가 발생할 수 있습니다.
5. 해외주식 담보대출 매도상환 체결내역은 해당 잔고화면에 반영되지 않습니다.
결제가 완료된 이후 외화잔고에 포함되어 반영되오니 참고하여 주시기 바랍니다.
6. 외화평가금액은 당일 최초고시환율이 적용된 금액으로 실제 환전금액과는 차이가 있습니다.
7. 미국은 메인 시스템이 아닌 별도 시스템을 통해 거래되므로, 18시 10~15분 이후 발생하는 미국 매매내역은 해당 화면에 실시간으로 반영되지 않으니 하단 내용을 참고하여 안내하여 주시기 바랍니다.
[외화잔고 및 해외 유가증권 현황 조회]
- 일반/통합증거금 계좌 : 미국장 종료 + 30분 후 부터 조회 가능
단, 통합증거금 계좌에 한해 주문금액은 외화잔고 항목에 실시간 반영되며, 해외 유가증권 현황은 반영되지
않아 해외 유가증권 평가금액이 과다 또는 과소 평가될 수 있습니다.
- 애프터연장 신청계좌 : 실시간 반영
단, 시스템정산작업시간(23:40~00:10) 및 거래량이 많은 경우 메인시스템에 반영되는 시간으로 인해 차이가
발생할 수 있습니다.
※ 배치작업시간에 따라 시간은 변동될 수 있습니다.

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, Oauth 2.0의 Authorization Code Grant 절차를 준용)

※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출
EX) "Bearer eyJ..........8GA"
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
CTRP6504R

[모의투자]
VTRP6504R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객타입 String N 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
WCRC_FRCR_DVSN_CD 원화외화구분코드 String Y 2 01 : 원화
02 : 외화
NATN_CD 국가코드 String Y 3 000 전체
840 미국
344 홍콩
156 중국
392 일본
704 베트남
TR_MKET_CD 거래시장코드 String Y 2 [Request body NATN_CD 000 설정]
00 : 전체

[Request body NATN_CD 840 설정]
00 : 전체
01 : 나스닥(NASD)
02 : 뉴욕거래소(NYSE)
03 : 미국(PINK SHEETS)
04 : 미국(OTCBB)
05 : 아멕스(AMEX)

[Request body NATN_CD 156 설정]
00 : 전체
01 : 상해B
02 : 심천B
03 : 상해A
04 : 심천A

[Request body NATN_CD 392 설정]
01 : 일본

[Request body NATN_CD 704 설정]
01 : 하노이거래
02 : 호치민거래소

[Request body NATN_CD 344 설정]
01 : 홍콩
02 : 홍콩CNY
03 : 홍콩USD
INQR_DVSN_CD 조회구분코드 String Y 2 00 : 전체
01 : 일반해외주식
02 : 미니스탁

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String Y 1 F or M : 다음 데이터 있음
D or E : 마지막 데이터
gt_uid Global UID String Y 32 거래고유번호

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1 0 : 성공
0 이외의 값 : 실패
msg_cd 응답코드 String Y 8 응답코드
msg1 응답메세지 String Y 80 응답메세지
output1 응답상세1 (체결기준 잔고) Array Y 체결기준현재잔고 없으면 빈값으로 출력
-prdt_name 상품명 String Y 60 종목명
-cblc_qty13 잔고수량13 String Y 32 결제보유수량
-thdt_buy_ccld_qty1 당일매수체결수량1 String Y 32 당일 매수 체결 완료 수량
-thdt_sll_ccld_qty1 당일매도체결수량1 String Y 32 당일 매도 체결 완료 수량
-ccld_qty_smtl1 체결수량합계1 String Y 32 체결기준 현재 보유수량
-ord_psbl_qty1 주문가능수량1 String Y 32 주문 가능한 주문 수량
-frcr_pchs_amt 외화매입금액 String Y 29 해당 종목의 외화 기준 매입금액
-frcr_evlu_amt2 외화평가금액2 String Y 30 해당 종목의 외화 기준 평가금액
-evlu_pfls_amt2 평가손익금액2 String Y 31 해당 종목의 매입금액과 평가금액의 외회기준 비교 손익
-evlu_pfls_rt1 평가손익율1 String Y 32 해당 종목의 평가손익을 기준으로 한 수익률
-pdno 상품번호 String Y 12 종목코드
-bass_exrt 기준환율 String Y 31 원화 평가 시 적용 환율
-buy_crcy_cd 매수통화코드 String Y 3 USD : 미국달러
HKD : 홍콩달러
CNY : 중국위안화
JPY : 일본엔화
VND : 베트남동
-ovrs_now_pric1 해외현재가격1 String Y 29 해당 종목의 현재가
-avg_unpr3 평균단가3 String Y 29 해당 종목의 매수 평균 단가
-tr_mket_name 거래시장명 String Y 60 해당 종목의 거래시장명
-natn_kor_name 국가한글명 String Y 60 거래 국가명
-pchs_rmnd_wcrc_amt 매입잔액원화금액 String Y 19
-thdt_buy_ccld_frcr_amt 당일매수체결외화금액 Object Y 30 당일 매수 외화금액
(Type: Object X String O)
-thdt_sll_ccld_frcr_amt 당일매도체결외화금액 String Y 30 당일 매도 외화금액
-unit_amt 단위금액 String Y 19
-std_pdno 표준상품번호 String Y 12
-prdt_type_cd 상품유형코드 String Y 3
-scts_dvsn_name 유가증권구분명 String Y 60
-loan_rmnd 대출잔액 String Y 19 대출 미상환 금액
-loan_dt 대출일자 String Y 8 대출 실행일자
-loan_expd_dt 대출만기일자 String Y 8 대출 만기일자
-ovrs_excg_cd 해외거래소코드 String Y 4 NASD : 나스닥
NYSE : 뉴욕
AMEX : 아멕스
SEHK : 홍콩
SHAA : 중국상해
SZAA : 중국심천
TKSE : 일본
HASE : 하노이거래소
VNSE : 호치민거래소
-item_lnkg_excg_cd 종목연동거래소코드 String Y 4 prdt_dvsn(상품구분) : 직원용 데이터(Type: String, Length:2)
output2 응답상세2 Array Y
-crcy_cd 통화코드 String Y 3
-crcy_cd_name 통화코드명 String Y 60
-frcr_buy_amt_smtl 외화매수금액합계 String Y 29 해당 통화로 매수한 종목 전체의 매수금액
-frcr_sll_amt_smtl 외화매도금액합계 String Y 29 해당 통화로 매도한 종목 전체의 매수금액
-frcr_dncl_amt_2 외화예수금액2 String Y 29
-frst_bltn_exrt 최초고시환율 String Y 31
-frcr_buy_mgn_amt 외화매수증거금액 String Y 31 매수증거금으로 사용된 외화금액
-frcr_etc_mgna 외화기타증거금 String Y 31
-frcr_drwg_psbl_amt_1 외화출금가능금액1 String Y 29 출금가능한 외화금액
-frcr_evlu_amt2 출금가능원화금액 String Y 29 출금가능한 원화금액
-acpl_cstd_crcy_yn 현지보관통화여부 String Y 1
-nxdy_frcr_drwg_psbl_amt 익일외화출금가능금액 String Y 31
output3 응답상세3 Object Y
-pchs_amt_smtl 매입금액합계 String Y 19 해외유가증권 매수금액의 원화 환산 금액
-evlu_amt_smtl 평가금액합계 String Y 19 해외유가증권 평가금액의 원화 환산 금액
-evlu_pfls_amt_smtl 평가손익금액합계 String Y 19 해외유가증권 평가손익의 원화 환산 금액
-dncl_amt 예수금액 String Y 19
-cma_evlu_amt CMA평가금액 String Y 19
-tot_dncl_amt 총예수금액 String Y 19
-etc_mgna 기타증거금 String Y 19
-wdrw_psbl_tot_amt 인출가능총금액 String Y 19
-frcr_evlu_tota 외화평가총액 String Y 19
-evlu_erng_rt1 평가수익율1 String Y 31
-pchs_amt_smtl_amt 매입금액합계금액 String Y 19
-evlu_amt_smtl_amt 평가금액합계금액 String Y 19
-tot_evlu_pfls_amt 총평가손익금액 String Y 31
-tot_asst_amt 총자산금액 String Y 19
-buy_mgn_amt 매수증거금액 String Y 19
-mgna_tota 증거금총액 String Y 19
-frcr_use_psbl_amt 외화사용가능금액 String Y 20
-ustl_sll_amt_smtl 미결제매도금액합계 String Y 19
-ustl_buy_amt_smtl 미결제매수금액합계 String Y 19
-tot_frcr_cblc_smtl 총외화잔고합계 String Y 29
-tot_loan_amt 총대출금액 String Y 19

Example

Request

{
"CANO": "810XXXXX",
"ACNT_PRDT_CD":"01",
"WCRC_FRCR_DVSN_CD": "01",
"TR_MKET_CD": "00",
"NATN_CD": "000",
"INQR_DVSN_CD": "00"
}

Response

{
  "output1": [
    {
      "prdt_name": "애플",
      "cblc_qty13": "40.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "40.00000000",
      "ord_psbl_qty1": "40.00000000",
      "frcr_pchs_amt": "6411629.00000",
      "frcr_evlu_amt2": "8491110.000000",
      "evlu_pfls_amt2": "2079481.00000",
      "evlu_pfls_rt1": "32.43000000",
      "pdno": "AAPL",
      "bass_exrt": "1212.60000000",
      "buy_crcy_cd": "USD",
      "ovrs_now_pric1": "212277.75600",
      "avg_unpr3": "160290.7250",
      "tr_mket_name": "나스닥",
      "natn_kor_name": "미국",
      "pchs_rmnd_wcrc_amt": "5986768",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "1",
      "std_pdno": "US0378331005",
      "prdt_type_cd": "512",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "NASD",
      "item_lnkg_excg_cd": "NAS"
    },
    {
      "prdt_name": "테슬라",
      "cblc_qty13": "5.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "5.00000000",
      "ord_psbl_qty1": "5.00000000",
      "frcr_pchs_amt": "4665399.00000",
      "frcr_evlu_amt2": "6616309.000000",
      "evlu_pfls_amt2": "1950910.00000",
      "evlu_pfls_rt1": "41.81000000",
      "pdno": "TSLA",
      "bass_exrt": "1212.60000000",
      "buy_crcy_cd": "USD",
      "ovrs_now_pric1": "1323261.87600",
      "avg_unpr3": "933079.8000",
      "tr_mket_name": "나스닥",
      "natn_kor_name": "미국",
      "pchs_rmnd_wcrc_amt": "4560861",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "1",
      "std_pdno": "US88160R1014",
      "prdt_type_cd": "512",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "NASD",
      "item_lnkg_excg_cd": "NAS"
    },
    {
      "prdt_name": "월트디즈니",
      "cblc_qty13": "24.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "24.00000000",
      "ord_psbl_qty1": "24.00000000",
      "frcr_pchs_amt": "5039237.00000",
      "frcr_evlu_amt2": "3946867.000000",
      "evlu_pfls_amt2": "-1092370.00000",
      "evlu_pfls_rt1": "-21.67000000",
      "pdno": "DIS",
      "bass_exrt": "1212.60000000",
      "buy_crcy_cd": "USD",
      "ovrs_now_pric1": "164452.81200",
      "avg_unpr3": "209968.2080",
      "tr_mket_name": "뉴욕거래소",
      "natn_kor_name": "미국",
      "pchs_rmnd_wcrc_amt": "4766780",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "1",
      "std_pdno": "US2546871060",
      "prdt_type_cd": "513",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "NYSE",
      "item_lnkg_excg_cd": "NYS"
    },
    {
      "prdt_name": "[4689]Z홀딩스",
      "cblc_qty13": "1300.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "1300.00000000",
      "ord_psbl_qty1": "1300.00000000",
      "frcr_pchs_amt": "8556162.00000",
      "frcr_evlu_amt2": "6618273.000000",
      "evlu_pfls_amt2": "-1937889.00000",
      "evlu_pfls_rt1": "-22.64000000",
      "pdno": "4689",
      "bass_exrt": "981.11000000",
      "buy_crcy_cd": "JPY",
      "ovrs_now_pric1": "5090.97900",
      "avg_unpr3": "6581.6630",
      "tr_mket_name": "일본",
      "natn_kor_name": "일본",
      "pchs_rmnd_wcrc_amt": "9196585",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "100",
      "std_pdno": "JP3933800009",
      "prdt_type_cd": "515",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "TKSE",
      "item_lnkg_excg_cd": "TSE"
    },
    {
      "prdt_name": "ARK GENOMIC REVOLUTION ETF",
      "cblc_qty13": "36.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "36.00000000",
      "ord_psbl_qty1": "36.00000000",
      "frcr_pchs_amt": "3746679.00000",
      "frcr_evlu_amt2": "2022471.000000",
      "evlu_pfls_amt2": "-1724208.00000",
      "evlu_pfls_rt1": "-46.01000000",
      "pdno": "ARKG",
      "bass_exrt": "1212.60000000",
      "buy_crcy_cd": "USD",
      "ovrs_now_pric1": "56179.75800",
      "avg_unpr3": "104074.4160",
      "tr_mket_name": "아멕스",
      "natn_kor_name": "미국",
      "pchs_rmnd_wcrc_amt": "3533904",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "1",
      "std_pdno": "US00214Q3020",
      "prdt_type_cd": "529",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "AMEX",
      "item_lnkg_excg_cd": "AMS"
    },
    {
      "prdt_name": "[002747]애사돈자동화",
      "cblc_qty13": "400.00000000",
      "thdt_buy_ccld_qty1": "0.00000000",
      "thdt_sll_ccld_qty1": "0.00000000",
      "ccld_qty_smtl1": "400.00000000",
      "ord_psbl_qty1": "400.00000000",
      "frcr_pchs_amt": "2327369.00000",
      "frcr_evlu_amt2": "1525444.000000",
      "evlu_pfls_amt2": "-801925.00000",
      "evlu_pfls_rt1": "-34.45000000",
      "pdno": "002747",
      "bass_exrt": "190.30000000",
      "buy_crcy_cd": "CNY",
      "ovrs_now_pric1": "3813.61200",
      "avg_unpr3": "5818.4220",
      "tr_mket_name": "심천A",
      "natn_kor_name": "중화인민공화국",
      "pchs_rmnd_wcrc_amt": "2121990",
      "thdt_buy_ccld_frcr_amt": "0.000000",
      "thdt_sll_ccld_frcr_amt": "0.000000",
      "unit_amt": "1",
      "std_pdno": "CNE100001X35",
      "prdt_type_cd": "552",
      "scts_dvsn_name": "현금",
      "loan_rmnd": "0",
      "loan_dt": "",
      "loan_expd_dt": "",
      "ovrs_excg_cd": "SZAA",
      "item_lnkg_excg_c

해외주식 예약주문조회[v1_해외주식-013]

REST

해외주식 예약주문조회[v1_해외주식-013]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-stock/v1/trading/order-resv-list
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

해외주식 예약주문 조회 API입니다.
※ 모의투자는 사용 불가합니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
미국 : TTTT3039R
일본, 중국, 홍콩, 베트남 : TTTS3014R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String N 1 B : 법인 / P : 개인
seq_no 일련번호 String N 2 법인 : "001" / 개인: ""(Default)
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
INQR_STRT_DT 조회시작일자 String Y 8 조회시작일자(YYYYMMDD)
INQR_END_DT 조회종료일자 String Y 8 조회종료일자(YYYYMMDD)
INQR_DVSN_CD 조회구분코드 String Y 2 00 : 전체
01 : 일반해외주식
02 : 미니스탁
PRDT_TYPE_CD 상품유형코드 String Y 3 512 : 미국 나스닥 / 513 : 미국 뉴욕거래소 / 529 : 미국 아멕스
515 : 일본
501 : 홍콩 / 543 : 홍콩CNY / 558 : 홍콩USD
507 : 베트남 하노이거래소 / 508 : 베트남 호치민거래소
551 : 중국 상해A / 552 : 중국 심천A
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥 / NYSE : 뉴욕 / AMEX : 아멕스
SEHK : 홍콩 / SHAA : 중국상해 / SZAA : 중국심천
TKSE : 일본 / HASE : 하노이거래소 / VNSE : 호치민거래소
CTX_AREA_FK200 연속조회검색조건200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_FK200값 : 다음페이지 조회시(2번째부터)
CTX_AREA_NK200 연속조회키200 String Y 200 공란 : 최초 조회시
이전 조회 Output CTX_AREA_NK200값 : 다음페이지 조회시(2번째부터)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
ctx_area_fk200 연속조회검색조건200 String Y 200
ctx_area_nk200 연속조회키200 String Y 200
output 응답상세1 Object N
-cncl_yn 취소여부 String N 1
-rsvn_ord_rcit_dt 예약주문접수일자 String N 8
-ovrs_rsvn_odno 해외예약주문번호 String N 10
-ord_dt 주문일자 String N 8
-ord_gno_brno 주문채번지점번호 String N 5
-odno 주문번호 String N 10
-sll_buy_dvsn_cd 매도매수구분코드 String N 2
-sll_buy_dvsn_name 매도매수구분명 String N 4
-ovrs_rsvn_ord_stat_cd 해외예약주문상태코드 String N 2
-ovrs_rsvn_ord_stat_cd_name 해외예약주문상태코드명 String N 60
-pdno 상품번호 String N 12
-prdt_type_cd 상품유형코드 String N 3
-prdt_name 상품명 String N 60
-ord_rcit_tmd 주문접수시각 String N 6
-ord_fwdg_tmd 주문전송시각 String N 6
-tr_dvsn_name 거래구분명 String N 60
-ovrs_excg_cd 해외거래소코드 String N 4
-tr_mket_name 거래시장명 String N 60
-ord_stfno 주문직원번호 String N 6
-ft_ord_qty FT주문수량 String N 10
-ft_ord_unpr3 FT주문단가3 String N 27
-ft_ccld_qty FT체결수량 String N 10
-ft_ccld_unpr3 FT체결단가3 String N 27
-nprc_rson_text 미처리사유내용 String N 500

Example

Request

        "input": {
            "ACNT_PRDT_CD": "01",
            "CANO": "81019***",
            "CTX_AREA_FK200": "",
            "CTX_AREA_NK200": "",
            "INQR_DVSN_CD": "00",
            "INQR_END_DT": "20220709",
            "INQR_STRT_DT": "20220705",
            "OVRS_EXCG_CD": "SEHK",
            "PRDT_TYPE_CD": "501"
        }

Response

            {
                "cncl_yn": "N",
                "ft_ccld_qty": "0",
                "ft_ccld_unpr3": "0.00000000",
                "ft_ord_qty": "100",
                "ft_ord_unpr3": "344.60000000",
                "nprc_rson_text": "",
                "odno": "",
                "ord_dt": "",
                "ord_fwdg_tmd": "",
                "ord_gno_brno": "",
                "ord_rcit_tmd": "124855",
                "ord_stfno": "999999",
                "ovrs_excg_cd": "SEHK",
                "ovrs_rsvn_odno": "0000008402",
                "ovrs_rsvn_ord_stat_cd": "01",
                "ovrs_rsvn_ord_stat_cd_name": "접수",
                "pdno": "00700",
                "prdt_name": "텐센트",
                "prdt_type_cd": "501",
                "rsvn_ord_rcit_dt": "20220706",
                "sll_buy_dvsn_cd": "02",
                "sll_buy_dvsn_name": "매수",
                "tr_dvsn_name": "접수",
                "tr_mket_name": "홍콩"
            },

해외주식 매수가능금액조회[v1_해외주식-014]

REST

해외주식 매수가능금액조회[v1_해외주식-014]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-stock/v1/trading/inquire-psamount
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

해외주식 매수가능금액조회 API입니다.
※ 모의투자는 사용 불가합니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String N 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTS3007R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String N 1 B : 법인 / P : 개인
seq_no 일련번호 String N 2 법인 : "001" / 개인: ""(Default)
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD : 나스닥 / NYSE : 뉴욕 / AMEX : 아멕스
SEHK : 홍콩 / SHAA : 중국상해 / SZAA : 중국심천
TKSE : 일본 / HASE : 하노이거래소 / VNSE : 호치민거래소
OVRS_ORD_UNPR 해외주문단가 String Y 27 해외주문단가 (23.8) 정수부분 23자리, 소수부분 8자리
ITEM_CD 종목코드 String Y 12 종목코드

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output 응답상세1 Object N
-tr_crcy_cd 거래통화코드 String N 3 18.2
-ord_psbl_frcr_amt 주문가능외화금액 String N 21 18.2
-sll_ruse_psbl_amt 매도재사용가능금액 String N 21 가능금액 산정 시 사용
-ovrs_ord_psbl_amt 해외주문가능금액 String N 21 - 한국투자 앱 해외주식 주문화면내 "외화" 인경우 주문가능금액
-max_ord_psbl_qty 최대주문가능수량 String N 19 - 한국투자 앱 해외주식 주문화면내 "외화" 인경우 주문가능수량
- 매수 시 수량단위 절사해서 사용
예 : (100주단위) 545 주 -> 500 주 / (10주단위) 545 주 -> 540 주
-echm_af_ord_psbl_amt 환전이후주문가능금액 String N 21
-echm_af_ord_psbl_qty 환전이후주문가능수량 String N 19
-ord_psbl_qty 주문가능수량 String N 10 22(20.1)
-exrt 환율 String N 22 25(18.6)
-frcr_ord_psbl_amt1 외화주문가능금액1 String N 25 - 한국투자 앱 해외주식 주문화면내 "통합" 인경우 주문가능금액
-ovrs_max_ord_psbl_qty 해외최대주문가능수량 String N 19 - 한국투자 앱 해외주식 주문화면내 "통합" 인경우 주문가능수량
- 매수 시 수량단위 절사해서 사용
예 : (100주단위) 545 주 -> 500 주 / (10주단위) 545 주 -> 540 주

Example

Request

        "input": {
            "ACNT_PRDT_CD": "01",
            "CANO": "81019777",
            "ITEM_CD": "00011",
            "OVRS_EXCG_CD": "SEHK",
            "OVRS_ORD_UNPR": "133.200"
        }

Response

        "output": {
            "echm_af_ord_psbl_amt": "0.00",
            "echm_af_ord_psbl_qty": "0",
            "exrt": "165.5400000000",
            "frcr_ord_psbl_amt1": "955**.12",
            "max_ord_psbl_qty": "744**",
            "ord_psbl_frcr_amt": "999**.52",
            "ord_psbl_qty": "744**",
            "ovrs_max_ord_psbl_qty": "717**",
            "ovrs_ord_psbl_amt": "992**.35",
            "sll_ruse_psbl_amt": "0.00",
            "tr_crcy_cd": "HKD"
        }

해외주식 미국주간주문[v1_해외주식-026]

REST

해외주식 미국주간주문[v1_해외주식-026]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-stock/v1/trading/daytime-order
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

해외주식 미국주간주문 API입니다.

* 미국주간거래 현재가 조회는 API로 제공되고 있지 않으며, 2023.3.31.금 신규 개발되어 운영 반영 예정입니다.
그 전까지는 HTS(efriend Plus) [7650] 미국 주간거래 현재가 화면에서 현재가 확인을 부탁드립니다.

* 미국주간거래의 경우, 모든 미국 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

* 미국주간거래시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요.
. 주간거래(장전거래)(한국시간 기준) : 10:00 ~ 18:00 (Summer Time 동일)

* 한국투자증권 해외주식 시장별 매매안내(매매수수료, 거래시간 안내, 결제일 정보, 환전안내)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca050000.jsp

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
미국주간매수 : TTTS6036U
미국주간매도 : TTTS6037U
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String Y 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD:나스닥 / NYSE:뉴욕 / AMEX:아멕스
PDNO 상품번호 String Y 12 종목코드
ORD_QTY 주문수량 String Y 10 해외거래소 별 최소 주문수량 및 주문단위 확인 필요
OVRS_ORD_UNPR 해외주문단가 String Y 32 소수점 포함, 1주당 가격
* 시장가의 경우 1주당 가격을 공란으로 비우지 않음 "0"으로 입력
CTAC_TLNO 연락전화번호 String N 20 " "
MGCO_APTM_ODNO 운용사지정주문번호 String N 12 " "
ORD_SVR_DVSN_CD 주문서버구분코드 String Y 1 "0"
ORD_DVSN 주문구분 String Y 2 [미국 매수/매도 주문]
00 : 지정가
* 주간거래는 지정가만 가능

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
Output1 응답상세 Object N
-KRX_FWDG_ORD_ORGNO 한국거래소전송주문조직번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
-ODNO 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
-ORD_TMD 주문시각 String Y 6 주문시각(시분초HHMMSS)

해외주식 미국주간정정취소[v1_해외주식-027]

REST

해외주식 미국주간정정취소[v1_해외주식-027]

기본정보

  • Method
    POST
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-stock/v1/trading/daytime-order-rvsecncl
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

해외주식 미국주간정정취소 API입니다.

* 미국주간거래 현재가 조회는 API로 제공되고 있지 않으며, 2023.3.31.금 신규 개발되어 운영 반영 예정입니다.
그 전까지는 HTS(efriend Plus) [7650] 미국 주간거래 현재가 화면에서 현재가 확인을 부탁드립니다.

* 미국주간거래의 경우, 모든 미국 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

* 미국주간거래시간 외 API 호출 시 에러가 발생하오니 운영시간을 확인해주세요.
. 주간거래(장전거래)(한국시간 기준) : 10:00 ~ 18:00 (Summer Time 동일)

* 한국투자증권 해외주식 시장별 매매안내(매매수수료, 거래시간 안내, 결제일 정보, 환전안내)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca050000.jsp

※ POST API의 경우 BODY값의 key값들을 대문자로 작성하셔야 합니다.
(EX. "CANO" : "12345678", "ACNT_PRDT_CD": "01",...)

※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
미국주간 정정취소 : TTTS6038U
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String Y 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 4 NASD:나스닥 / NYSE:뉴욕 / AMEX:아멕스
PDNO 상품번호 String Y 12 종목코드
ORGN_ODNO 원주문번호 String Y 10 '정정 또는 취소할 원주문번호(매매 TR의 주문번호)
- 해외주식 주문체결내역api (/uapi/overseas-stock/v1/trading/inquire-nccs)에서 odno(주문번호) 참조'
RVSE_CNCL_DVSN_CD 정정취소구분코드 String Y 2 '01 : 정정
02 : 취소'
ORD_QTY 주문수량 String Y 10
OVRS_ORD_UNPR 해외주문단가 String Y 32 소수점 포함, 1주당 가격
CTAC_TLNO 연락전화번호 String Y 20 " "
MGCO_APTM_ODNO 운용사지정주문번호 String Y 12 " "
ORD_SVR_DVSN_CD 주문서버구분코드 String Y 1 "0"

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
Output1 응답상세 Object N
-KRX_FWDG_ORD_ORGNO 한국거래소전송주문조직번호 String Y 5 주문시 한국투자증권 시스템에서 지정된 영업점코드
-ODNO 주문번호 String Y 10 주문시 한국투자증권 시스템에서 채번된 주문번호
-ORD_TMD 주문시각 String Y 6 주문시각(시분초HHMMSS)

해외주식 기간손익[v1_해외주식-032]

REST

해외주식 기간손익[v1_해외주식-032]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-stock/v1/trading/inquire-period-profit
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

해외주식 기간손익 API입니다.
한국투자 HTS(eFriend Plus) > [7717] 해외 기간손익 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 [실전투자]
TTTS3039R
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String Y 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Query Parameter

Element 한글명 Type Required Length Description
CANO 종합계좌번호 String Y 8 계좌번호 체계(8-2)의 앞 8자리
ACNT_PRDT_CD 계좌상품코드 String Y 2 계좌번호 체계(8-2)의 뒤 2자리
OVRS_EXCG_CD 해외거래소코드 String Y 2 공란 : 전체,
NASD : 미국, SEHK : 홍콩,
SHAA : 중국, TKSE : 일본, HASE : 베트남
NATN_CD 국가코드 String Y 2 공란(Default)
CRCY_CD 통화코드 String Y 2 공란 : 전체
USD : 미국달러, HKD : 홍콩달러,
CNY : 중국위안화, JPY : 일본엔화, VND : 베트남동
PDNO 상품번호 String Y 2 공란 : 전체
INQR_STRT_DT 조회시작일자 String Y 2 YYYYMMDD
INQR_END_DT 조회종료일자 String Y 2 YYYYMMDD
WCRC_FRCR_DVSN_CD 원화외화구분코드 String Y 2 01 : 외화, 02 : 원화
CTX_AREA_FK200 연속조회검색조건200 String Y 2
CTX_AREA_NK200 연속조회키200 String Y 2

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
Output1 응답상세 Object Array Y array
-trad_day 매매일 String Y 8
-ovrs_pdno 해외상품번호 String Y 12
-ovrs_item_name 해외종목명 String Y 60
-slcl_qty 매도청산수량 String Y 10
-pchs_avg_pric 매입평균가격 String Y 184
-frcr_pchs_amt1 외화매입금액1 String Y 185
-avg_sll_unpr 평균매도단가 String Y 238
-frcr_sll_amt_smtl1 외화매도금액합계1 String Y 186
-stck_sll_tlex 주식매도제비용 String Y 184
-ovrs_rlzt_pfls_amt 해외실현손익금액 String Y 145
-pftrt 수익률 String Y 238
-exrt 환율 String Y 201
-ovrs_excg_cd 해외거래소코드 String Y 4
-frst_bltn_exrt 최초고시환율 String Y 238
Output2 응답상세2 Object Y
-stck_sll_amt_smtl 주식매도금액합계 String Y 184 WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시
-stck_buy_amt_smtl 주식매수금액합계 String Y 184 WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시
-smtl_fee1 합계수수료1 String Y 138 WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시
-excc_dfrm_amt 정산지급금액 String Y 205 WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시
-ovrs_rlzt_pfls_tot_amt 해외실현손익총금액 String Y 145 WCRC_FRCR_DVSN_CD(원화외화구분코드)가 01(외화)이고
OVRS_EXCG_CD(해외거래소코드)가 공란(전체)인 경우
출력값 무시
-tot_pftrt 총수익률 String Y 238
-bass_dt 기준일자 String Y 8
-exrt 환율 String Y 201