해외뉴스종합(제목) [해외주식-053]
기본정보
-
MethodGET
-
실전 Domainhttps://openapi.koreainvestment.com:9443
-
모의 Domain미지원
-
URL/uapi/overseas-price/v1/quotations/news-title
-
Format
-
Content-Type
개요
해외뉴스종합(제목) API입니다.
한국투자 HTS(eFriend Plus) > [7702] 해외뉴스종합 화면의 "우측 상단 뉴스목록" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [7702] 해외뉴스종합 화면의 "우측 상단 뉴스목록" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
Element한글명TypeRequiredLengthDescription
| 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 | HHPSTH60100C1 |
| 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한글명TypeRequiredLengthDescription
| INFO_GB | 뉴스구분 | String | Y | 1 | 전체: 공백 |
| CLASS_CD | 중분류 | String | Y | 2 | 전체: 공백 |
| NATION_CD | 국가코드 | String | Y | 2 | 전체: 공백 CN(중국), HK(홍콩), US(미국) |
| EXCHANGE_CD | 거래소코드 | String | Y | 3 | 전체: 공백 |
| SYMB | 종목코드 | String | Y | 20 | 전체: 공백 |
| DATA_DT | 조회일자 | String | Y | 8 | 전체: 공백 특정일자(YYYYMMDD) ex. 20240502 |
| DATA_TM | 조회시간 | String | Y | 6 | 전체: 공백 전체: 공백 특정시간(HHMMSS) ex. 093500 |
| CTS | 다음키 | String | Y | 35 | 공백 입력 |
Response
Header
Element한글명TypeRequiredLengthDescription| 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한글명TypeRequiredLengthDescription| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| outblock1 | 응답상세 | Object Array | Y | array | |
| -info_gb | 뉴스구분 | String | Y | 1 | |
| -news_key | 뉴스키 | String | Y | 20 | |
| -data_dt | 조회일자 | String | Y | 8 | |
| -data_tm | 조회시간 | String | Y | 6 | |
| -class_cd | 중분류 | String | Y | 2 | |
| -class_name | 중분류명 | String | Y | 20 | |
| -source | 자료원 | String | Y | 20 | |
| -nation_cd | 국가코드 | String | Y | 2 | |
| -exchange_cd | 거래소코드 | String | Y | 3 | |
| -symb | 종목코드 | String | Y | 20 | |
| -symb_name | 종목명 | String | Y | 48 | |
| -title | 제목 | String | Y | 128 |