KIS Developers menu

API 문서 HOME API 문서 [해외주식] 시세분석


[해외주식] 시세분석

해외주식 기간별권리조회 [해외주식-052]

REST

해외주식 기간별권리조회 [해외주식-052]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/overseas-price/v1/quotations/period-rights
  • Format
     
  • Content-Type
     

개요

해외주식 기간별권리조회 API입니다.
한국투자 HTS(eFriend Plus) > [7520] 기간별해외증권권리조회 화면을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

※ 확정여부가 '예정'으로 표시되는 경우는 권리정보가 변경될 수 있으니 참고자료로만 활용하시기 바랍니다.

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 CTRGT011R
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
RGHT_TYPE_CD 권리유형코드 String Y 2 '%%(전체), 01(유상), 02(무상), 03(배당), 11(합병),
14(액면분할), 15(액면병합), 17(감자), 54(WR청구),
61(원리금상환), 71(WR소멸), 74(배당옵션), 75(특별배당), 76(ISINCODE변경), 77(실권주청약)'
INQR_DVSN_CD 조회구분코드 String Y 2 02(현지기준일), 03(청약시작일), 04(청약종료일)
INQR_STRT_DT 조회시작일자 String Y 8 일자 ~
INQR_END_DT 조회종료일자 String Y 8 ~ 일자
PDNO 상품번호 String Y 12 공백
PRDT_TYPE_CD 상품유형코드 String Y 3 공백
CTX_AREA_NK50 연속조회키50 String Y 50 공백
CTX_AREA_FK50 연속조회검색조건50 String Y 50 공백

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 응답상세 Object Array Y array
-bass_dt 기준일자 String Y 8
-rght_type_cd 권리유형코드 String Y 2
-pdno 상품번호 String Y 12
-prdt_name 상품명 String Y 60
-prdt_type_cd 상품유형코드 String Y 3
-std_pdno 표준상품번호 String Y 12
-acpl_bass_dt 현지기준일자 String Y 8
-sbsc_strt_dt 청약시작일자 String Y 8
-sbsc_end_dt 청약종료일자 String Y 8
-cash_alct_rt 현금배정비율 String Y 191
-stck_alct_rt 주식배정비율 String Y 2012
-crcy_cd 통화코드 String Y 3
-crcy_cd2 통화코드2 String Y 3
-crcy_cd3 통화코드3 String Y 3
-crcy_cd4 통화코드4 String Y 3
-alct_frcr_unpr 배정외화단가 String Y 195
-stkp_dvdn_frcr_amt2 주당배당외화금액2 String Y 195
-stkp_dvdn_frcr_amt3 주당배당외화금액3 String Y 195
-stkp_dvdn_frcr_amt4 주당배당외화금액4 String Y 195
-dfnt_yn 확정여부 String Y 1

Example

Request

RGHT_TYPE_CD:%%
INQR_DVSN_CD:02
INQR_STRT_DT:20240417
INQR_END_DT:20240417
PDNO:
PRDT_TYPE_CD:
CTX_AREA_NK50:
CTX_AREA_FK50:

Response

