해외속보(제목) [해외주식-055]
기본정보
-
MethodGET
-
실전 Domainhttps://openapi.koreainvestment.com:9443
-
모의 Domain미지원
-
URL/uapi/overseas-price/v1/quotations/brknews-title
-
Format
-
Content-Type
개요
해외속보(제목) API입니다.
한국투자 HTS(eFriend Plus) > [7704] 해외속보 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 100건까지 조회 가능합니다.
한국투자 HTS(eFriend Plus) > [7704] 해외속보 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 100건까지 조회 가능합니다.
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 | FHKST01011801 |
| 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| FID_NEWS_OFER_ENTP_CODE | 뉴스제공업체코드 | String | Y | 40 | 뉴스제공업체구분=>0:전체조회 |
| FID_COND_MRKT_CLS_CODE | 조건시장구분코드 | String | Y | 6 | 공백 |
| FID_INPUT_ISCD | 입력종목코드 | String | Y | 12 | 공백 |
| FID_TITL_CNTT | 제목내용 | String | Y | 132 | 공백 |
| FID_INPUT_DATE_1 | 입력날짜1 | String | Y | 10 | 공백 |
| FID_INPUT_HOUR_1 | 입력시간1 | String | Y | 10 | 공백 |
| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | String | Y | 2 | 공백 |
| FID_INPUT_SRNO | 입력일련번호 | String | Y | 20 | 공백 |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | 화면번호:11801 |
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 | |
| output | 응답상세 | Object Array | Y | array | |
| -cntt_usiq_srno | 내용조회용일련번호 | String | Y | 20 | |
| -news_ofer_entp_code | 뉴스제공업체코드 | String | Y | 1 | |
| -data_dt | 작성일자 | String | Y | 8 | |
| -data_tm | 작성시간 | String | Y | 6 | |
| -hts_pbnt_titl_cntt | HTS공시제목내용 | String | Y | 400 | |
| -news_lrdv_code | 뉴스대구분 | String | Y | 8 | |
| -dorg | 자료원 | String | Y | 20 | |
| -iscd1 | 종목코드1 | String | Y | 9 | |
| -iscd2 | 종목코드2 | String | Y | 9 | |
| -iscd3 | 종목코드3 | String | Y | 9 | |
| -iscd4 | 종목코드4 | String | Y | 9 | |
| -iscd5 | 종목코드5 | String | Y | 9 | |
| -iscd6 | 종목코드6 | String | Y | 9 | |
| -iscd7 | 종목코드7 | String | Y | 9 | |
| -iscd8 | 종목코드8 | String | Y | 9 | |
| -iscd9 | 종목코드9 | String | Y | 9 | |
| -iscd10 | 종목코드10 | String | Y | 9 | |
| -kor_isnm1 | 한글종목명1 | String | Y | 40 | |
| -kor_isnm2 | 한글종목명2 | String | Y | 40 | |
| -kor_isnm3 | 한글종목명3 | String | Y | 40 | |
| -kor_isnm4 | 한글종목명4 | String | Y | 40 | |
| -kor_isnm5 | 한글종목명5 | String | Y | 40 | |
| -kor_isnm6 | 한글종목명6 | String | Y | 40 | |
| -kor_isnm7 | 한글종목명7 | String | Y | 40 | |
| -kor_isnm8 | 한글종목명8 | String | Y | 40 | |
| -kor_isnm9 | 한글종목명9 | String | Y | 40 | |
| -kor_isnm10 | 한글종목명10 | String | Y | 40 |