API 문서 HOME API 문서 [해외주식] 주문/계좌
[해외주식] 주문/계좌
해외주식 주문[v1_해외주식-001]
REST
해외주식 주문[v1_해외주식-001]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/overseas-stock/v1/trading/order
- FormatJSON
- Content-Typeapplication/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
* 모의투자의 경우, 모든 해외 종목 매매가 지원되지 않습니다. 일부 종목만 매매 가능한 점 유의 부탁드립니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 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"
}
"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"
}
}
"rt_cd": "0",
"msg_cd": "APBK0013",
"msg1": "주문 전송 완료 되었습니다.",
"output": {
"KRX_FWDG_ORD_ORGNO": "01790",
"ODNO": "0000004336",
"ORD_TMD": "160524"
}
}
해외주식 정정취소주문[v1_해외주식-003]
REST
해외주식 정정취소주문[v1_해외주식-003]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/overseas-stock/v1/trading/order-rvsecncl
- FormatJSON
- Content-Typeapplication/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",...)
(해외주식주문 시 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"
}
"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"
}
}
"rt_cd": "0",
"msg_cd": "APBK0013",
"msg1": "주문 전송 완료 되었습니다.",
"output": {
"KRX_FWDG_ORD_ORGNO": "01790",
"ODNO": "0000004338",
"ORD_TMD": "160710"
}
}
해외주식 예약주문접수[v1_해외주식-002]
REST
해외주식 예약주문접수[v1_해외주식-002]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/overseas-stock/v1/trading/order-resv
- Format
- Content-Typeapplication/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(장개시시장가)로 주문 접수 가능
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 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"
}
"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"
}
}
"rt_cd": "0",
"msg_cd": "APBK0013",
"msg1": "주문 전송 완료 되었습니다.",
"output": {
"ODNO": "0030138295"
}
}
해외주식 예약주문접수취소[v1_해외주식-004]
REST
해외주식 예약주문접수취소[v1_해외주식-004]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/overseas-stock/v1/trading/order-resv-ccnl
- FormatJSON
- Content-Typeapplication/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",...)
(해외주식 예약주문접수 시 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"
}
"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"
}
}
"rt_cd": "0",
"msg_cd": "APBK1711",
"msg1": "취소주문이 접수되었습니다.",
"output": {
"OVRS_RSVN_ODNO": "0030138295"
}
}
해외주식 미체결내역[v1_해외주식-005]
REST
해외주식 미체결내역[v1_해외주식-005]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://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
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 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 유통대주 10 현금 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": ""
}
"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": "조회가 완료되었습니다 "
}
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://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로 확인이 불가합니다.
한국투자 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 : 유통대주 10 : 현금 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": ""
}
"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": "조회가 완료되었습니다 "
}
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/overseas-stock/v1/trading/inquire-ccnl
- FormatJSON
- Content-Typeapplication/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
실전계좌의 경우, 한 번의 호출에 최대 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 | 00 : 해당사항없음
01 : 자기융자일반형 03 : 자기융자투자형 05 : 유통융자일반형 06 : 유통융자투자형 07 : 자기대주 09 : 유통대주 10 : 현금 11 : 주식담보대출 12 : 수익증권담보대출 13 : ELS담보대출 14 : 채권담보대출 15 : 해외주식담보대출 16 : 기업신용공여 31 : 소액자동담보대출 41 : 매도담보대출 42 : 환매자금대출 43 : 매입환매자금대출 44 : 대여매도담보대출 81 : 대차거래 82 : 법인CMA론 91 : 공모주청약자금대출 92 : 매입자금 93 : 미수론서비스 94 : 대여 |
-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": ""
}
"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": "조회할 내용이 없습니다 "
}
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://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) 및 거래량이 많은 경우 메인시스템에 반영되는 시간으로 인해 차이가
발생할 수 있습니다.
※ 배치작업시간에 따라 시간은 변동될 수 있습니다.
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"
}
"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
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/overseas-stock/v1/trading/order-resv-list
- FormatJSON
- Content-Typeapplication/json; charset=utf-8
개요
해외주식 예약주문 조회 API입니다.
※ 모의투자는 사용 불가합니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
※ 모의투자는 사용 불가합니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 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 | [tr_id=TTTT3039R인 경우]
공백 입력 시 미국주식 전체조회 [tr_id=TTTS3014R인 경우] 공백 입력 시 아시아주식 전체조회 512 : 미국 나스닥 / 513 : 미국 뉴욕거래소 / 529 : 미국 아멕스 515 : 일본 501 : 홍콩 / 543 : 홍콩CNY / 558 : 홍콩USD 507 : 베트남 하노이거래소 / 508 : 베트남 호치민거래소 551 : 중국 상해A / 552 : 중국 심천A |
OVRS_EXCG_CD | 해외거래소코드 | String | Y | 4 | [tr_id=TTTT3039R인 경우]
공백 입력 시 미국주식 전체조회 [tr_id=TTTS3014R인 경우] 공백 입력 시 아시아주식 전체조회 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"
}
"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": "홍콩"
},
"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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/overseas-stock/v1/trading/inquire-psamount
- FormatJSON
- Content-Typeapplication/json; charset=utf-8
개요
해외주식 매수가능금액조회 API입니다.
※ 모의투자는 사용 불가합니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
※ 모의투자는 사용 불가합니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 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"
}
"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"
}
"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]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/overseas-stock/v1/trading/daytime-order
- FormatJSON
- Content-Typeapplication/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
* 미국주간거래 현재가 조회는 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]
기본정보
- MethodPOST
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/overseas-stock/v1/trading/daytime-order-rvsecncl
- FormatJSON
- Content-Typeapplication/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
* 미국주간거래 현재가 조회는 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]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/overseas-stock/v1/trading/inquire-period-profit
- FormatJSON
- Content-Typeapplication/json; charset=utf-8
개요
해외주식 기간손익 API입니다.
한국투자 HTS(eFriend Plus) > [7717] 해외 기간손익 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
* 해외주식 서비스 신청 후 이용 가능합니다. (아래 링크 3번 해외증권 거래신청 참고)
https://securities.koreainvestment.com/main/bond/research/_static/TF03ca010001.jsp
한국투자 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 |