{
    "ctx_area_nk50": "                                                  ",
    "ctx_area_fk50": "%%!^02!^20240417!^20240417!^!^                    ",
    "output": [
        {
            "bass_dt": "20240418",
            "rght_type_cd": "03",
            "pdno": "000661",
            "prdt_name": "[000661]CHANGCHUN HIGH-TECH INDUSTRY (GROUP",
            "prdt_type_cd": "552",
            "std_pdno": "CNE0000007J8",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "450.0000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "CNY",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "4.50000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "03",
            "pdno": "AIR",
            "prdt_name": "AIRBUS GROUP NV",
            "prdt_type_cd": "542",
            "std_pdno": "NL0000235190",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "180.0000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "EUR",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "1.80000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "03",
            "pdno": "GYLD",
            "prdt_name": "ARROW ETF TR ARROW DOW JONES GLOBAL YIELD ETF",
            "prdt_type_cd": "513",
            "std_pdno": "US04273H1041",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "12.6000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "USD",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.12600",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "03",
            "pdno": "NORAM",
            "prdt_name": "NORAM DRILLING",
            "prdt_type_cd": "525",
            "std_pdno": "NO0010360019",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "43.8000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "NOK",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.43800",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "15",
            "pdno": "BENF",
            "prdt_name": "BENEFICIENT",
            "prdt_type_cd": "512",
            "std_pdno": "US08178Q3092",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "0.0000000000",
            "stck_alct_rt": "1.250000000000",
            "crcy_cd": "USD",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.00000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "15",
            "pdno": "NCNA",
            "prdt_name": "NUCANA PLC SPON ADR EACH REP 25 ORD SHS(POST SPLIT)",
            "prdt_type_cd": "512",
            "std_pdno": "US67022C2052",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "0.0000000000",
            "stck_alct_rt": "4.000000000000",
            "crcy_cd": "USD",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.00000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240415",
            "rght_type_cd": "54",
            "pdno": "WWRSF",
            "prdt_name": "RIVERNORTH CAPITAL AND INCM FD INC",
            "prdt_type_cd": "513",
            "std_pdno": "USX589013472",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "20240415",
            "sbsc_end_dt": "20240417",
            "cash_alct_rt": "0.0000000000",
            "stck_alct_rt": "33.333340000000",
            "crcy_cd": "USD",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "15.28000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240411",
            "rght_type_cd": "74",
            "pdno": "FTF",
            "prdt_name": "FRANKLIN LIMITED DURATION INCOME TR",
            "prdt_type_cd": "529",
            "std_pdno": "US35472T1016",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "20240411",
            "sbsc_end_dt": "20240416",
            "cash_alct_rt": "0.0000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "USD",
            "crcy_cd2": "USD",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.00000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240411",
            "rght_type_cd": "74",
            "pdno": "TEI",
            "prdt_name": "TEMPLETON EMERGING MARKETS INC FD",
            "prdt_type_cd": "513",
            "std_pdno": "US8801921094",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "20240411",
            "sbsc_end_dt": "20240416",
            "cash_alct_rt": "0.0000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "USD",
            "crcy_cd2": "USD",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "0.00000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        },
        {
            "bass_dt": "20240418",
            "rght_type_cd": "75",
            "pdno": "AIR",
            "prdt_name": "AIRBUS GROUP NV",
            "prdt_type_cd": "542",
            "std_pdno": "NL0000235190",
            "acpl_bass_dt": "20240417",
            "sbsc_strt_dt": "",
            "sbsc_end_dt": "",
            "cash_alct_rt": "100.0000000000",
            "stck_alct_rt": "0.000000000000",
            "crcy_cd": "EUR",
            "crcy_cd2": "",
            "crcy_cd3": "",
            "crcy_cd4": "",
            "alct_frcr_unpr": "1.00000",
            "stkp_dvdn_frcr_amt2": "0.00000",
            "stkp_dvdn_frcr_amt3": "0.00000",
            "stkp_dvdn_frcr_amt4": "0.00000",
            "dfnt_yn": "Y"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "KIOK0460",
    "msg1": "조회 되었습니다. (마지막 자료)                                                  "
}

해외뉴스종합(제목) [해외주식-053]

REST

해외뉴스종합(제목) [해외주식-053]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/overseas-price/v1/quotations/news-title
  • Format
     
  • Content-Type
     

개요

해외뉴스종합(제목) API입니다.
한국투자 HTS(eFriend Plus) > [7702] 해외뉴스종합 화면의 "우측 상단 뉴스목록" 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

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 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 한글명 Type Required Length Description
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 한글명 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
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

Example

Request

INFO_GB:
CLASS_CD:
NATION_CD:
EXCHANGE_CD:
SYMB:
DATA_DT:
DATA_TM:
CTS:

Response

{
    "outblock1": [
        {
            "info_gb": "t",
            "news_key": "ICH709214",
            "data_dt": "20240503",
            "data_tm": "145447",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "",
            "symb": "",
            "symb_name": "",
            "title": "톰 리 “단기 내 금리인하 가능”"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709213",
            "data_dt": "20240503",
            "data_tm": "144451",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "",
            "symb": "",
            "symb_name": "",
            "title": "美 연준, 7월 금리인하 예상 GS 외"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709212",
            "data_dt": "20240503",
            "data_tm": "144313",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "NAS",
            "symb": "NFLX",
            "symb_name": "넷플릭스",
            "title": "넷플릭스, 광고 전망 낙관 제프리스"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709215",
            "data_dt": "20240503",
            "data_tm": "143706",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "",
            "symb": "",
            "symb_name": "",
            "title": "美 4월 비농업부문 고용자 수 +24.0만 명 추정 아데코"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709208",
            "data_dt": "20240503",
            "data_tm": "142518",
            "class_cd": "03",
            "class_name": "전략/산업",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "",
            "symb": "",
            "symb_name": "",
            "title": "美 모기지 금리, 5주 연속 상승"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709207",
            "data_dt": "20240503",
            "data_tm": "141851",
            "class_cd": "02",
            "class_name": "정책",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "",
            "symb": "",
            "symb_name": "",
            "title": "금리, 현재 정점에 있을 확률 높아 펀드스트랫"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709206",
            "data_dt": "20240503",
            "data_tm": "140506",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "NYS",
            "symb": "FSLY",
            "symb_name": "패스틀리",
            "title": "패스틀리, 단기 악재 직면 - BofA"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709205",
            "data_dt": "20240503",
            "data_tm": "135416",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "NYS",
            "symb": "TJX",
            "symb_name": "TJX",
            "title": "TJX, 기존 소매점 위협 중 - UBS"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709204",
            "data_dt": "20240503",
            "data_tm": "134647",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "NAS",
            "symb": "TTD",
            "symb_name": "트레이드 데스크",
            "title": "트레이드 데스크, 광고시장 현대화로 수혜 가능 - 제프리스"
        },
        {
            "info_gb": "t",
            "news_key": "ICH709203",
            "data_dt": "20240503",
            "data_tm": "133734",
            "class_cd": "05",
            "class_name": "종목리포트",
            "source": "연합미국",
            "nation_cd": "US",
            "exchange_cd": "NYS",
            "symb": "MGM",
            "symb_name": "MGM 리조츠 인터내셔널",
            "title": "MGM 리조트, 매출 증가세 가속 중 - 서스퀘하나"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

해외주식 권리종합 [해외주식-050]

REST

해외주식 권리종합 [해외주식-050]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/overseas-price/v1/quotations/rights-by-ice
  • Format
     
  • Content-Type
     

개요

해외주식 권리종합 API입니다.
한국투자 HTS(eFriend Plus) > [7833] 해외주식 권리(ICE제공) 화면의 "전체" 탭 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

※ 조회기간 기준일 입력시 참고 - 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일

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 HHDFS78330900
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
NCOD 국가코드 String Y 2 CN:중국 HK:홍콩 US:미국 JP:일본 VN:베트남
SYMB 심볼 String Y 20 종목코드
ST_YMD 일자 시작일 String Y 8 미입력 시, 오늘-3개월
기간지정 시, 종료일 입력(ex. 20240514)

※ 조회기간 기준일 입력시 참고
- 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일
ED_YMD 일자 종료일 String Y 8 미입력 시, 오늘+3개월
기간지정 시, 종료일 입력(ex. 20240514)

※ 조회기간 기준일 입력시 참고
- 상환: 상환일자, 조기상환: 조기상환일자, 티커변경: 적용일, 그 외: 발표일

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
-anno_dt ICE공시일 String Y 8
-ca_title 권리유형 String Y 12
-div_lock_dt 배당락일 String Y 8
-pay_dt 지급일 String Y 8
-record_dt 기준일 String Y 8
-validity_dt 효력일자 String Y 8
-local_end_dt 현지지시마감일 String Y 8
-lock_dt 권리락일 String Y 8
-delist_dt 상장폐지일 String Y 8
-redempt_dt 상환일자 String Y 8
-early_redempt_dt 조기상환일자 String Y 8
-effective_dt 적용일 String Y 8

Example

Request

NCOD:US
SYMB:MAIN
ST_YMD:20240214
ED_YMD:20240514

Response

{
    "output1": [
        {
            "anno_dt": "20240221",
            "ca_title": "현금배당",
            "div_lock_dt": "20240607",
            "pay_dt": "20240614",
            "record_dt": "20240607",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        },
        {
            "anno_dt": "20240221",
            "ca_title": "현금배당",
            "div_lock_dt": "20240405",
            "pay_dt": "20240415",
            "record_dt": "20240408",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        },
        {
            "anno_dt": "20240221",
            "ca_title": "현금배당",
            "div_lock_dt": "20240507",
            "pay_dt": "20240515",
            "record_dt": "20240508",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        },
        {
            "anno_dt": "20240507",
            "ca_title": "현금배당",
            "div_lock_dt": "20240808",
            "pay_dt": "20240815",
            "record_dt": "20240808",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        },
        {
            "anno_dt": "20240507",
            "ca_title": "현금배당",
            "div_lock_dt": "20240708",
            "pay_dt": "20240715",
            "record_dt": "20240708",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        },
        {
            "anno_dt": "20240507",
            "ca_title": "현금배당",
            "div_lock_dt": "20240906",
            "pay_dt": "20240913",
            "record_dt": "20240906",
            "validity_dt": "",
            "local_end_dt": "",
            "lock_dt": "",
            "delist_dt": "",
            "redempt_dt": "",
            "early_redempt_dt": "",
            "effective_dt": ""
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

당사 해외주식담보대출 가능 종목 [해외주식-051]

REST

당사 해외주식담보대출 가능 종목 [해외주식-051]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/overseas-price/v1/quotations/colable-by-company
  • Format
     
  • Content-Type
     

개요

당사 해외주식담보대출 가능 종목 API입니다.
한국투자 HTS(eFriend Plus) > [0497] 당사 해외주식담보대출 가능 종목 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

한 번의 호출에 20건까지 조회가 가능하며 다음조회가 불가하기에, PDNO에 데이터 확인하고자 하는 종목코드를 입력하여 단건조회용으로 사용하시기 바랍니다.

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 CTLN4050R
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
PDNO 상품번호 String Y 12 ex)AMD
PRDT_TYPE_CD 상품유형코드 String Y 3 공백
INQR_STRT_DT 조회시작일자 String Y 8 공백
INQR_END_DT 조회종료일자 String Y 8 공백
INQR_DVSN 조회구분 String Y 2 공백
NATN_CD 국가코드 String Y 3 840(미국), 344(홍콩), 156(중국)
INQR_SQN_DVSN 조회순서구분 String Y 2 01(이름순), 02(코드순)
RT_DVSN_CD 비율구분코드 String Y 2 공백
RT 비율 String Y 238 공백
LOAN_PSBL_YN 대출가능여부 String Y 1 공백
CTX_AREA_FK100 연속조회검색조건100 String Y 100 공백
CTX_AREA_NK100 연속조회키100 String Y 100 공백

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 Y
-pdno 상품번호 String Y 12
-ovrs_item_name 해외종목명 String Y 60
-loan_rt 대출비율 String Y 238
-mgge_mntn_rt 담보유지비율 String Y 238
-mgge_ensu_rt 담보확보비율 String Y 238
-loan_exec_psbl_yn 대출실행가능여부 String Y 1
-stff_name 직원명 String Y 60
-erlm_dt 등록일자 String Y 8
-tr_mket_name 거래시장명 String Y 60
-crcy_cd 통화코드 String Y 3
-natn_kor_name 국가한글명 String Y 60
-ovrs_excg_cd 해외거래소코드 String Y 4
output2 응답상세 Object Array Y array
-loan_psbl_item_num 대출가능종목수 String Y 20

Example

Request

PDNO:AMD
PRDT_TYPE_CD:
INQR_STRT_DT:
INQR_END_DT:
INQR_DVSN:
NATN_CD:840
INQR_SQN_DVSN:02
RT_DVSN_CD:
RT:
LOAN_PSBL_YN:
CTX_AREA_FK100:
CTX_AREA_NK100:

Response

{
    "ctx_area_fk100": "AMD!^!^!^!^!^840!^02                                                                                ",
    "ctx_area_nk100": "                                                                                                    ",
    "output1": [
        {
            "pdno": "AMD",
            "ovrs_item_name": "AMD",
            "loan_rt": "50.00000000",
            "mgge_mntn_rt": "170.00000000",
            "mgge_ensu_rt": "170.00000000",
            "loan_exec_psbl_yn": "Y",
            "stff_name": "109477.석재민",
            "erlm_dt": "20221230",
            "tr_mket_name": "나스닥",
            "crcy_cd": "USD",
            "natn_kor_name": "미국",
            "ovrs_excg_cd": "NASD"
        }
    ],
    "output2": {
        "loan_psbl_item_num": "403"
    },
    "rt_cd": "0",
    "msg_cd": "KIOK0460",
    "msg1": "조회 되었습니다. (마지막 자료)                                                  "
}

해외속보(제목) [해외주식-055]

REST

해외속보(제목) [해외주식-055]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/overseas-price/v1/quotations/brknews-title
  • Format
     
  • Content-Type
     

개요

해외속보(제목) API입니다.
한국투자 HTS(eFriend Plus) > [7704] 해외속보 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

최대 100건까지 조회 가능합니다.

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 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 한글명 Type Required Length Description
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 한글명 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 응답상세 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

Example

Request

FID_NEWS_OFER_ENTP_CODE:0
FID_COND_MRKT_CLS_CODE:00
FID_INPUT_ISCD:
FID_TITL_CNTT:
FID_INPUT_DATE_1:
FID_INPUT_HOUR_1:
FID_RANK_SORT_CLS_CODE:
FID_INPUT_SRNO:
FID_COND_SCR_DIV_CODE:11801

Response

{
    "output": [
        {
            "cntt_usiq_srno": "2024052817340622954",
            "news_ofer_entp_code": "U",
            "data_dt": "20240528",
            "data_tm": "173406",
            "hts_pbnt_titl_cntt": "“시진핑, 기업인들 만나 신에너지 분야 과잉투자 경고”",
            "news_lrdv_code": "38",
            "dorg": "서울경제",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },
        {
            "cntt_usiq_srno": "2024052817332725534",
            "news_ofer_entp_code": "6",
            "data_dt": "20240528",
            "data_tm": "173327",
            "hts_pbnt_titl_cntt": "군부대 찾은 라이칭더, 中포위훈련 언급하며 \"모두 잘 대응\"",
            "news_lrdv_code": "11",
            "dorg": "연합뉴스",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },
        {
            "cntt_usiq_srno": "2024052817332721133",
            "news_ofer_entp_code": "6",
            "data_dt": "20240528",
            "data_tm": "173327",
            "hts_pbnt_titl_cntt": "적십자 \"기후변화로 '극단적 더위' 일수 1년 새 26일 증가\"",
            "news_lrdv_code": "11",
            "dorg": "연합뉴스",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },
        {
            "cntt_usiq_srno": "2024052817312094823",
            "news_ofer_entp_code": "6",
            "data_dt": "20240528",
            "data_tm": "173120",
            "hts_pbnt_titl_cntt": "미국제재 우려했나…중국 하이크비전, 러시아 사업 중단설",
            "news_lrdv_code": "11",
            "dorg": "연합뉴스",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },
        {
            "cntt_usiq_srno": "2024052817304250020",
            "news_ofer_entp_code": "8",
            "data_dt": "20240528",
            "data_tm": "173042",
            "hts_pbnt_titl_cntt": "[유럽개장]장 초반 혼조세…獨 0.25%↑",
            "news_lrdv_code": "10",
            "dorg": "아시아 경제",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },
        {
            "cntt_usiq_srno": "2024052817264510344",
            "news_ofer_entp_code": "A",
            "data_dt": "20240528",
            "data_tm": "172645",
            "hts_pbnt_titl_cntt": "122m 협곡 아래로 떨어졌는데 멀쩡하디니…기적 일어난 美 10대",
            "news_lrdv_code": "10",
            "dorg": "매일경제",
            "iscd1": "",
            "iscd2": "",
            "iscd3": "",
            "iscd4": "",
            "iscd5": "",
            "iscd6": "",
            "iscd7": "",
            "iscd8": "",
            "iscd9": "",
            "iscd10": "",
            "kor_isnm1": " ",
            "kor_isnm2": "",
            "kor_isnm3": "",
            "kor_isnm4": "",
            "kor_isnm5": "",
            "kor_isnm6": "",
            "kor_isnm7": "",
            "kor_isnm8": "",
            "kor_isnm9": "",
            "kor_isnm10": ""
        },...
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}