trex/trex-core
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: add messaging transport rollout

Browse Source
This commit is contained in:
genichin
2026-06-06 00:02:52 +09:00
parent 4b91343ee8
commit 6c7a1cf6f6
383 changed files with 99045 additions and 487 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/broker/kis/rest/해외주식/기본시세/252_해외주식-037_해외주식-체결추이.md
+145
View File
@@ -0,0 +1,145 @@
# 해외주식 체결추이
- 원본 시트명: 해외주식 체결추이
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식-037
- HTTP Method: GET
- 실전 TR_ID: HHDFS76200300
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/inquire-ccnl
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 체결추이 API입니다.
한국투자 HTS(eFriend Plus) > [7625] 해외주식 체결추이 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76200300 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| EXCD | 거래소명 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 <br>HKS : 홍콩, SHS : 상해 , SZS : 심천<br>HSX : 호치민, HNX : 하노이<br>TSE : 도쿄 ' |
| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
| KEYB | NEXT KEY BUFF | string | Y | 32 | 공백 |
| TDAY | 당일전일구분 | string | Y | 1 | 0:전일, 1:당일 |
| SYMB | 종목코드 | string | Y | 16 | 해외종목코드 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output2 | 응답상세 | object array | Y | | array |
| khms | 한국기준시간 | string | Y | 6 | |
| last | 체결가 | string | Y | 12 | |
| sign | 기호 | string | Y | 1 | |
| diff | 대비 | string | Y | 12 | |
| rate | 등락율 | string | Y | 12 | |
| evol | 체결량 | string | Y | 10 | |
| tvol | 거래량 | string | Y | 14 | |
| mtyp | 시장구분 | string | Y | 1 | 0: 장중 1:장전 2:장후 |
| pbid | 매수호가 | string | Y | 12 | |
| pask | 매도호가 | string | Y | 12 | |
| vpow | 체결강도 | string | Y | 10 | |
| output1 | 응답상세 | object | Y | | |
| rsym | 실시간조회종목코드 | string | Y | 16 | |
| ZDIV | 소수점자리수 | string | Y | 1 | |
| NREC | Record Count | string | Y | 4 | |
## 예제
### Request Example (Python)
```text
AUTH:
EXCD:NAS
SYMB:AAPL
TDAY:0
KEYB:
```
### Response Example
```text
{
"output1": [
{
"khms": "085957",
"last": "195.2000",
"sign": "5",
"diff": "3.2200",
"rate": "-1.62",
"evol": "30",
"tvol": "29159135",
"mtyp": "",
"pbid": "195.1500",
"pask": "195.6000",
"vpow": "71.66"
},
{
"khms": "085957",
"last": "195.2000",
"sign": "5",
"diff": "3.2200",
"rate": "-1.62",
"evol": "10",
"tvol": "29159105",
"mtyp": "",
"pbid": "195.1500",
"pask": "195.6000",
"vpow": "71.66"
},...
{
"khms": "085505",
"last": "195.2700",
"sign": "5",
"diff": "3.1500",
"rate": "-1.59",
"evol": "50",
"tvol": "29155328",
"mtyp": "",
"pbid": "195.2300",
"pask": "195.3000",
"vpow": "71.67"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/해외주식/기본시세/253_v1_해외주식-010_해외주식-기간별시세.md
+1512
View File
File diff suppressed because it is too large Load Diff
docs/broker/kis/rest/해외주식/기본시세/254_해외주식-017_해외결제일자조회.md
+188
View File
@@ -0,0 +1,188 @@
# 해외결제일자조회
- 원본 시트명: 해외결제일자조회
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식-017
- HTTP Method: GET
- 실전 TR_ID: CTOS5011R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-stock/v1/quotations/countries-holiday
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외결제일자조회 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTOS5011R |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| TRAD_DT | 기준일자 | string | Y | 8 | 기준일자(YYYYMMDD) |
| CTX_AREA_NK | 연속조회키 | string | Y | 20 | 공백으로 입력 |
| CTX_AREA_FK | 연속조회검색조건 | string | Y | 20 | 공백으로 입력 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세1 | object | Y | | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | 512 미국 나스닥 / 513 미국 뉴욕거래소 / 529 미국 아멕스 <br>515 일본<br>501 홍콩 / 543 홍콩CNY / 558 홍콩USD<br>507 베트남 하노이거래소 / 508 베트남 호치민거래소<br>551 중국 상해A / 552 중국 심천A |
| tr_natn_cd | 거래국가코드 | string | Y | 3 | 840 미국 / 392 일본 / 344 홍콩<br>704 베트남 / 156 중국 |
| tr_natn_name | 거래국가명 | string | Y | 60 | |
| natn_eng_abrv_cd | 국가영문약어코드 | string | Y | 2 | US 미국 / JP 일본 / HK 홍콩<br>VN 베트남 / CN 중국 |
| tr_mket_cd | 거래시장코드 | string | Y | 2 | |
| tr_mket_name | 거래시장명 | string | Y | 60 | |
| acpl_sttl_dt | 현지결제일자 | string | Y | 8 | 현지결제일자(YYYYMMDD) |
| dmst_sttl_dt | 국내결제일자 | string | Y | 8 | 국내결제일자(YYYYMMDD) |
## 예제
### Request Example (Python)
```text
{
"TRAD_DT":"20221227",
"CTX_AREA_NK":"",
"CTX_AREA_FK":""
}
```
### Response Example
```text
{
"ctx_area_fk": "20221227 ",
"ctx_area_nk": " ",
"output": [
{
"prdt_type_cd": "507",
"tr_natn_cd": "704",
"tr_natn_name": "베트남",
"natn_eng_abrv_cd": "VN",
"tr_mket_cd": "01",
"tr_mket_name": "하노이거래소",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221229"
},
{
"prdt_type_cd": "508",
"tr_natn_cd": "704",
"tr_natn_name": "베트남",
"natn_eng_abrv_cd": "VN",
"tr_mket_cd": "02",
"tr_mket_name": "호치민거래소",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221229"
},
{
"prdt_type_cd": "512",
"tr_natn_cd": "840",
"tr_natn_name": "미국",
"natn_eng_abrv_cd": "US",
"tr_mket_cd": "01",
"tr_mket_name": "나스닥",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221230"
},
{
"prdt_type_cd": "513",
"tr_natn_cd": "840",
"tr_natn_name": "미국",
"natn_eng_abrv_cd": "US",
"tr_mket_cd": "02",
"tr_mket_name": "뉴욕거래소",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221230"
},
{
"prdt_type_cd": "515",
"tr_natn_cd": "392",
"tr_natn_name": "일본",
"natn_eng_abrv_cd": "JP",
"tr_mket_cd": "01",
"tr_mket_name": "일본",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221229"
},
{
"prdt_type_cd": "527",
"tr_natn_cd": "840",
"tr_natn_name": "미국",
"natn_eng_abrv_cd": "US",
"tr_mket_cd": "03",
"tr_mket_name": "미국",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221230"
},
{
"prdt_type_cd": "528",
"tr_natn_cd": "840",
"tr_natn_name": "미국",
"natn_eng_abrv_cd": "US",
"tr_mket_cd": "04",
"tr_mket_name": "미국",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221230"
},
{
"prdt_type_cd": "529",
"tr_natn_cd": "840",
"tr_natn_name": "미국",
"natn_eng_abrv_cd": "US",
"tr_mket_cd": "05",
"tr_mket_name": "아멕스",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221230"
},
{
"prdt_type_cd": "556",
"tr_natn_cd": "704",
"tr_natn_name": "베트남",
"natn_eng_abrv_cd": "VN",
"tr_mket_cd": "03",
"tr_mket_name": "업콤거래소",
"acpl_sttl_dt": "20221229",
"dmst_sttl_dt": "20221229"
}
],
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```
docs/broker/kis/rest/해외주식/기본시세/255_v1_해외주식-009_해외주식-현재체결가.md
+124
View File
@@ -0,0 +1,124 @@
# 해외주식 현재체결가
- 원본 시트명: 해외주식 현재체결가
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: v1_해외주식-009
- HTTP Method: GET
- 실전 TR_ID: HHDFS00000300
- 모의 TR_ID: HHDFS00000300
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/overseas-price/v1/quotations/price
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식종목의 현재체결가를 확인하는 API 입니다.
해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
홍콩, 베트남, 중국, 일본 - 15분지연
미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
[미국주식시세 이용시 유의사항]
■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
이용에 유의 부탁드립니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token<br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)<br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]<br>HHDFS00000300 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호<br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | "" (Null 값 설정) |
| EXCD | 거래소코드 | string | Y | 4 | HKS : 홍콩<br>NYS : 뉴욕<br>NAS : 나스닥<br>AMS : 아멕스<br>TSE : 도쿄<br>SHS : 상해<br>SZS : 심천<br>SHI : 상해지수<br>SZI : 심천지수<br>HSX : 호치민<br>HNX : 하노이<br>BAY : 뉴욕(주간)<br>BAQ : 나스닥(주간)<br>BAA : 아멕스(주간) |
| SYMB | 종목코드 | string | Y | 16 | |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | 0 : 성공 <br>0 이외의 값 : 실패 |
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
| output | 응답상세 | object | Y | | |
| rsym | 실시간조회종목코드 | string | Y | 16 | D+시장구분(3자리)+종목코드<br>예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)<br>[시장구분]<br>NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,<br>TSE : 도쿄, HKS : 홍콩,<br>SHS : 상해, SZS : 심천<br>HSX : 호치민, HNX : 하노이 |
| zdiv | 소수점자리수 | string | Y | 1 | |
| base | 전일종가 | string | Y | 12 | 전일의 종가 |
| pvol | 전일거래량 | string | Y | 14 | 전일의 거래량 |
| last | 현재가 | string | Y | 12 | 당일 조회시점의 현재 가격 |
| sign | 대비기호 | string | Y | 1 | 1 : 상한<br>2 : 상승<br>3 : 보합<br>4 : 하한<br>5 : 하락 |
| diff | 대비 | string | Y | 12 | 전일 종가와 당일 현재가의 차이 (당일 현재가-전일 종가) |
| rate | 등락율 | string | Y | 12 | 전일 대비 / 당일 현재가 * 100 |
| tvol | 거래량 | string | Y | 14 | 당일 조회시점까지 전체 거래량 |
| tamt | 거래대금 | string | Y | 14 | 당일 조회시점까지 전체 거래금액 |
| ordy | 매수가능여부 | string | Y | 20 | 매수주문 가능 종목 여부 |
## 예제
### Request Example (Python)
```text
{
"AUTH": "",
"EXCD": "NAS",
"SYMB": "TSLA"
}
```
### Response Example
```text
{
"output": {
"rsym": "DNASTSLA",
"zdiv": "4",
"base": "1091.2600",
"pvol": "26691673",
"last": "1091.2600",
"sign": "0",
"diff": "0.0000",
"rate": " 0.00",
"tvol": "0",
"tamt": "0",
"ordy": "매도불가"
},
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/해외주식/기본시세/256_해외주식-복수종목-시세조회_해외주식-복수종목-시세조회.md
+130
View File
@@ -0,0 +1,130 @@
# 해외주식 복수종목 시세조회
- 원본 시트명: 해외주식 복수종목 시세조회
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식 복수종목 시세조회
- HTTP Method: GET
- 실전 TR_ID: HHDFS76220000
- 모의 TR_ID: 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/multprice
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
홍콩, 베트남, 중국, 일본 - 15분지연
미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
[미국주식시세 이용시 유의사항]
■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
이용에 유의 부탁드립니다.
## 레이아웃
### 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 <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76220000 |
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | 공백 입력 필수 |
| NREC | 종목요청개수 | string | Y | 4 | 최대 10 |
| EXCD_01 ~ 10 | 거래소코드 | string | Y | 4 | HKS : 홍콩<br>NYS : 뉴욕<br>NAS : 나스닥<br>AMS : 아멕스<br>TSE : 도쿄<br>SHS : 상해<br>SZS : 심천<br>SHI : 상해지수<br>SZI : 심천지수<br>HSX : 호치민<br>HNX : 하노이<br>BAY : 뉴욕(주간)<br>BAQ : 나스닥(주간)<br>BAA : 아멕스(주간) |
| SYMB_01 ~ 10 | 종목코드 | string | Y | 16 | API 문서 -> 종목정보파일 -> 마스터 파일 참조 |
### 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 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | string | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세 | object | Y | | |
| nrec | Output 개수 | string | Y | 4 | |
| output2 | 응답상세 | object array | Y | | Array |
| rsym | 실시간조회심볼 | string | Y | 16 | |
| excd | 거래소코드 | string | Y | 4 | |
| symb | 종목코드 | string | Y | 16 | |
| knam | 종목명 | string | Y | 48 | |
| exnm | 거래소명 | string | Y | 20 | |
| nnam | 국가명 | string | Y | 20 | |
| stat1 | 실 지 휴 정 재 | string | Y | 4 | |
| stat2 | 실시간 지연15분 휴장 거래정지 거래재개 | string | Y | 16 | |
| zdiv | 소수점자리수 | string | Y | 1 | |
| last | Last Price | string | Y | 12 | |
| sign | 대비기호 | string | Y | 1 | |
| diff | 대비 | string | Y | 12 | |
| rate | 등락율 | string | Y | 12 | |
| open | 시가 | string | Y | 12 | |
| high | 고가 | string | Y | 12 | |
| low | 저가 | string | Y | 12 | |
| pbid | Bid Price | string | Y | 12 | |
| pask | Ask Price | string | Y | 12 | |
| vbid | 매수호가잔량 | string | Y | 10 | |
| vask | 매도호가잔량 | string | Y | 10 | |
| bvol | 매수호가총잔량 | string | Y | 10 | |
| avol | 매도호가총잔량 | string | Y | 10 | |
| evol | 체결량 | string | Y | 10 | |
| tvol | 거래량 | string | Y | 14 | |
| tamt | 거래대금 | string | Y | 14 | |
| powx | 체결강도 | string | Y | 10 | |
| xhms | 현지기준시간(HHMMSS) | string | Y | 6 | |
| khms | 한국기준시간(HHMMSS) | string | Y | 6 | |
| curr | 통화코드 | string | Y | 4 | |
| base | Base Price | string | Y | 12 | |
| pvol | Previous Volume | string | Y | 14 | |
| pamt | 전일거래대금 | string | Y | 14 | |
| popen | 전일시가 | string | Y | 12 | |
| phigh | 전일고가 | string | Y | 12 | |
| plow | 전일저가 | string | Y | 12 | |
| shar | 상장주수 | string | Y | 16 | |
| mcap | 자본금 | string | Y | 16 | |
| tomv | 시가총액 | string | Y | 16 | |
| h52p | 52주최고가 | string | Y | 12 | |
| l52p | 52주최저가 | string | Y | 12 | |
| h52d | 52주최고일자 | string | Y | 8 | |
| l52d | 52주최저일자 | string | Y | 8 | |
| hanp | High Anual Price | string | Y | 12 | |
| lanp | Low Anual Price | string | Y | 12 | |
| hand | 연중최고일자 | string | Y | 8 | |
| land | 연중최저일자 | string | Y | 8 | |
| bnit | 매매단위 | string | Y | 6 | |
| t_xprc | 원환산당일가격 | string | Y | 12 | |
## 메모
- Request Example (Python)
- Response Example
docs/broker/kis/rest/해외주식/기본시세/257_v1_해외주식-015_해외주식조건검색.md
+238
View File
@@ -0,0 +1,238 @@
# 해외주식조건검색
- 원본 시트명: 해외주식조건검색
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: v1_해외주식-015
- HTTP Method: GET
- 실전 TR_ID: HHDFS76410000
- 모의 TR_ID: HHDFS76410000
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/overseas-price/v1/quotations/inquire-search
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 조건검색 API입니다.
한국투자 HTS(eFriend Plus) &gt; [7641] 해외주식 조건검색 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
현재 조건검색 결과값은 최대 100개까지 조회 가능합니다. 다음 조회(100개 이후의 값) 기능에 대해서는 개선검토 중에 있습니다.
※ 지연시세 지연시간 : 미국 - 실시간무료(0분지연) / 홍콩, 베트남, 중국, 일본 - 15분지연 (중국은 실시간시세 신청 시 무료실시간시세 제공)
미국의 경우 0분지연시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
※ 2024년 12월 13일(금) 오후 5시부터 HTS(efriend Plus) [7781] 시세신청(실시간) 화면에서 유료 서비스 신청 후 접근토큰 발급하면 최대 2시간 이후 실시간 유료 시세 수신 가능
※ 그날 거래량이나 시세 형성이 안된 종목은 해외주식 기간별시세(HHDFS76240000)에서는 조회되지만
해외주식 조건검색(HHDFS76410000)에서 조회되지 않습니다. (EX. NAS AATC)
[미국주식시세 이용시 유의사항]
■ 무료 실시간 시세 서비스가 기본 제공되며, 유료 실시간 시세 서비스는 HTS ‘[7781] 시세신청 (실시간)’과 MTS(모바일) ‘고객서비스 &gt; 거래 서비스신청 &gt; 해외주식 &gt; 해외 실시간시세 신청’ 에서 신청 가능합니다.
※ 무료(매수/매도 각 1호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
※ 유료(매수/매도 각 1호가) : 미국 전체 거래소들의 통합 주문체결 및 최우선 호가
■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로
현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
■ 무료∙유료 모두 미국에 상장된 종목(뉴욕, 나스닥, 아멕스 등)의 시세를 제공하며, 동일한 시스템을 사용하여 주문∙체결됩니다.
단, 무료∙유료의 기반 데이터 차이로 호가 및 체결 데이터는 차이가 발생할 수 있고, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 유료 실시간 시세 서비스와 다를 수 있으며,
종목별 과거 데이터(거래량, 시가, 종가, 고가, 차트 데이터 등)는 장 종료 후(오후 12시경) 유료 실시간 시세 서비스 데이터와 동일하게 업데이트됩니다.
■ 유료 실시간 시세 서비스는 신청 시 1~12개월까지 기간 선택 후 해당 요금을 일괄 납부하며,
해지 시 해지한 달의 말일까지 시세 제공 후 남은 기간 해당 금액이 환급되니 유의하시기 바랍니다.
(출처: 한국투자증권 외화증권 거래설명서 - https://www.truefriend.com/main/customer/guide/Guide.jsp?&cmd=TF04ag010002&currentPage=1&num=64)
■ output2에 조회되는 순위(rank)는 거래량을 기준으로 내림차순 정렬 시 나오는 순위인 점 참고 부탁드립니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)<br><br>※ 토큰 지정시 토큰 타입("Bearer") 지정 필요. 즉, 발급받은 접근토큰 앞에 앞에 "Bearer" 붙여서 호출<br>EX) "Bearer eyJ..........8GA" |
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | string | Y | 13 | HHDFS76410000 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| 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을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | "" (Null 값 설정) |
| EXCD | 거래소코드 | string | Y | 4 | NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 <br>HKS : 홍콩, SHS : 상해 , SZS : 심천<br>HSX : 호치민, HNX : 하노이<br>TSE : 도쿄 |
| CO_YN_PRICECUR | 현재가선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_PRICECUR | 현재가시작범위가 | string | N | 12 | 단위: 각국통화(JPY, USD, HKD, CNY, VND) |
| CO_EN_PRICECUR | 현재가끝범위가 | string | N | 12 | 단위: 각국통화(JPY, USD, HKD, CNY, VND) |
| CO_YN_RATE | 등락율선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_RATE | 등락율시작율 | string | N | 12 | % |
| CO_EN_RATE | 등락율끝율 | string | N | 12 | % |
| CO_YN_VALX | 시가총액선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_VALX | 시가총액시작액 | string | N | 12 | 단위: 천 |
| CO_EN_VALX | 시가총액끝액 | string | N | 12 | 단위: 천 |
| CO_YN_SHAR | 발행주식수선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_SHAR | 발행주식시작수 | string | N | 12 | 단위: 천 |
| CO_EN_SHAR | 발행주식끝수 | string | N | 112 | 단위: 천 |
| CO_YN_VOLUME | 거래량선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_VOLUME | 거래량시작량 | string | N | 12 | 단위: 주 |
| CO_EN_VOLUME | 거래량끝량 | string | N | 12 | 단위: 주 |
| CO_YN_AMT | 거래대금선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_AMT | 거래대금시작금 | string | N | 12 | 단위: 천 |
| CO_EN_AMT | 거래대금끝금 | string | N | 12 | 단위: 천 |
| CO_YN_EPS | EPS선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_EPS | EPS시작 | string | N | 12 | |
| CO_EN_EPS | EPS끝 | string | N | 12 | |
| CO_YN_PER | PER선택조건 | string | N | 1 | 해당조건 사용시(1), 미사용시 필수항목아님 |
| CO_ST_PER | PER시작 | string | N | 12 | |
| CO_EN_PER | PER끝 | string | N | 12 | |
| KEYB | NEXT KEY BUFF | string | N | 8 | "" 공백 입력 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세1 | object | Y | | |
| zdiv | 소수점자리수 | string | Y | 1 | 소수점자리수 |
| stat | 거래상태정보 | string | Y | 20 | 거래상태정보 |
| crec | 현재조회종목수 | string | Y | 6 | 현재조회종목수 |
| trec | 전체조회종목수 | string | Y | 6 | 전체조회종목수 |
| nrec | Record Count | string | Y | 4 | Record Count |
| output2 | 응답상세2 | object array | Y | | 조회결과 상세 |
| rsym | 실시간조회심볼 | string | N | 32 | 실시간조회심볼<br><br>D+시장구분(3자리)+종목코드<br>예) DNASAAPL : D+NAS(나스닥)+AAPL(애플)<br>[시장구분]<br>NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 ,<br>TSE : 도쿄, HKS : 홍콩,<br>SHS : 상해, SZS : 심천<br>HSX : 호치민, HNX : 하노이 |
| excd | 거래소코드 | string | N | 4 | 거래소코드 |
| name | 종목명 | string | N | 48 | 종목명 |
| symb | 종목코드 | string | N | 16 | 종목코드 |
| last | 현재가 | string | N | 12 | 현재가 |
| shar | 발행주식 | string | N | 14 | 발행주식수(단위: 천) |
| valx | 시가총액 | string | N | 14 | 시가총액(단위: 천) |
| plow | 저가 | string | N | 12 | 저가 |
| phigh | 고가 | string | N | 12 | 고가 |
| popen | 시가 | string | N | 12 | 시가 |
| tvol | 거래량 | string | N | 14 | 거래량(단위: 주) |
| rate | 등락율 | string | N | 12 | 등락율(%) |
| diff | 대비 | string | N | 12 | 대비 |
| sign | 기호 | string | N | 1 | 기호 |
| avol | 거래대금 | string | N | 14 | 거래대금(단위: 천) |
| eps | EPS | string | N | 14 | EPS |
| per | PER | string | N | 14 | PER |
| rank | 순위 | string | N | 6 | 순위 |
| ename | 영문종목명 | string | N | 48 | 영문종목명 |
| e_ordyn | 매매가능 | string | N | 2 | 가능 : O |
## 예제
### Request Example (Python)
```text
{
"AUTH":"",
"EXCD":"NAS",
"CO_YN_PRICECUR":"1",
"CO_ST_PRICECUR":"160",
"CO_EN_PRICECUR":"161",
"CO_YN_RATE":"",
"CO_ST_RATE":"",
"CO_EN_RATE":"",
"CO_YN_VALX":"",
"CO_ST_VALX":"",
"CO_EN_VALX":"",
"CO_YN_SHAR":"",
"CO_ST_SHAR":"",
"CO_EN_SHAR":"",
"CO_YN_VOLUME":"",
"CO_ST_VOLUME":"",
"CO_EN_VOLUME":"",
"CO_YN_AMT":"",
"CO_ST_AMT":"",
"CO_EN_AMT":"",
CO_YN_EPS":"",
CO_ST_EPS":"",
CO_EN_EPS":"",
CO_YN_PER":"",
CO_ST_PER":"",
CO_EN_PER":""
}
```
### Response Example
```text
{
"output1": {
"zdiv": "4",
"stat": "무료실시간",
"crec": "2",
"trec": "2",
"nrec": "2"
},
"output2": [
{
"rsym": "DNASTSLA",
"excd": "NAS",
"symb": "TSLA",
"name": "테슬라",
"last": "160.9500",
"sign": "5",
"diff": "6.8700",
"rate": "-4.09",
"tvol": "175862722",
"popen": "174.8700",
"phigh": "175.0500",
"plow": "156.9100",
"valx": "508239862",
"shar": "3157750000",
"avol": "28842552711",
"eps": "3.24",
"per": "49.73",
"rank": "1",
"ename": "TESLA INC",
"e_ordyn": "○"
},
{
"rsym": "DNASPANW",
"excd": "NAS",
"symb": "PANW",
"name": "팔로 알토 네트웍스",
"last": "160.7500",
"sign": "5",
"diff": "1.0300",
"rate": "-0.64",
"tvol": "3570070",
"popen": "168.2200",
"phigh": "168.9900",
"plow": "159.7700",
"valx": "48603888",
"shar": "302357000",
"avol": "580983313",
"eps": "0.50",
"per": "324.62",
"rank": "2",
"ename": "PALO ALTO NETWORKS INC",
"e_ordyn": "○"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/해외주식/기본시세/258_v1_해외주식-034_해외주식-상품기본정보.md
+197
View File
@@ -0,0 +1,197 @@
# 해외주식 상품기본정보
- 원본 시트명: 해외주식 상품기본정보
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: v1_해외주식-034
- HTTP Method: GET
- 실전 TR_ID: CTPF1702R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/search-info
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 상품기본정보 API입니다.
시세제공기관(연합)에서 제공하는 해외주식 상품기본정보 데이터를 확인하실 수 있습니다.
※ 해당자료는 시세제공기관(연합)의 자료를 제공하고 있으며, 오류와 지연이 발생할 수 있습니다.
※ 위 정보에 의한 투자판단의 최종책임은 정보이용자에게 있으며, 당사와 시세제공기관(연합)는 어떠한 법적인 책임도 지지 않사오니 투자에 참고로만 이용하시기 바랍니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | CTPF1702R |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | 512 미국 나스닥 / 513 미국 뉴욕 / 529 미국 아멕스 <br>515 일본<br>501 홍콩 / 543 홍콩CNY / 558 홍콩USD<br>507 베트남 하노이 / 508 베트남 호치민<br>551 중국 상해A / 552 중국 심천A |
| PDNO | 상품번호 | string | Y | 12 | 예) AAPL (애플) |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세1 | object | Y | | |
| std_pdno | 표준상품번호 | string | Y | 12 | |
| prdt_eng_name | 상품영문명 | string | Y | 60 | |
| natn_cd | 국가코드 | string | Y | 3 | |
| natn_name | 국가명 | string | Y | 60 | |
| tr_mket_cd | 거래시장코드 | string | Y | 2 | |
| tr_mket_name | 거래시장명 | string | Y | 60 | |
| ovrs_excg_cd | 해외거래소코드 | string | Y | 4 | |
| ovrs_excg_name | 해외거래소명 | string | Y | 60 | |
| tr_crcy_cd | 거래통화코드 | string | Y | 3 | |
| ovrs_papr | 해외액면가 | string | Y | 195 | |
| crcy_name | 통화명 | string | Y | 60 | |
| ovrs_stck_dvsn_cd | 해외주식구분코드 | string | Y | 2 | 01.주식<br>02.WARRANT<br>03.ETF<br>04.우선주 |
| prdt_clsf_cd | 상품분류코드 | string | Y | 6 | |
| prdt_clsf_name | 상품분류명 | string | Y | 60 | |
| sll_unit_qty | 매도단위수량 | string | Y | 10 | |
| buy_unit_qty | 매수단위수량 | string | Y | 10 | |
| tr_unit_amt | 거래단위금액 | string | Y | 238 | |
| lstg_stck_num | 상장주식수 | string | Y | 19 | |
| lstg_dt | 상장일자 | string | Y | 8 | |
| ovrs_stck_tr_stop_dvsn_cd | 해외주식거래정지구분코드 | string | Y | 2 | ※ 해당 값 지연 반영될 수 있는 점 유의 부탁드립니다.<br><br>01.정상<br>02.거래정지(ALL)<br>03.거래중단<br>04.매도정지<br>05.거래정지(위탁)<br>06.매수정지 |
| lstg_abol_item_yn | 상장폐지종목여부 | string | Y | 1 | |
| ovrs_stck_prdt_grp_no | 해외주식상품그룹번호 | string | Y | 20 | |
| lstg_yn | 상장여부 | string | Y | 1 | |
| tax_levy_yn | 세금징수여부 | string | Y | 1 | |
| ovrs_stck_erlm_rosn_cd | 해외주식등록사유코드 | string | Y | 2 | |
| ovrs_stck_hist_rght_dvsn_cd | 해외주식이력권리구분코드 | string | Y | 2 | |
| chng_bf_pdno | 변경전상품번호 | string | Y | 12 | |
| prdt_type_cd_2 | 상품유형코드2 | string | Y | 3 | |
| ovrs_item_name | 해외종목명 | string | Y | 60 | |
| sedol_no | SEDOL번호 | string | Y | 15 | |
| blbg_tckr_text | 블름버그티커내용 | string | Y | 100 | |
| ovrs_stck_etf_risk_drtp_cd | 해외주식ETF위험지표코드 | string | Y | 3 | 001.ETF<br>002.ETN<br>003.ETC(Exchage Traded Commodity)<br>004.Others(REIT's, Mutual Fund)<br>005.VIX Underlying ETF<br>006.VIX Underlying ETN |
| etp_chas_erng_rt_dbnb | ETP추적수익율배수 | string | Y | 236 | |
| istt_usge_isin_cd | 기관용도ISIN코드 | string | Y | 12 | |
| mint_svc_yn | MINT서비스여부 | string | Y | 1 | |
| mint_svc_yn_chng_dt | MINT서비스여부변경일자 | string | Y | 8 | |
| prdt_name | 상품명 | string | Y | 60 | |
| lei_cd | LEI코드 | string | Y | 20 | |
| ovrs_stck_stop_rson_cd | 해외주식정지사유코드 | string | Y | 2 | 01.권리발생<br>02.ISIN상이<br>03.기타<br>04.급등락종목<br>05.상장폐지(예정)<br>06.종목코드,거래소변경<br>07.PTP종목 |
| lstg_abol_dt | 상장폐지일자 | string | Y | 8 | |
| mini_stk_tr_stat_dvsn_cd | 미니스탁거래상태구분코드 | string | Y | 2 | 01.정상<br>02.매매 불가<br>03.매수 불가<br>04.매도 불가 |
| mint_frst_svc_erlm_dt | MINT최초서비스등록일자 | string | Y | 8 | |
| mint_dcpt_trad_psbl_yn | MINT소수점매매가능여부 | string | Y | 1 | |
| mint_fnum_trad_psbl_yn | MINT정수매매가능여부 | string | Y | 1 | |
| mint_cblc_cvsn_ipsb_yn | MINT잔고전환불가여부 | string | Y | 1 | |
| ptp_item_yn | PTP종목여부 | string | Y | 1 | |
| ptp_item_trfx_exmt_yn | PTP종목양도세면제여부 | string | Y | 1 | |
| ptp_item_trfx_exmt_strt_dt | PTP종목양도세면제시작일자 | string | Y | 8 | |
| ptp_item_trfx_exmt_end_dt | PTP종목양도세면제종료일자 | string | Y | 8 | |
| dtm_tr_psbl_yn | 주간거래가능여부 | string | Y | 1 | |
| sdrf_stop_ecls_yn | 급등락정지제외여부 | string | Y | 1 | |
| sdrf_stop_ecls_erlm_dt | 급등락정지제외등록일자 | string | Y | 8 | |
| memo_text1 | 메모내용1 | string | Y | 500 | |
| ovrs_now_pric1 | 해외현재가격1 | string | Y | 23 | 23.5 |
| last_rcvg_dtime | 최종수신일시 | string | Y | 14 | |
## 예제
### Request Example (Python)
```text
{
"PDNO":"AAPL",
"PRDT_TYPE_CD":"512"
}
```
### Response Example
```text
{
"output": {
"std_pdno": "US0378331005",
"prdt_eng_name": "APPLE INC",
"natn_cd": "840",
"natn_name": "미국",
"tr_mket_cd": "01",
"tr_mket_name": "나스닥",
"ovrs_excg_cd": "NASD",
"ovrs_excg_name": "나스닥",
"tr_crcy_cd": "USD",
"ovrs_papr": "0.00000",
"crcy_name": "미국달러",
"ovrs_stck_dvsn_cd": "01",
"prdt_clsf_cd": "101210",
"prdt_clsf_name": "해외주식",
"sll_unit_qty": "1",
"buy_unit_qty": "1",
"tr_unit_amt": "0",
"lstg_stck_num": "15441900000",
"lstg_dt": "",
"ovrs_stck_tr_stop_dvsn_cd": "01",
"lstg_abol_item_yn": "N",
"ovrs_stck_prdt_grp_no": "4621",
"lstg_yn": "Y",
"tax_levy_yn": "N",
"ovrs_stck_erlm_rosn_cd": "00",
"ovrs_stck_hist_rght_dvsn_cd": "00",
"chng_bf_pdno": "",
"prdt_type_cd_2": "",
"ovrs_item_name": "",
"sedol_no": "2046251",
"blbg_tckr_text": "AAPL US",
"ovrs_stck_etf_risk_drtp_cd": "",
"etp_chas_erng_rt_dbnb": "0.000000",
"istt_usge_isin_cd": "US0378331005",
"mint_svc_yn": "Y",
"mint_svc_yn_chng_dt": "20220711",
"prdt_name": "애플",
"lei_cd": "HWUPKR0MPOU8FGXBT394",
"ovrs_stck_stop_rson_cd": "",
"lstg_abol_dt": "",
"mini_stk_tr_stat_dvsn_cd": "01",
"mint_frst_svc_erlm_dt": "20220711",
"mint_dcpt_trad_psbl_yn": "Y",
"mint_fnum_trad_psbl_yn": "Y",
"mint_cblc_cvsn_ipsb_yn": "N",
"ptp_item_yn": "N",
"ptp_item_trfx_exmt_yn": "N",
"ptp_item_trfx_exmt_strt_dt": "",
"ptp_item_trfx_exmt_end_dt": "",
"dtm_tr_psbl_yn": "Y",
"sdrf_stop_ecls_yn": "N",
"sdrf_stop_ecls_erlm_dt": "00000000"
},
"rt_cd": "0",
"msg_cd": "KIOK0530",
"msg1": "조회되었습니다 "
}
```
docs/broker/kis/rest/해외주식/기본시세/259_v1_해외주식-031_해외지수분봉조회.md
+1042
View File
File diff suppressed because it is too large Load Diff
docs/broker/kis/rest/해외주식/기본시세/260_v1_해외주식-030_해외주식분봉조회.md
+1267
View File
File diff suppressed because it is too large Load Diff
docs/broker/kis/rest/해외주식/기본시세/261_v1_해외주식-029_해외주식-현재가상세.md
+186
View File
@@ -0,0 +1,186 @@
# 해외주식 현재가상세
- 원본 시트명: 해외주식 현재가상세
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: v1_해외주식-029
- HTTP Method: GET
- 실전 TR_ID: HHDFS76200200
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/price-detail
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 현재가상세 API입니다.
해당 API를 활용하여 해외주식 종목의 매매단위(vnit), 호가단위(e_hogau), PER, PBR, EPS, BPS 등의 데이터를 확인하실 수 있습니다.
해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
홍콩, 베트남, 중국, 일본 - 15분지연
미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
[미국주식시세 이용시 유의사항]
■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
이용에 유의 부탁드립니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76200200 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | |
| EXCD | 거래소명 | string | Y | 4 | HKS : 홍콩<br>NYS : 뉴욕<br>NAS : 나스닥<br>AMS : 아멕스<br>TSE : 도쿄<br>SHS : 상해<br>SZS : 심천<br>SHI : 상해지수<br>SZI : 심천지수<br>HSX : 호치민<br>HNX : 하노이<br>BAY : 뉴욕(주간)<br>BAQ : 나스닥(주간)<br>BAA : 아멕스(주간) |
| SYMB | 종목코드 | string | Y | 16 | |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output | 응답상세 | object | Y | | |
| rsym | 실시간조회종목코드 | string | Y | 16 | |
| pvol | 전일거래량 | string | Y | 14 | |
| open | 시가 | string | Y | 12 | |
| high | 고가 | string | Y | 12 | |
| low | 저가 | string | Y | 12 | |
| last | 현재가 | string | Y | 12 | |
| base | 전일종가 | string | Y | 12 | |
| tomv | 시가총액 | string | Y | 16 | |
| pamt | 전일거래대금 | string | Y | 14 | |
| uplp | 상한가 | string | Y | 12 | |
| dnlp | 하한가 | string | Y | 12 | |
| h52p | 52주최고가 | string | Y | 12 | |
| h52d | 52주최고일자 | string | Y | 8 | |
| l52p | 52주최저가 | string | Y | 12 | |
| l52d | 52주최저일자 | string | Y | 8 | |
| perx | PER | string | Y | 10 | |
| pbrx | PBR | string | Y | 10 | |
| epsx | EPS | string | Y | 10 | |
| bpsx | BPS | string | Y | 10 | |
| shar | 상장주수 | string | Y | 16 | |
| mcap | 자본금 | string | Y | 16 | |
| curr | 통화 | string | Y | 4 | |
| zdiv | 소수점자리수 | string | Y | 1 | |
| vnit | 매매단위 | string | Y | 6 | |
| t_xprc | 원환산당일가격 | string | Y | 12 | |
| t_xdif | 원환산당일대비 | string | Y | 12 | |
| t_xrat | 원환산당일등락 | string | Y | 12 | |
| p_xprc | 원환산전일가격 | string | Y | 12 | |
| p_xdif | 원환산전일대비 | string | Y | 12 | |
| p_xrat | 원환산전일등락 | string | Y | 12 | |
| t_rate | 당일환율 | string | Y | 12 | |
| p_rate | 전일환율 | string | Y | 12 | |
| t_xsgn | 원환산당일기호 | string | Y | 1 | HTS 색상표시용 |
| p_xsng | 원환산전일기호 | string | Y | 1 | HTS 색상표시용 |
| e_ordyn | 거래가능여부 | string | Y | 20 | |
| e_hogau | 호가단위 | string | Y | 8 | |
| e_icod | 업종(섹터) | string | Y | 40 | |
| e_parp | 액면가 | string | Y | 12 | |
| tvol | 거래량 | string | Y | 14 | |
| tamt | 거래대금 | string | Y | 14 | |
| etyp_nm | ETP 분류명 | string | Y | 20 | |
## 예제
### Request Example (Python)
```text
{
"AUTH":"",
"EXCD":"NAS",
"SYMB":"TSLA"
}
```
### Response Example
```text
{
"output": {
"rsym": "DNASTSLA",
"zdiv": "4",
"curr": "USD",
"vnit": "1",
"open": "257.2600",
"high": "259.0794",
"low": "242.0100",
"last": "245.0100",
"base": "258.0800",
"pvol": "108861698",
"pamt": "28090405673",
"uplp": "0.0000",
"dnlp": "0.0000",
"h52p": "313.8000",
"h52d": "20220921",
"l52p": "101.8100",
"l52d": "20230106",
"perx": "69.51",
"pbrx": "15.21",
"epsx": "3.52",
"bpsx": "16.11",
"shar": "3173990000",
"mcap": "3000000",
"tomv": "777659289900",
"t_xprc": "323658",
"t_xdif": "17265",
"t_xrat": "-5.06",
"p_xprc": "0",
"p_xdif": "0",
"p_xrat": " 0.00",
"t_rate": "1321.00",
"p_rate": "",
"t_xsgn": "5",
"p_xsng": "3",
"e_ordyn": "매매 가능",
"e_hogau": "0.0100",
"e_icod": "자동차",
"e_parp": "0.0000",
"tvol": "132541640",
"tamt": "32907071789",
"etyp_nm": ""
},
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/해외주식/기본시세/262_해외주식-049_해외주식-업종별코드조회.md
+99
View File
@@ -0,0 +1,99 @@
# 해외주식 업종별코드조회
- 원본 시트명: 해외주식 업종별코드조회
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식-049
- HTTP Method: GET
- 실전 TR_ID: HHDFS76370100
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/industry-price
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 업종별코드조회 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76370100 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 <br>HKS : 홍콩, SHS : 상해 , SZS : 심천<br>HSX : 호치민, HNX : 하노이<br>TSE : 도쿄 ' |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object | Y | | |
| nrec | RecordCount | string | Y | 4 | |
| output2 | 응답상세 | object array | Y | | array |
| icod | 업종코드 | string | Y | 4 | |
| name | 업종명 | string | Y | 32 | |
## 예제
### Request Example (Python)
```text
AUTH:
EXCD:NAS
```
### Response Example
```text
{
"output1": {
"nrec": "42"
},
"output2": [
{
"icod": "000",
"name": "전체"
},
{
"icod": "010",
"name": "에너지 및 관련 서비스"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
docs/broker/kis/rest/해외주식/기본시세/263_v1_해외주식-012_해외주식-종목_지수_환율기간별시세일_주_월_년.md
+143
View File
@@ -0,0 +1,143 @@
# 해외주식 종목_지수_환율기간별시세(일_주_월_년)
- 원본 시트명: 해외주식 종목_지수_환율기간별시세(일_주_월_년)
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: v1_해외주식-012
- HTTP Method: GET
- 실전 TR_ID: FHKST03030100
- 모의 TR_ID: FHKST03030100
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: https://openapivts.koreainvestment.com:29443
- URL 명: /uapi/overseas-price/v1/quotations/inquire-daily-chartprice
- 모의투자 지원: 지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 종목/지수/환율기간별시세(일/주/월/년) API입니다.
해외지수 당일 시세의 경우 지연시세 or 종가시세가 제공됩니다.
※ 해당 API로 미국주식 조회 시, 다우30, 나스닥100, S&P500 종목만 조회 가능합니다.
더 많은 미국주식 종목 시세를 이용할 시에는, 해외주식기간별시세 API 사용 부탁드립니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | [실전투자/모의투자]<br>FHKST03030100 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | N | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | N: 해외지수, X 환율, I: 국채, S:금선물 |
| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목코드<br>※ 해외주식 마스터 코드 참조 <br>(포럼 > FAQ > 종목정보 다운로드(해외) > 해외지수)<br><br>※ 해당 API로 미국주식 조회 시, 다우30, 나스닥100, S&P500 종목만 조회 가능합니다. 더 많은 미국주식 종목 시세를 이용할 시에는, 해외주식기간별시세 API 사용 부탁드립니다. |
| FID_INPUT_DATE_1 | FID 입력 날짜1 | string | Y | 10 | 시작일자(YYYYMMDD) |
| FID_INPUT_DATE_2 | FID 입력 날짜2 | string | Y | 10 | 종료일자(YYYYMMDD) |
| FID_PERIOD_DIV_CODE | FID 기간 분류 코드 | string | Y | 32 | D:일, W:주, M:월, Y:년 |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세1 | object | N | | 기본정보 |
| ovrs_nmix_prdy_vrss | 전일 대비 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
| prdy_ctrt | 전일 대비율 | string | N | 11 | 11(8.2) 정수부분 8자리, 소수부분 2자리 |
| ovrs_nmix_prdy_clpr | 전일 종가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| acml_vol | 누적 거래량 | string | N | 18 | |
| hts_kor_isnm | HTS 한글 종목명 | string | N | 40 | |
| ovrs_nmix_prpr | 현재가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| stck_shrn_iscd | 단축 종목코드 | string | N | 9 | |
| prdy_vol | 전일 거래량 | string | N | 18 | |
| ovrs_prod_oprc | 시가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| ovrs_prod_hgpr | 최고가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| ovrs_prod_lwpr | 최저가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| output2 | 응답상세2 | object array | N | | 일자별 정보 |
| stck_bsop_date | 영업 일자 | string | N | 8 | |
| ovrs_nmix_prpr | 현재가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| ovrs_nmix_oprc | 시가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| ovrs_nmix_hgpr | 최고가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| ovrs_nmix_lwpr | 최저가 | string | N | 16 | 16(11.4) 정수부분 11자리, 소수부분 4자리 |
| acml_vol | 누적 거래량 | string | N | 18 | |
| mod_yn | 변경 여부 | string | N | 1 | |
## 예제
### Request Example (Python)
```text
"input": {
"fid_cond_mrkt_div_code": "N",
"fid_input_date_1": "20220401",
"fid_input_date_2": "20220613",
"fid_input_iscd": ".DJI",
"fid_period_div_code": "D"
}
```
### Response Example
```text
"output1": {
"acml_vol": "397268510",
"hts_kor_isnm": "다우존스 산업지수",
"ovrs_nmix_prdy_clpr": "31029.31",
"ovrs_nmix_prdy_vrss": "-253.88",
"ovrs_nmix_prpr": "30775.43",
"ovrs_prod_hgpr": "30979.85",
"ovrs_prod_lwpr": "30431.87",
"ovrs_prod_oprc": "30790.00",
"prdy_ctrt": "-0.82",
"prdy_vrss_sign": "5",
"stck_shrn_iscd": ".DJI"
},
"output2": [
{
"acml_vol": "480501460",
"mod_yn": "N",
"ovrs_nmix_hgpr": "31144.91",
"ovrs_nmix_lwpr": "30373.72",
"ovrs_nmix_oprc": "31144.91",
"ovrs_nmix_prpr": "30516.74",
"stck_bsop_date": "20220613"
},
....
{
"acml_vol": "346813590",
"mod_yn": "N",
"ovrs_nmix_hgpr": "34847.91",
"ovrs_nmix_lwpr": "34538.25",
"ovrs_nmix_oprc": "34740.89",
"ovrs_nmix_prpr": "34818.27",
"stck_bsop_date": "20220401"
}
```
docs/broker/kis/rest/해외주식/기본시세/264_해외주식-048_해외주식-업종별시세.md
+93
View File
@@ -0,0 +1,93 @@
# 해외주식 업종별시세
- 원본 시트명: 해외주식 업종별시세
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식-048
- HTTP Method: GET
- 실전 TR_ID: HHDFS76370000
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/industry-theme
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 업종별시세 API입니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76370000 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| KEYB | NEXT KEY BUFF | string | Y | 8 | 공백 |
| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
| EXCD | 거래소코드 | string | Y | 4 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스 <br>HKS : 홍콩, SHS : 상해 , SZS : 심천<br>HSX : 호치민, HNX : 하노이<br>TSE : 도쿄 ' |
| ICOD | 업종코드 | string | Y | 1 | 업종코드별조회(HHDFS76370100) 를 통해 확인 |
| VOL_RANG | 거래량조건 | string | Y | 1 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메시지 | string | Y | 80 | |
| output1 | 응답상세 | object | Y | | |
| zdiv | 소수점자리수 | string | Y | 1 | |
| stat | 거래상태정보 | string | Y | 20 | |
| crec | 현재조회종목수 | string | Y | 6 | |
| trec | 전체조회종목수 | string | Y | 6 | |
| nrec | RecordCount | string | Y | 4 | |
| output2 | 응답상세 | object array | Y | | array |
| rsym | 실시간조회심볼 | string | Y | 16 | |
| excd | 거래소코드 | string | Y | 4 | |
| symb | 종목코드 | string | Y | 1 | |
| name | 종목명 | string | Y | 48 | |
| last | 현재가 | string | Y | 16 | |
| sign | 기호 | string | Y | 1 | |
| diff | 대비 | string | Y | 12 | |
| rate | 등락율 | string | Y | 12 | |
| tvol | 거래량 | string | Y | 14 | |
| vask | 매도잔량 | string | Y | 10 | |
| pask | 매도호가 | string | Y | 12 | |
| pbid | 매수호가 | string | Y | 12 | |
| vbid | 매수잔량 | string | Y | 10 | |
| seqn | 순위 | string | Y | 6 | |
| ename | 영문종목명 | string | Y | 48 | |
| e_ordyn | 매매가능 | string | Y | 2 | |
## 메모
- Request Example (Python)
- Response Example
docs/broker/kis/rest/해외주식/기본시세/265_해외주식-033_해외주식-현재가-호가.md
+280
View File
@@ -0,0 +1,280 @@
# 해외주식 현재가 호가
- 원본 시트명: 해외주식 현재가 호가
- API 통신방식: REST
- 메뉴 위치: [해외주식] 기본시세
- API ID: 해외주식-033
- HTTP Method: GET
- 실전 TR_ID: HHDFS76200100
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/overseas-price/v1/quotations/inquire-asking-price
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
해외주식 현재가 호가 API입니다.
미국 거래소는 10호가, 그 외 국가 거래소는 1호가만 제공됩니다.
한국투자 HTS(eFriend Plus) &gt; [7620] 해외주식 현재가 화면에서 "왼쪽 호가 창" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
해외주식 시세는 무료시세(지연시세)만이 제공되며, API로는 유료시세(실시간시세)를 받아보실 수 없습니다.
※ 지연시세 지연시간 : 미국 - 실시간무료(0분 지연, 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보)
홍콩, 베트남, 중국, 일본 - 15분지연
미국의 경우 0분 지연 시세로 제공되나, 장중 당일 시가는 상이할 수 있으며, 익일 정정 표시됩니다.
[미국주식시세 이용시 유의사항]
■ 무료 실시간 시세(나스닥 토탈뷰)를 별도 신청없이 제공하고 있으며, 유료 시세 서비스를 신청하시더라도 OpenAPI의 경우 무료 시세로만 제공하고있습니다.
※ 무료(매수/매도 각 10호가) : 나스닥 마켓센터에서 거래되는 호가 및 호가 잔량 정보
※ 유료(매수/매도 각 1호가) : OpenAPI 서비스 미제공
■ 무료 실시간 시세 서비스는 유료 실시간 시세 서비스 대비 평균 50% 수준에 해당하는 정보이므로 현재가/호가/순간체결량/차트 등에서 일시적·부분적 차이가 있을 수 있습니다.
■ 무료 실시간 시세 서비스의 시가, 저가, 고가, 종가는 타 매체의 유료 실시간 시세 서비스와 다를 수 있으며, 이로 인해 발생하는 손실에 대해서 당사가 책임지지 않습니다.
이용에 유의 부탁드립니다.
## 레이아웃
### Request Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(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 | HHDFS76200100 |
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Request Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| AUTH | 사용자권한정보 | string | Y | 32 | 공백 |
| EXCD | 거래소코드 | string | Y | 4 | NYS : 뉴욕<br>NAS : 나스닥<br>AMS : 아멕스 <br>HKS : 홍콩<br>SHS : 상해 <br>SZS : 심천<br>HSX : 호치민<br>HNX : 하노이<br>TSE : 도쿄 <br>BAY : 뉴욕(주간)<br>BAQ : 나스닥(주간)<br>BAA : 아멕스(주간) |
| SYMB | 종목코드 | string | Y | 16 | 종목코드 예)TSLA |
### 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 | tr_cont를 이용한 다음조회 불가 API |
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
### Response Body
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
| msg_cd | 응답코드 | string | Y | 8 | |
| msg1 | 응답메세지 | string | Y | 80 | |
| output1 | 응답상세 | object | Y | 100 | |
| rsym | 실시간조회종목코드 | string | Y | 16 | |
| zdiv | 소수점자리수 | string | Y | 1 | |
| curr | 통화 | string | Y | 4 | |
| base | 전일종가 | string | Y | 12 | |
| open | 시가 | string | Y | 12 | |
| high | 고가 | string | Y | 12 | |
| low | 저가 | string | Y | 12 | |
| last | 현재가 | string | Y | 12 | |
| dymd | 호가일자 | string | Y | 8 | |
| dhms | 호가시간 | string | Y | 6 | |
| bvol | 매수호가총잔량 | string | Y | 10 | |
| avol | 매도호가총잔량 | string | Y | 10 | |
| bdvl | 매수호가총잔량대비 | string | Y | 10 | |
| advl | 매도호가총잔량대비 | string | Y | 10 | |
| code | 종목코드 | string | Y | 16 | |
| ropen | 시가율 | string | Y | 12 | |
| rhigh | 고가율 | string | Y | 12 | |
| rlow | 저가율 | string | Y | 12 | |
| rclose | 현재가율 | string | Y | 12 | |
| output2 | 응답상세 | array | Y | 100 | |
| pbid1 | 매수호가가격1 | string | Y | 12 | |
| pask1 | 매도호가가격1 | string | Y | 12 | |
| vbid1 | 매수호가잔량1 | string | Y | 10 | |
| vask1 | 매도호가잔량1 | string | Y | 10 | |
| dbid1 | 매수호가대비1 | string | Y | 10 | |
| dask1 | 매도호가대비1 | string | Y | 10 | |
| pbid2 | 매수호가가격2 | string | Y | 12 | 미국 거래소만 수신 |
| pask2 | 매도호가가격2 | string | Y | 12 | 미국 거래소만 수신 |
| vbid2 | 매수호가잔량2 | string | Y | 10 | 미국 거래소만 수신 |
| vask2 | 매도호가잔량2 | string | Y | 10 | 미국 거래소만 수신 |
| dbid2 | 매수호가대비2 | string | Y | 10 | 미국 거래소만 수신 |
| dask2 | 매도호가대비2 | string | Y | 10 | 미국 거래소만 수신 |
| pbid3 | 매수호가가격3 | string | Y | 12 | 미국 거래소만 수신 |
| pask3 | 매도호가가격3 | string | Y | 12 | 미국 거래소만 수신 |
| vbid3 | 매수호가잔량3 | string | Y | 10 | 미국 거래소만 수신 |
| vask3 | 매도호가잔량3 | string | Y | 10 | 미국 거래소만 수신 |
| dbid3 | 매수호가대비3 | string | Y | 10 | 미국 거래소만 수신 |
| dask3 | 매도호가대비3 | string | Y | 10 | 미국 거래소만 수신 |
| pbid4 | 매수호가가격4 | string | Y | 12 | 미국 거래소만 수신 |
| pask4 | 매도호가가격4 | string | Y | 12 | 미국 거래소만 수신 |
| vbid4 | 매수호가잔량4 | string | Y | 10 | 미국 거래소만 수신 |
| vask4 | 매도호가잔량4 | string | Y | 10 | 미국 거래소만 수신 |
| dbid4 | 매수호가대비4 | string | Y | 10 | 미국 거래소만 수신 |
| dask4 | 매도호가대비4 | string | Y | 10 | 미국 거래소만 수신 |
| pbid5 | 매수호가가격5 | string | Y | 12 | 미국 거래소만 수신 |
| pask5 | 매도호가가격5 | string | Y | 12 | 미국 거래소만 수신 |
| vbid5 | 매수호가잔량5 | string | Y | 10 | 미국 거래소만 수신 |
| vask5 | 매도호가잔량5 | string | Y | 10 | 미국 거래소만 수신 |
| dbid5 | 매수호가대비5 | string | Y | 10 | 미국 거래소만 수신 |
| dask5 | 매도호가대비5 | string | Y | 10 | 미국 거래소만 수신 |
| pbid6 | 매수호가가격6 | string | Y | 12 | 미국 거래소만 수신 |
| pask6 | 매도호가가격6 | string | Y | 12 | 미국 거래소만 수신 |
| vbid6 | 매수호가잔량6 | string | Y | 10 | 미국 거래소만 수신 |
| vask6 | 매도호가잔량6 | string | Y | 10 | 미국 거래소만 수신 |
| dbid6 | 매수호가대비6 | string | Y | 10 | 미국 거래소만 수신 |
| dask6 | 매도호가대비6 | string | Y | 10 | 미국 거래소만 수신 |
| pbid7 | 매수호가가격7 | string | Y | 12 | 미국 거래소만 수신 |
| pask7 | 매도호가가격7 | string | Y | 12 | 미국 거래소만 수신 |
| vbid7 | 매수호가잔량7 | string | Y | 10 | 미국 거래소만 수신 |
| vask7 | 매도호가잔량7 | string | Y | 10 | 미국 거래소만 수신 |
| dbid7 | 매수호가대비7 | string | Y | 10 | 미국 거래소만 수신 |
| dask7 | 매도호가대비7 | string | Y | 10 | 미국 거래소만 수신 |
| pbid8 | 매수호가가격8 | string | Y | 12 | 미국 거래소만 수신 |
| pask8 | 매도호가가격8 | string | Y | 12 | 미국 거래소만 수신 |
| vbid8 | 매수호가잔량8 | string | Y | 10 | 미국 거래소만 수신 |
| vask8 | 매도호가잔량8 | string | Y | 10 | 미국 거래소만 수신 |
| dbid8 | 매수호가대비8 | string | Y | 10 | 미국 거래소만 수신 |
| dask8 | 매도호가대비8 | string | Y | 10 | 미국 거래소만 수신 |
| pbid9 | 매수호가가격9 | string | Y | 12 | 미국 거래소만 수신 |
| pask9 | 매도호가가격9 | string | Y | 12 | 미국 거래소만 수신 |
| vbid9 | 매수호가잔량9 | string | Y | 10 | 미국 거래소만 수신 |
| vask9 | 매도호가잔량9 | string | Y | 10 | 미국 거래소만 수신 |
| dbid9 | 매수호가대비9 | string | Y | 10 | 미국 거래소만 수신 |
| dask9 | 매도호가대비9 | string | Y | 10 | 미국 거래소만 수신 |
| pbid10 | 매수호가가격10 | string | Y | 12 | 미국 거래소만 수신 |
| pask10 | 매도호가가격10 | string | Y | 12 | 미국 거래소만 수신 |
| vbid10 | 매수호가잔량10 | string | Y | 10 | 미국 거래소만 수신 |
| vask10 | 매도호가잔량10 | string | Y | 10 | 미국 거래소만 수신 |
| dbid10 | 매수호가대비10 | string | Y | 10 | 미국 거래소만 수신 |
| dask10 | 매도호가대비10 | string | Y | 10 | 미국 거래소만 수신 |
| output3 | 응답상세 | object array | Y | 100 | |
| vstm | VCMStart시간 | string | Y | 6 | 데이터 없음 |
| vetm | VCMEnd시간 | string | Y | 6 | 데이터 없음 |
| csbp | CAS/VCM기준가 | string | Y | 12 | 데이터 없음 |
| cshi | CAS/VCMHighprice | string | Y | 12 | 데이터 없음 |
| cslo | CAS/VCMLowprice | string | Y | 12 | 데이터 없음 |
| iep | IEP | string | Y | 12 | 데이터 없음 |
| iev | IEV | string | Y | 12 | 데이터 없음 |
## 예제
### Request Example (Python)
```text
AUTH:
EXCD:NAS
SYMB:TSLA
```
### Response Example
```text
{
"output1": {
"rsym": "DNASTSLA",
"zdiv": "4",
"curr": "USD",
"base": "149.9300",
"open": "148.9700",
"high": "150.9400",
"low": "146.2200",
"last": "147.0500",
"dymd": "20240420",
"dhms": "090000",
"bvol": "0",
"avol": "10759",
"bdvl": "-1053",
"advl": "-985",
"code": "TSLA",
"ropen": "-0.64",
"rhigh": "+0.67",
"rlow": "-2.47",
"rclose": "-1.92"
},
"output2": {
"pbid1": "0.0000",
"pask1": "147.0000",
"vbid1": "0",
"vask1": "9730",
"dbid1": "-275",
"dask1": "9720",
"pbid2": "0.0000",
"pask2": "147.0000",
"vbid2": "0",
"vask2": "11",
"dbid2": "-300",
"dask2": "-216",
"pbid3": "0.0000",
"pask3": "147.0000",
"vbid3": "0",
"vask3": "643",
"dbid3": "-5",
"dask3": "-28",
"pbid4": "0.0000",
"pask4": "147.0000",
"vbid4": "0",
"vask4": "299",
"dbid4": "-135",
"dask4": "289",
"pbid5": "0.0000",
"pask5": "147.0000",
"vbid5": "0",
"vask5": "43",
"dbid5": "-300",
"dask5": "-57",
"pbid6": "0.0000",
"pask6": "147.0000",
"vbid6": "0",
"vask6": "15",
"dbid6": "-30",
"dask6": "-9715",
"pbid7": "0.0000",
"pask7": "147.0000",
"vbid7": "0",
"vask7": "18",
"dbid7": "-2",
"dask7": "7",
"pbid8": "0.0000",
"pask8": "0.0000",
"vbid8": "0",
"vask8": "0",
"dbid8": "-3",
"dask8": "-643",
"pbid9": "0.0000",
"pask9": "0.0000",
"vbid9": "0",
"vask9": "0",
"dbid9": "-1",
"dask9": "-299",
"pbid10": "0.0000",
"pask10": "0.0000",
"vbid10": "0",
"vask10": "0",
"dbid10": "-2",
"dask10": "-43"
},
"output3": {
"vstm": "",
"vetm": "",
"csbp": "",
"cshi": "",
"cslo": "",
"iep": "",
"iev": ""
},
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```