feat: add messaging transport rollout

This commit is contained in:
2026-06-06 00:02:52 +09:00
parent 4b91343ee8
commit 6c7a1cf6f6
383 changed files with 99045 additions and 487 deletions
@@ -0,0 +1,126 @@
# 상품기본조회
- 원본 시트명: 상품기본조회
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-029
- HTTP Method: GET
- 실전 TR_ID: CTPF1604R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/search-info
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
개요 없음
## 레이아웃
### 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 | CTPF1604R |
| 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 |
| --- | --- | --- | --- | --- | --- |
| PDNO | 상품번호 | string | Y | 12 | '주식(하이닉스) : 000660 (코드 : 300)<br>선물(101S12) : KR4101SC0009 (코드 : 301)<br>미국(AAPL) : AAPL (코드 : 512)' |
| PRDT_TYPE_CD | 상품유형코드 | string | Y | 3 | '300 주식<br>301 선물옵션<br>302 채권<br>512 미국 나스닥 / 513 미국 뉴욕 / 529 미국 아멕스 <br>515 일본<br>501 홍콩 / 543 홍콩CNY / 558 홍콩USD<br>507 베트남 하노이 / 508 베트남 호치민<br>551 중국 상해A / 552 중국 심천A' |
### 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 | | |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_type_cd | 상품유형코드 | string | Y | 3 | |
| prdt_name | 상품명 | string | Y | 60 | |
| prdt_name120 | 상품명120 | string | Y | 120 | |
| prdt_abrv_name | 상품약어명 | string | Y | 60 | |
| prdt_eng_name | 상품영문명 | string | Y | 60 | |
| prdt_eng_name120 | 상품영문명120 | string | Y | 120 | |
| prdt_eng_abrv_name | 상품영문약어명 | string | Y | 60 | |
| std_pdno | 표준상품번호 | string | Y | 12 | |
| shtn_pdno | 단축상품번호 | string | Y | 12 | |
| prdt_sale_stat_cd | 상품판매상태코드 | string | Y | 2 | |
| prdt_risk_grad_cd | 상품위험등급코드 | string | Y | 2 | |
| prdt_clsf_cd | 상품분류코드 | string | Y | 6 | |
| prdt_clsf_name | 상품분류명 | string | Y | 60 | |
| sale_strt_dt | 판매시작일자 | string | Y | 8 | |
| sale_end_dt | 판매종료일자 | string | Y | 8 | |
| wrap_asst_type_cd | 랩어카운트자산유형코드 | string | Y | 2 | |
| ivst_prdt_type_cd | 투자상품유형코드 | string | Y | 4 | |
| ivst_prdt_type_cd_name | 투자상품유형코드명 | string | Y | 60 | |
| frst_erlm_dt | 최초등록일자 | string | Y | 8 | |
## 예제
### Request Example (Python)
```text
{
"PDNO":"AAPL",
"PRDT_TYPE_CD":"512"
}
```
### Response Example
```text
{
"output": {
"pdno": "AAPL",
"prdt_type_cd": "512",
"prdt_name": "애플",
"prdt_name120": "애플",
"prdt_abrv_name": "애플",
"prdt_eng_name": "APPLE INC",
"prdt_eng_name120": "APPLE INC",
"prdt_eng_abrv_name": "APPLE INC",
"std_pdno": "US0378331005",
"shtn_pdno": "AAPL",
"prdt_sale_stat_cd": "",
"prdt_risk_grad_cd": "",
"prdt_clsf_cd": "101210",
"prdt_clsf_name": "해외주식",
"sale_strt_dt": "",
"sale_end_dt": "",
"wrap_asst_type_cd": "06",
"ivst_prdt_type_cd": "1012",
"ivst_prdt_type_cd_name": "해외주식",
"frst_erlm_dt": ""
},
"rt_cd": "0",
"msg_cd": "KIOK0530",
"msg1": "조회되었습니다 "
}
```
@@ -0,0 +1,978 @@
# 예탁원정보(공모주청약일정)
- 원본 시트명: 예탁원정보(공모주청약일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-151
- HTTP Method: GET
- 실전 TR_ID: HHKDB669108C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/pub-offer
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(공모주청약일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0667] 공모주청약 화면의 기능을 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 | HHKDB669108C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
| CTS | CTS | string | Y | 17 | 공백 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 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 | 응답상세 | object array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| fix_subscr_pri | 공모가 | string | Y | 12 | |
| face_value | 액면가 | string | Y | 9 | |
| subscr_dt | 청약기간 | string | Y | 23 | |
| pay_dt | 납입일 | string | Y | 10 | |
| refund_dt | 환불일 | string | Y | 10 | |
| list_dt | 상장/등록일 | string | Y | 10 | |
| lead_mgr | 주간사 | string | Y | 41 | |
| pub_bf_cap | 공모전자본금 | string | Y | 12 | |
| pub_af_cap | 공모후자본금 | string | Y | 12 | |
| assign_stk_qty | 당사배정물량 | string | Y | 12 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240325",
"sht_cd": "461030",
"isin_name": "아이엠비디엑스",
"fix_subscr_pri": " 13000",
"face_value": "000000100",
"subscr_dt": "2024/03/25 ~ 2024/03/26",
"pay_dt": "2024/03/28",
"refund_dt": "2024/03/28",
"list_dt": "",
"lead_mgr": "미래에셋증권",
"pub_bf_cap": " 1141762",
"pub_af_cap": " 62500",
"assign_stk_qty": " 0"
},
{
"record_date": "20240318",
"sht_cd": "475240",
"isin_name": "하나32호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/03/18 ~ 2024/03/19",
"pay_dt": "2024/03/21",
"refund_dt": "2024/03/21",
"list_dt": "2024/03/27",
"lead_mgr": "하나증권",
"pub_bf_cap": " 20000",
"pub_af_cap": " 75000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240314",
"sht_cd": "455900",
"isin_name": "엔젤로보틱스",
"fix_subscr_pri": " 20000",
"face_value": "000000500",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"pay_dt": "2024/03/19",
"refund_dt": "2024/03/19",
"list_dt": "2024/03/26",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 6648690",
"pub_af_cap": " 240000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240312",
"sht_cd": "437730",
"isin_name": "삼현",
"fix_subscr_pri": " 30000",
"face_value": "000000500",
"subscr_dt": "2024/03/12 ~ 2024/03/13",
"pay_dt": "2024/03/15",
"refund_dt": "2024/03/15",
"list_dt": "2024/03/21",
"lead_mgr": "한국투자증권",
"pub_bf_cap": " 4267928",
"pub_af_cap": " 250000",
"assign_stk_qty": " 500000"
},
{
"record_date": "20240304",
"sht_cd": "036220",
"isin_name": "오상헬스케어",
"fix_subscr_pri": " 20000",
"face_value": "000000500",
"subscr_dt": "2024/03/04 ~ 2024/03/05",
"pay_dt": "2024/03/07",
"refund_dt": "2024/03/07",
"list_dt": "",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 6542358",
"pub_af_cap": " 123750",
"assign_stk_qty": " 0"
},
{
"record_date": "20240226",
"sht_cd": "199430",
"isin_name": "케이엔알시스템",
"fix_subscr_pri": " 13500",
"face_value": "000000100",
"subscr_dt": "2024/02/26 ~ 2024/02/27",
"pay_dt": "2024/02/29",
"refund_dt": "2024/02/29",
"list_dt": "2024/03/07",
"lead_mgr": "DB금융투자",
"pub_bf_cap": " 870059",
"pub_af_cap": " 52600",
"assign_stk_qty": " 0"
},
{
"record_date": "20240222",
"sht_cd": "469900",
"isin_name": "하나31호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/02/22 ~ 2024/02/23",
"pay_dt": "2024/02/27",
"refund_dt": "2024/02/27",
"list_dt": "2024/03/05",
"lead_mgr": "하나증권",
"pub_bf_cap": " 60500",
"pub_af_cap": " 125000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240220",
"sht_cd": "472230",
"isin_name": "에스케이증권제11호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/02/20 ~ 2024/02/21",
"pay_dt": "2024/02/23",
"refund_dt": "2024/02/23",
"list_dt": "2024/03/04",
"lead_mgr": "SK증권",
"pub_bf_cap": " 15500",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240220",
"sht_cd": "473050",
"isin_name": "유안타제15호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/02/20 ~ 2024/02/21",
"pay_dt": "2024/02/23",
"refund_dt": "2024/02/23",
"list_dt": "2024/02/29",
"lead_mgr": "유안타증권",
"pub_bf_cap": " 51000",
"pub_af_cap": " 162500",
"assign_stk_qty": " 0"
},
{
"record_date": "20240219",
"sht_cd": "468760",
"isin_name": "유진기업인수목적10호",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/02/19 ~ 2024/02/20",
"pay_dt": "2024/02/22",
"refund_dt": "2024/02/22",
"list_dt": "2024/02/29",
"lead_mgr": "유진투자증권",
"pub_bf_cap": " 24000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240219",
"sht_cd": "473370",
"isin_name": "비엔케이제2호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/02/19 ~ 2024/02/20",
"pay_dt": "2024/02/22",
"refund_dt": "2024/02/22",
"list_dt": "2024/03/05",
"lead_mgr": "비엔케이투자증권",
"pub_bf_cap": " 21000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240214",
"sht_cd": "278470",
"isin_name": "에이피알",
"fix_subscr_pri": " 250000",
"face_value": "000000500",
"subscr_dt": "2024/02/14 ~ 2024/02/15",
"pay_dt": "2024/02/19",
"refund_dt": "2024/02/19",
"list_dt": "2024/02/27",
"lead_mgr": "신한투자증권, 하나증권",
"pub_bf_cap": " 3637689",
"pub_af_cap": " 56850",
"assign_stk_qty": " 0"
},
{
"record_date": "20240213",
"sht_cd": "068100",
"isin_name": "케이웨더",
"fix_subscr_pri": " 7000",
"face_value": "000000500",
"subscr_dt": "2024/02/13 ~ 2024/02/14",
"pay_dt": "2024/02/16",
"refund_dt": "2024/02/16",
"list_dt": "2024/02/22",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 4454807",
"pub_af_cap": " 125000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240213",
"sht_cd": "360350",
"isin_name": "코셈",
"fix_subscr_pri": " 16000",
"face_value": "000000500",
"subscr_dt": "2024/02/13 ~ 2024/02/14",
"pay_dt": "2024/02/16",
"refund_dt": "2024/02/16",
"list_dt": "2024/02/23",
"lead_mgr": "키움증권",
"pub_bf_cap": " 2521985",
"pub_af_cap": " 75000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240213",
"sht_cd": "418620",
"isin_name": "이에이트",
"fix_subscr_pri": " 20000",
"face_value": "000000500",
"subscr_dt": "2024/02/13 ~ 2024/02/14",
"pay_dt": "2024/02/16",
"refund_dt": "2024/02/16",
"list_dt": "2024/02/23",
"lead_mgr": "한화투자증권",
"pub_bf_cap": " 4205888",
"pub_af_cap": " 141250",
"assign_stk_qty": " 0"
},
{
"record_date": "20240125",
"sht_cd": "415380",
"isin_name": "스튜디오삼익",
"fix_subscr_pri": " 18000",
"face_value": "000000500",
"subscr_dt": "2024/01/25 ~ 2024/01/26",
"pay_dt": "2024/01/30",
"refund_dt": "2024/01/30",
"list_dt": "2024/02/06",
"lead_mgr": "DB금융투자",
"pub_bf_cap": " 1674999",
"pub_af_cap": " 106250",
"assign_stk_qty": " 0"
},
{
"record_date": "20240125",
"sht_cd": "472220",
"isin_name": "신영해피투모로우제10호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/01/25 ~ 2024/01/26",
"pay_dt": "2024/01/30",
"refund_dt": "2024/01/30",
"list_dt": "2024/02/06",
"lead_mgr": "신영증권",
"pub_bf_cap": " 11500",
"pub_af_cap": " 114375",
"assign_stk_qty": " 0"
},
{
"record_date": "20240123",
"sht_cd": "452400",
"isin_name": "이닉스",
"fix_subscr_pri": " 14000",
"face_value": "000000500",
"subscr_dt": "2024/01/23 ~ 2024/01/24",
"pay_dt": "2024/01/26",
"refund_dt": "2024/01/26",
"list_dt": "2024/02/01",
"lead_mgr": "삼성증권㈜",
"pub_bf_cap": " 3000000",
"pub_af_cap": " 375000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240123",
"sht_cd": "469480",
"isin_name": "아이비케이에스제24호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/01/23 ~ 2024/01/24",
"pay_dt": "2024/01/26",
"refund_dt": "2024/01/26",
"list_dt": "",
"lead_mgr": "아이비케이투자증권㈜",
"pub_bf_cap": " 23000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20240117",
"sht_cd": "105760",
"isin_name": "포스뱅크",
"fix_subscr_pri": " 18000",
"face_value": "000000500",
"subscr_dt": "2024/01/17 ~ 2024/01/18",
"pay_dt": "2024/01/22",
"refund_dt": "2024/01/22",
"list_dt": "2024/01/29",
"lead_mgr": "하나증권",
"pub_bf_cap": " 3905242",
"pub_af_cap": " 187500",
"assign_stk_qty": " 0"
},
{
"record_date": "20240117",
"sht_cd": "460930",
"isin_name": "현대힘스",
"fix_subscr_pri": " 7300",
"face_value": "000000500",
"subscr_dt": "2024/01/17 ~ 2024/01/18",
"pay_dt": "2024/01/22",
"refund_dt": "2024/01/24",
"list_dt": "2024/01/26",
"lead_mgr": "미래에셋증권",
"pub_bf_cap": " 14800000",
"pub_af_cap": " 1306050",
"assign_stk_qty": " 0"
},
{
"record_date": "20240116",
"sht_cd": "440290",
"isin_name": "에이치비인베스트먼트",
"fix_subscr_pri": " 3400",
"face_value": "000000500",
"subscr_dt": "2024/01/16 ~ 2024/01/17",
"pay_dt": "2024/01/19",
"refund_dt": "2024/01/19",
"list_dt": "2024/01/25",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 10000000",
"pub_af_cap": " 833375",
"assign_stk_qty": " 0"
},
{
"record_date": "20240116",
"sht_cd": "457550",
"isin_name": "우진엔텍",
"fix_subscr_pri": " 5300",
"face_value": "000000500",
"subscr_dt": "2024/01/16 ~ 2024/01/17",
"pay_dt": "2024/01/19",
"refund_dt": "2024/01/19",
"list_dt": "2024/01/24",
"lead_mgr": "KB증권",
"pub_bf_cap": " 3574770",
"pub_af_cap": " 257500",
"assign_stk_qty": " 0"
},
{
"record_date": "20240115",
"sht_cd": "471050",
"isin_name": "대신밸런스제17호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2024/01/15 ~ 2024/01/16",
"pay_dt": "2024/01/18",
"refund_dt": "2024/01/18",
"list_dt": "2024/01/24",
"lead_mgr": "대신증권",
"pub_bf_cap": " 56000",
"pub_af_cap": " 137500",
"assign_stk_qty": " 0"
},
{
"record_date": "20231214",
"sht_cd": "017860",
"isin_name": "디에스단석",
"fix_subscr_pri": " 100000",
"face_value": "000000500",
"subscr_dt": "2023/12/14 ~ 2023/12/15",
"pay_dt": "2023/12/19",
"refund_dt": "2023/12/19",
"list_dt": "",
"lead_mgr": "KB증권,NH투자증권",
"pub_bf_cap": " 2530702",
"pub_af_cap": " 152500",
"assign_stk_qty": " 0"
},
{
"record_date": "20231213",
"sht_cd": "469880",
"isin_name": "하나30호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/12/13 ~ 2023/12/14",
"pay_dt": "2023/12/18",
"refund_dt": "2023/12/18",
"list_dt": "2023/12/22",
"lead_mgr": "하나증권㈜",
"pub_bf_cap": " 30500",
"pub_af_cap": " 175000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231212",
"sht_cd": "467930",
"isin_name": "아이비케이에스제23호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/12/12 ~ 2023/12/13",
"pay_dt": "2023/12/15",
"refund_dt": "2023/12/15",
"list_dt": "2023/12/22",
"lead_mgr": "아이비케이투자증권",
"pub_bf_cap": " 23000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231204",
"sht_cd": "439580",
"isin_name": "블루엠텍",
"fix_subscr_pri": " 19000",
"face_value": "000000100",
"subscr_dt": "2023/12/04 ~ 2023/12/05",
"pay_dt": "2023/12/07",
"refund_dt": "2023/12/07",
"list_dt": "2023/12/13",
"lead_mgr": "하나증권,키움증권",
"pub_bf_cap": " 920819",
"pub_af_cap": " 35000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231201",
"sht_cd": "417200",
"isin_name": "엘에스머트리얼즈",
"fix_subscr_pri": " 6000",
"face_value": "000000500",
"subscr_dt": "2023/12/01 ~ 2023/12/04",
"pay_dt": "2023/12/06",
"refund_dt": "2023/12/06",
"list_dt": "2023/12/12",
"lead_mgr": "키움증권,KB증권,이베스트투자증권,하이투",
"pub_bf_cap": " 29438830",
"pub_af_cap": " 1828125",
"assign_stk_qty": " 0"
},
{
"record_date": "20231127",
"sht_cd": "432470",
"isin_name": "케이엔에스",
"fix_subscr_pri": " 23000",
"face_value": "000000100",
"subscr_dt": "2023/11/27 ~ 2023/11/28",
"pay_dt": "2023/11/30",
"refund_dt": "2023/11/30",
"list_dt": "2023/12/06",
"lead_mgr": "신영증권",
"pub_bf_cap": " 311106",
"pub_af_cap": " 18750",
"assign_stk_qty": " 0"
},
{
"record_date": "20231123",
"sht_cd": "338840",
"isin_name": "와이바이오로직스",
"fix_subscr_pri": " 9000",
"face_value": "000000500",
"subscr_dt": "2023/11/23 ~ 2023/11/24",
"pay_dt": "2023/11/28",
"refund_dt": "2023/11/28",
"list_dt": "2023/12/05",
"lead_mgr": "유안타증권",
"pub_bf_cap": " 6639074",
"pub_af_cap": " 750000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231123",
"sht_cd": "465320",
"isin_name": "교보15호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/11/23 ~ 2023/11/24",
"pay_dt": "2023/11/28",
"refund_dt": "2023/11/28",
"list_dt": "",
"lead_mgr": "교보증권",
"pub_bf_cap": " 31000",
"pub_af_cap": " 350000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231123",
"sht_cd": "468510",
"isin_name": "삼성기업인수목적9호",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/11/23 ~ 2023/11/24",
"pay_dt": "2023/11/28",
"refund_dt": "2023/11/28",
"list_dt": "2023/12/04",
"lead_mgr": "삼성증권",
"pub_bf_cap": " 105000",
"pub_af_cap": " 1000000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231121",
"sht_cd": "355690",
"isin_name": "에이텀",
"fix_subscr_pri": " 18000",
"face_value": "000000500",
"subscr_dt": "2023/11/21 ~ 2023/11/22",
"pay_dt": "2023/11/24",
"refund_dt": "2023/11/24",
"list_dt": "2023/12/01",
"lead_mgr": "하나증권",
"pub_bf_cap": " 2337840",
"pub_af_cap": " 81250",
"assign_stk_qty": " 0"
},
{
"record_date": "20231121",
"sht_cd": "466910",
"isin_name": "엔에이치기업인수목적30호",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/11/21 ~ 2023/11/22",
"pay_dt": "2023/11/24",
"refund_dt": "2023/11/24",
"list_dt": "2023/12/01",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 110000",
"pub_af_cap": " 200000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231116",
"sht_cd": "453860",
"isin_name": "에이에스텍",
"fix_subscr_pri": " 28000",
"face_value": "000000500",
"subscr_dt": "2023/11/16 ~ 2023/11/17",
"pay_dt": "2023/11/21",
"refund_dt": "2023/11/21",
"list_dt": "2023/11/28",
"lead_mgr": "미래에셋증권",
"pub_bf_cap": " 2388750",
"pub_af_cap": " 175875",
"assign_stk_qty": " 0"
},
{
"record_date": "20231113",
"sht_cd": "402490",
"isin_name": "그린리소스",
"fix_subscr_pri": " 17000",
"face_value": "000000500",
"subscr_dt": "2023/11/13 ~ 2023/11/14",
"pay_dt": "2023/11/16",
"refund_dt": "2023/11/16",
"list_dt": "2023/11/24",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 3247372",
"pub_af_cap": " 205000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231113",
"sht_cd": "452280",
"isin_name": "한선엔지니어링",
"fix_subscr_pri": " 7000",
"face_value": "000000500",
"subscr_dt": "2023/11/13 ~ 2023/11/14",
"pay_dt": "2023/11/16",
"refund_dt": "2023/11/16",
"list_dt": "2023/11/24",
"lead_mgr": "대신증권",
"pub_bf_cap": " 6312500",
"pub_af_cap": " 531250",
"assign_stk_qty": " 0"
},
{
"record_date": "20231110",
"sht_cd": "448280",
"isin_name": "에코아이",
"fix_subscr_pri": " 34700",
"face_value": "000000500",
"subscr_dt": "2023/11/10 ~ 2023/11/13",
"pay_dt": "2023/11/15",
"refund_dt": "2023/11/15",
"list_dt": "2023/11/21",
"lead_mgr": "KB증권",
"pub_bf_cap": " 3884612",
"pub_af_cap": " 259875",
"assign_stk_qty": " 0"
},
{
"record_date": "20231109",
"sht_cd": "111380",
"isin_name": "동인기연",
"fix_subscr_pri": " 30000",
"face_value": "000000100",
"subscr_dt": "2023/11/09 ~ 2023/11/10",
"pay_dt": "2023/11/14",
"refund_dt": "2023/11/14",
"list_dt": "2023/11/21",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 500000",
"pub_af_cap": " 44112",
"assign_stk_qty": " 0"
},
{
"record_date": "20231109",
"sht_cd": "352090",
"isin_name": "스톰테크",
"fix_subscr_pri": " 11000",
"face_value": "000000100",
"subscr_dt": "2023/11/09 ~ 2023/11/10",
"pay_dt": "2023/11/14",
"refund_dt": "2023/11/14",
"list_dt": "2023/11/20",
"lead_mgr": "하이투자증권",
"pub_bf_cap": " 999559",
"pub_af_cap": " 83750",
"assign_stk_qty": " 0"
},
{
"record_date": "20231108",
"sht_cd": "450080",
"isin_name": "에코프로머티리얼즈",
"fix_subscr_pri": " 36200",
"face_value": "000000500",
"subscr_dt": "2023/11/08 ~ 2023/11/09",
"pay_dt": "2023/11/13",
"refund_dt": "2023/11/13",
"list_dt": "2023/11/17",
"lead_mgr": "미래에셋증권, NH투자증권, 하이투자증권",
"pub_bf_cap": " 28951079",
"pub_af_cap": " 1737120",
"assign_stk_qty": " 0"
},
{
"record_date": "20231106",
"sht_cd": "452300",
"isin_name": "캡스톤파트너스",
"fix_subscr_pri": " 4000",
"face_value": "000000200",
"subscr_dt": "2023/11/06 ~ 2023/11/07",
"pay_dt": "2023/11/09",
"refund_dt": "2023/11/09",
"list_dt": "2023/11/15",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 2340500",
"pub_af_cap": " 79800",
"assign_stk_qty": " 0"
},
{
"record_date": "20231102",
"sht_cd": "445090",
"isin_name": "에이직랜드",
"fix_subscr_pri": " 25000",
"face_value": "000000500",
"subscr_dt": "2023/11/02 ~ 2023/11/03",
"pay_dt": "2023/11/07",
"refund_dt": "2023/11/07",
"list_dt": "2023/11/13",
"lead_mgr": "삼성증권",
"pub_bf_cap": " 3954495",
"pub_af_cap": " 329542",
"assign_stk_qty": " 0"
},
{
"record_date": "20231101",
"sht_cd": "365330",
"isin_name": "에스와이스틸텍",
"fix_subscr_pri": " 1800",
"face_value": "000000500",
"subscr_dt": "2023/11/01 ~ 2023/11/02",
"pay_dt": "2023/11/06",
"refund_dt": "2023/11/06",
"list_dt": "2023/11/13",
"lead_mgr": "KB증권",
"pub_bf_cap": " 11700000",
"pub_af_cap": " 875000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231101",
"sht_cd": "464440",
"isin_name": "한국제13호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/11/01 ~ 2023/11/02",
"pay_dt": "2023/11/06",
"refund_dt": "2023/11/06",
"list_dt": "2023/11/13",
"lead_mgr": "한국투자증권",
"pub_bf_cap": " 32000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 1000000"
},
{
"record_date": "20231031",
"sht_cd": "372320",
"isin_name": "큐로셀",
"fix_subscr_pri": " 20000",
"face_value": "000000500",
"subscr_dt": "2023/10/31 ~ 2023/11/01",
"pay_dt": "2023/11/03",
"refund_dt": "2023/11/03",
"list_dt": "2023/11/09",
"lead_mgr": "삼성증권,미래에셋증권",
"pub_bf_cap": " 5982368",
"pub_af_cap": " 200000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231031",
"sht_cd": "413640",
"isin_name": "비아이매트릭스",
"fix_subscr_pri": " 13000",
"face_value": "000000500",
"subscr_dt": "2023/10/31 ~ 2023/11/01",
"pay_dt": "2023/11/03",
"refund_dt": "2023/11/03",
"list_dt": "2023/11/09",
"lead_mgr": "아이비케이투자증권",
"pub_bf_cap": " 2985470",
"pub_af_cap": " 150000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231031",
"sht_cd": "446540",
"isin_name": "메가터치",
"fix_subscr_pri": " 4800",
"face_value": "000000500",
"subscr_dt": "2023/10/31 ~ 2023/11/01",
"pay_dt": "2023/11/03",
"refund_dt": "2023/11/03",
"list_dt": "2023/11/09",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 7707500",
"pub_af_cap": " 650000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231031",
"sht_cd": "451760",
"isin_name": "컨텍",
"fix_subscr_pri": " 22500",
"face_value": "000000500",
"subscr_dt": "2023/10/31 ~ 2023/11/01",
"pay_dt": "2023/11/03",
"refund_dt": "2023/11/03",
"list_dt": "2023/11/09",
"lead_mgr": "대신증권",
"pub_bf_cap": " 6169890",
"pub_af_cap": " 257500",
"assign_stk_qty": " 0"
},
{
"record_date": "20231026",
"sht_cd": "088280",
"isin_name": "쏘닉스",
"fix_subscr_pri": " 7500",
"face_value": "000001000",
"subscr_dt": "2023/10/26 ~ 2023/10/27",
"pay_dt": "2023/10/31",
"refund_dt": "2023/10/31",
"list_dt": "2023/11/07",
"lead_mgr": "KB증권",
"pub_bf_cap": " 13598490",
"pub_af_cap": " 900000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231024",
"sht_cd": "464680",
"isin_name": "케이비제27호기업인수목적",
"fix_subscr_pri": " 2000",
"face_value": "000000100",
"subscr_dt": "2023/10/24 ~ 2023/10/25",
"pay_dt": "2023/10/27",
"refund_dt": "2023/10/27",
"list_dt": "2023/11/03",
"lead_mgr": "KB증권",
"pub_bf_cap": " 40500",
"pub_af_cap": " 312500",
"assign_stk_qty": " 0"
},
{
"record_date": "20231023",
"sht_cd": "221800",
"isin_name": "유투바이오",
"fix_subscr_pri": " 4400",
"face_value": "000000500",
"subscr_dt": "2023/10/23 ~ 2023/10/24",
"pay_dt": "2023/10/26",
"refund_dt": "2023/10/26",
"list_dt": "",
"lead_mgr": "신한투자증권",
"pub_bf_cap": " 5051020",
"pub_af_cap": " 141090",
"assign_stk_qty": " 0"
},
{
"record_date": "20231023",
"sht_cd": "240600",
"isin_name": "유진테크놀로지",
"fix_subscr_pri": " 17000",
"face_value": "000000500",
"subscr_dt": "2023/10/23 ~ 2023/10/24",
"pay_dt": "2023/10/26",
"refund_dt": "2023/10/26",
"list_dt": "2023/11/02",
"lead_mgr": "NH투자증권",
"pub_bf_cap": " 2642734",
"pub_af_cap": " 131186",
"assign_stk_qty": " 0"
},
{
"record_date": "20231018",
"sht_cd": "432720",
"isin_name": "퀄리타스반도체",
"fix_subscr_pri": " 17000",
"face_value": "000000500",
"subscr_dt": "2023/10/18 ~ 2023/10/19",
"pay_dt": "2023/10/23",
"refund_dt": "2023/10/23",
"list_dt": "2023/10/27",
"lead_mgr": "한국투자증권",
"pub_bf_cap": " 4476920",
"pub_af_cap": " 225000",
"assign_stk_qty": " 450000"
},
{
"record_date": "20231016",
"sht_cd": "396470",
"isin_name": "워트",
"fix_subscr_pri": " 6500",
"face_value": "000000100",
"subscr_dt": "2023/10/16 ~ 2023/10/17",
"pay_dt": "2023/10/19",
"refund_dt": "2023/10/19",
"list_dt": "2023/10/26",
"lead_mgr": "키움증권",
"pub_bf_cap": " 1200000",
"pub_af_cap": " 100000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231010",
"sht_cd": "246250",
"isin_name": "에스엘에스바이오",
"fix_subscr_pri": " 7000",
"face_value": "000000500",
"subscr_dt": "2023/10/10 ~ 2023/10/11",
"pay_dt": "2023/10/13",
"refund_dt": "2023/10/13",
"list_dt": "2023/10/20",
"lead_mgr": "하나증권",
"pub_bf_cap": " 3432802",
"pub_af_cap": " 96250",
"assign_stk_qty": " 0"
},
{
"record_date": "20231010",
"sht_cd": "416180",
"isin_name": "신성에스티",
"fix_subscr_pri": " 26000",
"face_value": "000000500",
"subscr_dt": "2023/10/10 ~ 2023/10/11",
"pay_dt": "2023/10/13",
"refund_dt": "2023/10/13",
"list_dt": "2023/10/19",
"lead_mgr": "미래에셋증권",
"pub_bf_cap": " 3500658",
"pub_af_cap": " 250000",
"assign_stk_qty": " 0"
},
{
"record_date": "20231005",
"sht_cd": "445180",
"isin_name": "퓨릿",
"fix_subscr_pri": " 10700",
"face_value": "000000500",
"subscr_dt": "2023/10/05 ~ 2023/10/06",
"pay_dt": "2023/10/11",
"refu
```
@@ -0,0 +1,459 @@
# 국내주식 재무비율
- 원본 시트명: 국내주식 재무비율
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-080
- HTTP Method: GET
- 실전 TR_ID: FHKST66430300
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/financial-ratio
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 재무비율 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 우측의 '재무 비율' 기능을 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 | FHKST66430300 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| grs | 매출액 증가율 | string | Y | 124 | |
| bsop_prfi_inrt | 영업 이익 증가율 | string | Y | 124 | 적자지속, 흑자전환, 적자전환인 경우 0으로 표시 |
| ntin_inrt | 순이익 증가율 | string | Y | 124 | |
| roe_val | ROE 값 | string | Y | 132 | |
| eps | EPS | string | Y | 112 | |
| sps | 주당매출액 | string | Y | 18 | |
| bps | BPS | string | Y | 112 | |
| rsrv_rate | 유보 비율 | string | Y | 84 | |
| lblt_rate | 부채 비율 | string | Y | 84 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"grs": "-14.33",
"bsop_prfi_inrt": "-84.86",
"ntin_inrt": "-72.17",
"roe_val": "4.14",
"eps": "2131.00",
"sps": "38120",
"bps": "52002.00",
"rsrv_rate": "39256.91",
"lblt_rate": "25.36"
},
{
"stac_yymm": "202309",
"grs": "-17.52",
"bsop_prfi_inrt": "-90.42",
"ntin_inrt": "-71.26",
"roe_val": "3.22",
"eps": "1244.00",
"sps": "37522",
"bps": "52068.00",
"rsrv_rate": "39306.65",
"lblt_rate": "24.89"
},
{
"stac_yymm": "202306",
"grs": "-20.15",
"bsop_prfi_inrt": "-95.36",
"ntin_inrt": "-85.29",
"roe_val": "1.70",
"eps": "434.00",
"sps": "36437",
"bps": "51385.00",
"rsrv_rate": "38789.91",
"lblt_rate": "24.80"
},
{
"stac_yymm": "202303",
"grs": "-18.05",
"bsop_prfi_inrt": "-95.47",
"ntin_inrt": "-86.10",
"roe_val": "1.61",
"eps": "206.00",
"sps": "37538",
"bps": "51529.00",
"rsrv_rate": "38898.83",
"lblt_rate": "26.21"
},
{
"stac_yymm": "202212",
"grs": "8.09",
"bsop_prfi_inrt": "-15.99",
"ntin_inrt": "39.46",
"roe_val": "17.07",
"eps": "8057.00",
"sps": "44494",
"bps": "50817.00",
"rsrv_rate": "38360.25",
"lblt_rate": "26.41"
},
{
"stac_yymm": "202209",
"grs": "14.15",
"bsop_prfi_inrt": "3.45",
"ntin_inrt": "9.44",
"roe_val": "13.18",
"eps": "4597.00",
"sps": "45494",
"bps": "49387.00",
"rsrv_rate": "37277.71",
"lblt_rate": "36.35"
},
{
"stac_yymm": "202206",
"grs": "20.09",
"bsop_prfi_inrt": "28.56",
"ntin_inrt": "33.66",
"roe_val": "14.36",
"eps": "3251.00",
"sps": "45633",
"bps": "46937.00",
"rsrv_rate": "35423.75",
"lblt_rate": "36.64"
},
{
"stac_yymm": "202203",
"grs": "18.95",
"bsop_prfi_inrt": "50.50",
"ntin_inrt": "58.57",
"roe_val": "14.77",
"eps": "1638.00",
"sps": "45803",
"bps": "45106.00",
"rsrv_rate": "34037.84",
"lblt_rate": "39.34"
},
{
"stac_yymm": "202112",
"grs": "18.07",
"bsop_prfi_inrt": "43.45",
"ntin_inrt": "51.12",
"roe_val": "13.92",
"eps": "5777.00",
"sps": "41163",
"bps": "43611.00",
"rsrv_rate": "32906.47",
"lblt_rate": "39.92"
},
{
"stac_yymm": "202109",
"grs": "15.85",
"bsop_prfi_inrt": "40.15",
"ntin_inrt": "46.81",
"roe_val": "13.72",
"eps": "4211.00",
"sps": "39855",
"bps": "42447.00",
"rsrv_rate": "32025.54",
"lblt_rate": "38.30"
},
{
"stac_yymm": "202106",
"grs": "19.18",
"bsop_prfi_inrt": "50.41",
"ntin_inrt": "60.69",
"roe_val": "12.21",
"eps": "2435.00",
"sps": "38000",
"bps": "40361.00",
"rsrv_rate": "30446.66",
"lblt_rate": "36.29"
},
{
"stac_yymm": "202103",
"grs": "18.19",
"bsop_prfi_inrt": "45.53",
"ntin_inrt": "46.20",
"roe_val": "10.64",
"eps": "1044.00",
"sps": "38505",
"bps": "39126.00",
"rsrv_rate": "29511.49",
"lblt_rate": "43.23"
},
{
"stac_yymm": "202012",
"grs": "2.78",
"bsop_prfi_inrt": "29.62",
"ntin_inrt": "21.48",
"roe_val": "9.99",
"eps": "3841.00",
"sps": "34862",
"bps": "39406.00",
"rsrv_rate": "29723.53",
"lblt_rate": "37.07"
},
{
"stac_yymm": "202009",
"grs": "2.78",
"bsop_prfi_inrt": "30.76",
"ntin_inrt": "19.92",
"roe_val": "10.02",
"eps": "2892.00",
"sps": "34401",
"bps": "39446.00",
"rsrv_rate": "29753.81",
"lblt_rate": "36.09"
},
{
"stac_yymm": "202006",
"grs": "-0.20",
"bsop_prfi_inrt": "13.74",
"ntin_inrt": "2.11",
"roe_val": "8.04",
"eps": "1528.00",
"sps": "31885",
"bps": "38534.00",
"rsrv_rate": "29063.37",
"lblt_rate": "32.67"
},
{
"stac_yymm": "202003",
"grs": "5.61",
"bsop_prfi_inrt": "3.43",
"ntin_inrt": "-3.15",
"roe_val": "7.62",
"eps": "720.00",
"sps": "32579",
"bps": "38053.00",
"rsrv_rate": "28699.75",
"lblt_rate": "34.19"
},
{
"stac_yymm": "201912",
"grs": "-5.48",
"bsop_prfi_inrt": "-52.84",
"ntin_inrt": "-50.98",
"roe_val": "8.69",
"eps": "3166.00",
"sps": "33919",
"bps": "37528.00",
"rsrv_rate": "28302.40",
"lblt_rate": "34.12"
},
{
"stac_yymm": "201909",
"grs": "-7.58",
"bsop_prfi_inrt": "-57.14",
"ntin_inrt": "-53.98",
"roe_val": "8.76",
"eps": "2396.00",
"sps": "33471",
"bps": "37600.00",
"rsrv_rate": "28356.77",
"lblt_rate": "34.14"
},
{
"stac_yymm": "201906",
"grs": "-8.85",
"bsop_prfi_inrt": "-57.95",
"ntin_inrt": "-55.02",
"roe_val": "8.30",
"eps": "1498.00",
"sps": "31950",
"bps": "36789.00",
"rsrv_rate": "27742.76",
"lblt_rate": "33.05"
},
{
"stac_yymm": "201903",
"grs": "-13.50",
"bsop_prfi_inrt": "-60.15",
"ntin_inrt": "-56.85",
"roe_val": "8.41",
"eps": "752.00",
"sps": "30848",
"bps": "36142.00",
"rsrv_rate": "27253.31",
"lblt_rate": "36.27"
},
{
"stac_yymm": "201812",
"grs": "1.75",
"bsop_prfi_inrt": "9.77",
"ntin_inrt": "5.12",
"roe_val": "19.63",
"eps": "6024.00",
"sps": "33458",
"bps": "35342.00",
"rsrv_rate": "26648.22",
"lblt_rate": "36.97"
},
{
"stac_yymm": "201809",
"grs": "6.28",
"bsop_prfi_inrt": "24.91",
"ntin_inrt": "19.88",
"roe_val": "21.47",
"eps": "4853.00",
"sps": "33572",
"bps": "32685.00",
"rsrv_rate": "26568.28",
"lblt_rate": "39.28"
},
{
"stac_yymm": "201806",
"grs": "6.72",
"bsop_prfi_inrt": "27.32",
"ntin_inrt": "21.31",
"roe_val": "20.88",
"eps": "3082.00",
"sps": "32482",
"bps": "31483.00",
"rsrv_rate": "25587.24",
"lblt_rate": "36.70"
},
{
"stac_yymm": "201803",
"grs": "19.82",
"bsop_prfi_inrt": "58.03",
"ntin_inrt": "52.11",
"roe_val": "21.96",
"eps": "1583.00",
"sps": "33017",
"bps": "30146.00",
"rsrv_rate": "24496.79",
"lblt_rate": "39.96"
},
{
"stac_yymm": "201712",
"grs": "18.68",
"bsop_prfi_inrt": "83.46",
"ntin_inrt": "85.63",
"roe_val": "21.01",
"eps": "5421.00",
"sps": "31414",
"bps": "28971.00",
"rsrv_rate": "23681.42",
"lblt_rate": "40.68"
},
{
"stac_yymm": "201709",
"grs": "16.87",
"bsop_prfi_inrt": "92.30",
"ntin_inrt": "91.40",
"roe_val": "20.06",
"eps": "3804.00",
"sps": "30021",
"bps": "28305.00",
"rsrv_rate": "23266.64",
"lblt_rate": "40.76"
},
{
"stac_yymm": "201706",
"grs": "10.75",
"bsop_prfi_inrt": "61.71",
"ntin_inrt": "68.81",
"roe_val": "19.25",
"eps": "2328.00",
"sps": "28399",
"bps": "26828.00",
"rsrv_rate": "22216.19",
"lblt_rate": "38.31"
},
{
"stac_yymm": "201703",
"grs": "1.54",
"bsop_prfi_inrt": "48.27",
"ntin_inrt": "46.29",
"roe_val": "16.21",
"eps": "929.00",
"sps": "25087",
"bps": "24184.00",
"rsrv_rate": "21617.29",
"lblt_rate": "39.20"
},
{
"stac_yymm": "201612",
"grs": "0.60",
"bsop_prfi_inrt": "10.70",
"ntin_inrt": "19.23",
"roe_val": "12.48",
"eps": "2735.00",
"sps": "24632",
"bps": "24340.00",
"rsrv_rate": "21757.56",
"lblt_rate": "35.87"
},
{
"stac_yymm": "201609",
"grs": "0.81",
"bsop_prfi_inrt": "-1.24",
"ntin_inrt": "-1.25",
"roe_val": "11.94",
"eps": "1881.00",
"sps": "24033",
"bps": "22708.00",
"rsrv_rate": "20291.88",
"lblt_rate": "36.17"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,167 @@
# 예탁원정보(무상증자일정)
- 원본 시트명: 예탁원정보(무상증자일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-144
- HTTP Method: GET
- 실전 TR_ID: HHKDB669101C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/bonus-issue
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(무상증자일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0656] 무상증자 화면의 기능을 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 | HHKDB669101C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| CTS | CTS | string | Y | 17 | 공백 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
### 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| fix_rate | 확정배정율 | string | Y | 152 | |
| odd_rec_price | 단주기준가 | string | Y | 9 | |
| right_dt | 권리락일 | string | Y | 8 | |
| odd_pay_dt | 단주대금지급일 | string | Y | 23 | |
| list_date | 상장/등록일 | string | Y | 8 | |
| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
| issue_stk_qty | 발행할주식 | string | Y | 12 | |
| stk_kind | 주식종류 | string | Y | 2 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240326",
"sht_cd": "466100",
"isin_name": "클로봇",
"fix_rate": "1000.0",
"odd_rec_price": "000000000",
"right_dt": "20240325",
"odd_pay_dt": "",
"list_date": "",
"tot_issue_stk_qty": " 1885394",
"issue_stk_qty": " 18853940",
"stk_kind": "01"
},
{
"record_date": "20240315",
"sht_cd": "473980",
"isin_name": "노머스",
"fix_rate": "3900.0",
"odd_rec_price": "000000000",
"right_dt": "20240314",
"odd_pay_dt": "",
"list_date": "",
"tot_issue_stk_qty": " 234220",
"issue_stk_qty": " 9134580",
"stk_kind": "01"
},
{
"record_date": "20240314",
"sht_cd": "377220",
"isin_name": "프롬바이오",
"fix_rate": "100.00",
"odd_rec_price": "000000000",
"right_dt": "20240313",
"odd_pay_dt": "",
"list_date": "20240405",
"tot_issue_stk_qty": " 14155000",
"issue_stk_qty": " 14155000",
"stk_kind": "01"
},
{
"record_date": "20240307",
"sht_cd": "357230",
"isin_name": "에이치피오",
"fix_rate": "100.00",
"odd_rec_price": "000000000",
"right_dt": "20240306",
"odd_pay_dt": "",
"list_date": "20240329",
"tot_issue_stk_qty": " 21149725",
"issue_stk_qty": " 20337240",
"stk_kind": "01"
},
{
"record_date": "20240305",
"sht_cd": "005810",
"isin_name": "풍산홀딩스",
"fix_rate": " 50.00",
"odd_rec_price": "000029850",
"right_dt": "20240304",
"odd_pay_dt": "2024/03/29 ~ 2024/03/29",
"list_date": "20240322",
"tot_issue_stk_qty": " 9748528",
"issue_stk_qty": " 4668764",
"stk_kind": "01"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,237 @@
# 국내주식 증권사별 투자의견
- 원본 시트명: 국내주식 증권사별 투자의견
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-189
- HTTP Method: GET
- 실전 TR_ID: FHKST663400C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/invest-opbysec
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 증권사별 투자의견 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0608] 증권사별 투자의견 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한 번의 호출에 20건까지 조회가 가능하기에, 일자 파라미터(FID_INPUT_DATE_1, FID_INPUT_DATE_2)를 조절하여 다음 데이터 조회하시기 바랍니다.
## 레이아웃
### 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 | FHKST663400C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J(시장 구분 코드) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 16634(Primary key) |
| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 회원사코드 (kis developers 포탈 사이트 포럼-> FAQ -> 종목정보 다운로드(국내) 참조) |
| FID_DIV_CLS_CODE | 분류구분코드 | string | Y | 2 | 전체(0) 매수(1) 중립(2) 매도(3) |
| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 이후 ~ |
| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~ 이전 |
### 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 array | Y | | array |
| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
| stck_shrn_iscd | 주식단축종목코드 | string | Y | 9 | |
| hts_kor_isnm | HTS한글종목명 | string | Y | 40 | |
| invt_opnn | 투자의견 | string | Y | 40 | |
| invt_opnn_cls_code | 투자의견구분코드 | string | Y | 2 | |
| rgbf_invt_opnn | 직전투자의견 | string | Y | 40 | |
| rgbf_invt_opnn_cls_code | 직전투자의견구분코드 | string | Y | 2 | |
| mbcr_name | 회원사명 | string | Y | 50 | |
| stck_prpr | 주식현재가 | string | Y | 10 | |
| prdy_vrss | 전일대비 | string | Y | 10 | |
| prdy_vrss_sign | 전일대비부호 | string | Y | 1 | |
| prdy_ctrt | 전일대비율 | string | Y | 82 | |
| hts_goal_prc | HTS목표가격 | string | Y | 10 | |
| stck_prdy_clpr | 주식전일종가 | string | Y | 10 | |
| stft_esdg | 주식선물괴리도 | string | Y | 10 | |
| dprt | 괴리율 | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
FID_COND_MRKT_DIV_CODE:J
FID_COND_SCR_DIV_CODE:16633
FID_INPUT_ISCD:999
FID_DIV_CLS_CODE:0
FID_INPUT_DATE_1:20240428
FID_INPUT_DATE_2:20240528
```
### Response Example
```text
{
"output": [
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "454910",
"hts_kor_isnm": "두산로보틱스",
"invt_opnn": "NotRated",
"invt_opnn_cls_code": "3",
"rgbf_invt_opnn": "NotRated",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "상상인",
"stck_prpr": "74300",
"prdy_vrss": "500",
"prdy_vrss_sign": "2",
"prdy_ctrt": "0.68",
"hts_goal_prc": "0",
"stck_prdy_clpr": "71600",
"stft_esdg": "74300",
"dprt": "0.00"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "389140",
"hts_kor_isnm": "포바이포",
"invt_opnn": "NotRated",
"invt_opnn_cls_code": "3",
"rgbf_invt_opnn": "NotRated",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "상상인",
"stck_prpr": "10330",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"hts_goal_prc": "0",
"stck_prdy_clpr": "10120",
"stft_esdg": "10330",
"dprt": "0.00"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "336260",
"hts_kor_isnm": "두산퓨얼셀",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "상상인",
"stck_prpr": "26150",
"prdy_vrss": "-50",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-0.19",
"hts_goal_prc": "33000",
"stck_prdy_clpr": "25000",
"stft_esdg": "-6850",
"dprt": "-20.76"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "298380",
"hts_kor_isnm": "에이비엘바이오",
"invt_opnn": "NotRated",
"invt_opnn_cls_code": "3",
"rgbf_invt_opnn": "NotRated",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "상상인",
"stck_prpr": "23300",
"prdy_vrss": "-100",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-0.43",
"hts_goal_prc": "0",
"stck_prdy_clpr": "24300",
"stft_esdg": "23300",
"dprt": "0.00"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "377740",
"hts_kor_isnm": "바이오노트",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "다올투자",
"stck_prpr": "4135",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-0.24",
"hts_goal_prc": "5700",
"stck_prdy_clpr": "4175",
"stft_esdg": "-1565",
"dprt": "-27.46"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "137310",
"hts_kor_isnm": "에스디바이오센서",
"invt_opnn": "HOLD",
"invt_opnn_cls_code": "3",
"rgbf_invt_opnn": "HOLD",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "다올투자",
"stck_prpr": "10110",
"prdy_vrss": "60",
"prdy_vrss_sign": "2",
"prdy_ctrt": "0.60",
"hts_goal_prc": "11000",
"stck_prdy_clpr": "10060",
"stft_esdg": "-890",
"dprt": "-8.09"
},
{
"stck_bsop_date": "20240527",
"stck_shrn_iscd": "298020",
"hts_kor_isnm": "효성티앤씨",
"invt_opnn": "매수",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "매수",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "IBK투자",
"stck_prpr": "389000",
"prdy_vrss": "-19000",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-4.66",
"hts_goal_prc": "550000",
"stck_prdy_clpr": "400500",
"stft_esdg": "-161000",
"dprt": "-29.27"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,597 @@
# 국내주식 당사 신용가능종목
- 원본 시트명: 국내주식 당사 신용가능종목
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-111
- HTTP Method: GET
- 실전 TR_ID: FHPST04770000
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/credit-by-company
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 당사 신용가능종목 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0477] 당사 신용가능 종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 100건 확인 가능하며, 다음 조회가 불가합니다.
## 레이아웃
### 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 | FHPST04770000 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| fid_rank_sort_cls_code | 순위 정렬 구분 코드 | string | Y | 2 | 0:코드순, 1:이름순 |
| fid_slct_yn | 선택 여부 | string | Y | 1 | 0:신용주문가능, 1: 신용주문불가 |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
| fid_cond_scr_div_code | 조건 화면 분류 코드 | string | Y | 5 | Unique key(20477) |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
### 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 array | Y | | array |
| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
| crdt_rate | 신용 비율 | string | Y | 84 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20477",
"fid_input_iscd":"0000",
"fid_slct_yn":"0",
"fid_rank_sort_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stck_shrn_iscd": "473440",
"hts_kor_isnm": "ACE 11월만기자동연장회사채AA-이상액티브",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "105190",
"hts_kor_isnm": "ACE 200",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "332500",
"hts_kor_isnm": "ACE 200TR",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "448880",
"hts_kor_isnm": "ACE 24-12 회사채(AA-이상)액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "461270",
"hts_kor_isnm": "ACE 26-06 회사채(AA-이상)액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "414270",
"hts_kor_isnm": "ACE G2전기차&자율주행액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "365780",
"hts_kor_isnm": "ACE 국고채10년",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "446770",
"hts_kor_isnm": "ACE 글로벌반도체TOP4 Plus SOLACTIVE",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "190620",
"hts_kor_isnm": "ACE 단기통안채",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "453850",
"hts_kor_isnm": "ACE 미국30년국채액티브(H)",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "360200",
"hts_kor_isnm": "ACE 미국S&P500",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "438080",
"hts_kor_isnm": "ACE 미국S&P500채권혼합액티브",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "309230",
"hts_kor_isnm": "ACE 미국WideMoat가치주",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "367380",
"hts_kor_isnm": "ACE 미국나스닥100",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "456880",
"hts_kor_isnm": "ACE 미국달러SOFR금리(합성)",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "402970",
"hts_kor_isnm": "ACE 미국배당다우존스",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "465580",
"hts_kor_isnm": "ACE 미국빅테크TOP7 Plus",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "245710",
"hts_kor_isnm": "ACE 베트남VN30(합성)",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "448540",
"hts_kor_isnm": "ACE 엔비디아채권혼합블룸버그",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "238720",
"hts_kor_isnm": "ACE 일본Nikkei225(H)",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "356540",
"hts_kor_isnm": "ACE 종합채권(AA-이상)KIS액티브",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "457480",
"hts_kor_isnm": "ACE 테슬라밸류체인액티브",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "469170",
"hts_kor_isnm": "ACE 포스코그룹포커스",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "265520",
"hts_kor_isnm": "AP시스템",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "152100",
"hts_kor_isnm": "ARIRANG 200",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "453010",
"hts_kor_isnm": "ARIRANG KOFR금리",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "449450",
"hts_kor_isnm": "ARIRANG K방산Fn",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "161510",
"hts_kor_isnm": "ARIRANG 고배당주",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "464470",
"hts_kor_isnm": "ARIRANG 미국채30년액티브",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "195980",
"hts_kor_isnm": "ARIRANG 신흥국MSCI(합성 H)",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "421320",
"hts_kor_isnm": "ARIRANG 우주항공&UAM iSelect",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "328370",
"hts_kor_isnm": "ARIRANG 코스피TR",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "027410",
"hts_kor_isnm": "BGF",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "282330",
"hts_kor_isnm": "BGF리테일",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "126600",
"hts_kor_isnm": "BGF에코머티리얼즈",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "138930",
"hts_kor_isnm": "BNK금융지주",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "001040",
"hts_kor_isnm": "CJ",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "000120",
"hts_kor_isnm": "CJ대한통운",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "011150",
"hts_kor_isnm": "CJ씨푸드",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "097950",
"hts_kor_isnm": "CJ제일제당",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "097955",
"hts_kor_isnm": "CJ제일제당 우",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "051500",
"hts_kor_isnm": "CJ프레시웨이",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "058820",
"hts_kor_isnm": "CMG제약",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "012030",
"hts_kor_isnm": "DB",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "005830",
"hts_kor_isnm": "DB손해보험",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "000990",
"hts_kor_isnm": "DB하이텍",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "139130",
"hts_kor_isnm": "DGB금융지주",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "001530",
"hts_kor_isnm": "DI동일",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "375500",
"hts_kor_isnm": "DL이앤씨",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "068790",
"hts_kor_isnm": "DMS",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "007340",
"hts_kor_isnm": "DN오토모티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "241520",
"hts_kor_isnm": "DSC인베스트먼트",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "017940",
"hts_kor_isnm": "E1",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "007700",
"hts_kor_isnm": "F&F홀딩스",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "078930",
"hts_kor_isnm": "GS",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "001250",
"hts_kor_isnm": "GS글로벌",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "007070",
"hts_kor_isnm": "GS리테일",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "293180",
"hts_kor_isnm": "HANARO 200",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "454320",
"hts_kor_isnm": "HANARO CAPEX설비투자iSelect",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "395290",
"hts_kor_isnm": "HANARO Fn K-POP&미디어",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "395270",
"hts_kor_isnm": "HANARO Fn K-반도체",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "441540",
"hts_kor_isnm": "HANARO Fn조선해운",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "434730",
"hts_kor_isnm": "HANARO 원자력iSelect",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "078150",
"hts_kor_isnm": "HB테크놀러지",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "089470",
"hts_kor_isnm": "HDC현대EP",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "009540",
"hts_kor_isnm": "HD한국조선해양",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "267250",
"hts_kor_isnm": "HD현대",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "267270",
"hts_kor_isnm": "HD현대건설기계",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "322000",
"hts_kor_isnm": "HD현대에너지솔루션",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "042670",
"hts_kor_isnm": "HD현대인프라코어",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "329180",
"hts_kor_isnm": "HD현대중공업",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "195940",
"hts_kor_isnm": "HK이노엔",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "204320",
"hts_kor_isnm": "HL만도",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "060980",
"hts_kor_isnm": "HL홀딩스",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "011200",
"hts_kor_isnm": "HMM",
"crdt_rate": "20.00"
},
{
"stck_shrn_iscd": "036640",
"hts_kor_isnm": "HRS",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "095340",
"hts_kor_isnm": "ISC",
"crdt_rate": "60.00"
},
{
"stck_shrn_iscd": "175330",
"hts_kor_isnm": "JB금융지주",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "234080",
"hts_kor_isnm": "JW생명과학",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "035900",
"hts_kor_isnm": "JYP Ent.",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "148020",
"hts_kor_isnm": "KBSTAR 200",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "448600",
"hts_kor_isnm": "KBSTAR 25-11 회사채(AA-이상)액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "465330",
"hts_kor_isnm": "KBSTAR 2차전지TOP10",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "422420",
"hts_kor_isnm": "KBSTAR 2차전지액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "469070",
"hts_kor_isnm": "KBSTAR AI&로봇",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "290130",
"hts_kor_isnm": "KBSTAR ESG사회책임투자",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "367760",
"hts_kor_isnm": "KBSTAR Fn5G테크",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "367770",
"hts_kor_isnm": "KBSTAR Fn수소경제테마",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "326240",
"hts_kor_isnm": "KBSTAR IT플러스",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "385560",
"hts_kor_isnm": "KBSTAR KIS국고채30년Enhanced",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "401170",
"hts_kor_isnm": "KBSTAR iSelect메타버스",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "266160",
"hts_kor_isnm": "KBSTAR 고배당",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "385550",
"hts_kor_isnm": "KBSTAR 단기종합채권(AA-이상)액티브",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "196230",
"hts_kor_isnm": "KBSTAR 단기통안채",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "315960",
"hts_kor_isnm": "KBSTAR 대형고배당10TR",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "455890",
"hts_kor_isnm": "KBSTAR 머니마켓액티브",
"crdt_rate": "30.00"
},
{
"stck_shrn_iscd": "379780",
"hts_kor_isnm": "KBSTAR 미국S&P500",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "453330",
"hts_kor_isnm": "KBSTAR 미국S&P500(H)",
"crdt_rate": "50.00"
},
{
"stck_shrn_iscd": "368590",
"hts_kor_isnm": "KBSTAR 미국나스닥100",
"crdt_rate": "40.00"
},
{
"stck_shrn_iscd": "437350",
"hts_kor_isnm": "KBSTAR 미국단기투자등급회사채액티브",
"crdt_rate": "40.00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,244 @@
# 예탁원정보(액면교체일정)
- 원본 시트명: 예탁원정보(액면교체일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-148
- HTTP Method: GET
- 실전 TR_ID: HHKDB669105C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/rev-split
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(액면교체일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0657] 액면교체 화면의 기능을 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 | HHKDB669105C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
| CTS | CTS | string | Y | 17 | 공백 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| MARKET_GB | 시장구분 | string | Y | 1 | 0:전체, 1:코스피, 2:코스닥 |
### Response Header
| Element | 한글명 | Type | Required | Length | Description |
| --- | --- | --- | --- | --- | --- |
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | string | N | 1 | 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| inter_bf_face_amt | 변경전액면가 | string | Y | 9 | |
| inter_af_face_amt | 변경후액면가 | string | Y | 9 | |
| td_stop_dt | 매매거래정지기간 | string | Y | 23 | |
| list_dt | 상장/등록일 | string | Y | 10 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
market_gb:1
```
### Response Example
```text
{
"output1": [
{
"record_date": "20230823",
"sht_cd": "001390",
"isin_name": "케이지케미칼",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000001000",
"td_stop_dt": "2023/08/22 ~ 2023/08/27",
"list_dt": "2023/08/28"
},
{
"record_date": "20230823",
"sht_cd": "011690",
"isin_name": "와이투솔루션",
"inter_bf_face_amt": "000000500",
"inter_af_face_amt": "000002500",
"td_stop_dt": "2023/08/22 ~ 2023/09/11",
"list_dt": "2023/09/12"
},
{
"record_date": "20230626",
"sht_cd": "017860",
"isin_name": "디에스단석",
"inter_bf_face_amt": "000001000",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/06/23 ~",
"list_dt": ""
},
{
"record_date": "20230525",
"sht_cd": "111380",
"isin_name": "동인기연",
"inter_bf_face_amt": "000010000",
"inter_af_face_amt": "000000100",
"td_stop_dt": "2023/05/24 ~",
"list_dt": "2023/11/21"
},
{
"record_date": "20230525",
"sht_cd": "11138K",
"isin_name": "동인기연1우",
"inter_bf_face_amt": "000010000",
"inter_af_face_amt": "000000100",
"td_stop_dt": "2023/05/24 ~",
"list_dt": "2023/11/21"
},
{
"record_date": "20230509",
"sht_cd": "002900",
"isin_name": "티와이엠",
"inter_bf_face_amt": "000000500",
"inter_af_face_amt": "000002500",
"td_stop_dt": "2023/05/08 ~ 2023/05/21",
"list_dt": "2023/05/22"
},
{
"record_date": "20230503",
"sht_cd": "001140",
"isin_name": "국보",
"inter_bf_face_amt": "000000500",
"inter_af_face_amt": "000005000",
"td_stop_dt": "2023/05/02 ~ 2023/05/22",
"list_dt": "2023/05/23"
},
{
"record_date": "20230502",
"sht_cd": "001440",
"isin_name": "대한전선",
"inter_bf_face_amt": "000000100",
"inter_af_face_amt": "000001000",
"td_stop_dt": "2023/04/28 ~ 2023/05/15",
"list_dt": "2023/05/16"
},
{
"record_date": "20230420",
"sht_cd": "016590",
"isin_name": "신대양제지",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/19 ~ 2023/04/23",
"list_dt": "2023/04/24"
},
{
"record_date": "20230414",
"sht_cd": "049770",
"isin_name": "동원에프앤비",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000001000",
"td_stop_dt": "2023/04/13 ~ 2023/04/18",
"list_dt": "2023/04/19"
},
{
"record_date": "20230413",
"sht_cd": "003120",
"isin_name": "일성신약",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000001000",
"td_stop_dt": "2023/04/12 ~ 2023/04/16",
"list_dt": "2023/04/17"
},
{
"record_date": "20230413",
"sht_cd": "007120",
"isin_name": "미래아이앤지",
"inter_bf_face_amt": "000000100",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/12 ~ 2023/05/03",
"list_dt": "2023/05/04"
},
{
"record_date": "20230411",
"sht_cd": "002200",
"isin_name": "한국수출포장공업",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/10 ~ 2023/04/16",
"list_dt": "2023/04/17"
},
{
"record_date": "20230410",
"sht_cd": "380440",
"isin_name": "엔에이치기업인수목적19호",
"inter_bf_face_amt": "000000100",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/07 ~ 2023/05/01",
"list_dt": "2023/05/02"
},
{
"record_date": "20230407",
"sht_cd": "000480",
"isin_name": "시알홀딩스",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/06 ~ 2023/04/12",
"list_dt": "2023/04/13"
},
{
"record_date": "20230407",
"sht_cd": "003200",
"isin_name": "일신방직",
"inter_bf_face_amt": "000005000",
"inter_af_face_amt": "000000500",
"td_stop_dt": "2023/04/06 ~ 2023/04/13",
"list_dt": "2023/04/14"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,203 @@
# 국내주식 종목투자의견
- 원본 시트명: 국내주식 종목투자의견
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-188
- HTTP Method: GET
- 실전 TR_ID: FHKST663300C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/invest-opinion
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 종목투자의견 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0605] 종목투자의견 화면 의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한 번의 호출에 100건까지 조회가 가능하기에, 일자 파라미터(FID_INPUT_DATE_1, FID_INPUT_DATE_2)를 조절하여 다음 데이터 조회하시기 바랍니다.
## 레이아웃
### 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 | FHKST663300C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | string | Y | 2 | J(시장 구분 코드) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | string | Y | 5 | 16633(Primary key) |
| FID_INPUT_ISCD | 입력종목코드 | string | Y | 12 | 종목코드(ex) 005930(삼성전자)) |
| FID_INPUT_DATE_1 | 입력날짜1 | string | Y | 10 | 이후 ~(ex) 0020231113) |
| FID_INPUT_DATE_2 | 입력날짜2 | string | Y | 10 | ~ 이전(ex) 0020240513) |
### 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 array | Y | | array |
| stck_bsop_date | 주식영업일자 | string | Y | 8 | |
| invt_opnn | 투자의견 | string | Y | 40 | |
| invt_opnn_cls_code | 투자의견구분코드 | string | Y | 2 | |
| rgbf_invt_opnn | 직전투자의견 | string | Y | 40 | |
| rgbf_invt_opnn_cls_code | 직전투자의견구분코드 | string | Y | 2 | |
| mbcr_name | 회원사명 | string | Y | 50 | |
| hts_goal_prc | HTS목표가격 | string | Y | 10 | |
| stck_prdy_clpr | 주식전일종가 | string | Y | 10 | |
| stck_nday_esdg | 주식N일괴리도 | string | Y | 10 | |
| nday_dprt | N일괴리율 | string | Y | 82 | |
| stft_esdg | 주식선물괴리도 | string | Y | 10 | |
| dprt | 괴리율 | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
FID_COND_MRKT_DIV_CODE:J
FID_COND_SCR_DIV_CODE:16633
FID_INPUT_ISCD:005930
FID_INPUT_DATE_1:20240101
FID_INPUT_DATE_2:20240528
```
### Response Example
```text
{
"output": [
{
"stck_bsop_date": "20240527",
"invt_opnn": "매수",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "매수",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "SK",
"hts_goal_prc": "105000",
"stck_prdy_clpr": "75900",
"stck_nday_esdg": "-29100",
"nday_dprt": "-27.71",
"stft_esdg": "-27400",
"dprt": "-26.10"
},
{
"stck_bsop_date": "20240520",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "하이투자",
"hts_goal_prc": "91000",
"stck_prdy_clpr": "77400",
"stck_nday_esdg": "-13600",
"nday_dprt": "-14.95",
"stft_esdg": "-13400",
"dprt": "-14.73"
},
{
"stck_bsop_date": "20240516",
"invt_opnn": "매수",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "매수",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "미래에셋",
"hts_goal_prc": "110000",
"stck_prdy_clpr": "78300",
"stck_nday_esdg": "-31700",
"nday_dprt": "-28.82",
"stft_esdg": "-32400",
"dprt": "-29.45"
},
{
"stck_bsop_date": "20240502",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "다올투자",
"hts_goal_prc": "105000",
"stck_prdy_clpr": "77500",
"stck_nday_esdg": "-27500",
"nday_dprt": "-26.19",
"stft_esdg": "-27400",
"dprt": "-26.10"
},
{
"stck_bsop_date": "20240502",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "하이투자",
"hts_goal_prc": "95000",
"stck_prdy_clpr": "77500",
"stck_nday_esdg": "-17500",
"nday_dprt": "-18.42",
"stft_esdg": "-17400",
"dprt": "-18.32"
},
{
"stck_bsop_date": "20240502",
"invt_opnn": "BUY",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "BUY",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "KB",
"hts_goal_prc": "120000",
"stck_prdy_clpr": "77500",
"stck_nday_esdg": "-42500",
"nday_dprt": "-35.42",
"stft_esdg": "-42400",
"dprt": "-35.33"
},
{
"stck_bsop_date": "20240502",
"invt_opnn": "매수",
"invt_opnn_cls_code": "2",
"rgbf_invt_opnn": "매수",
"rgbf_invt_opnn_cls_code": "3",
"mbcr_name": "신한투자증권",
"hts_goal_prc": "110000",
"stck_prdy_clpr": "77500",
"stck_nday_esdg": "-32500",
"nday_dprt": "-29.55",
"stft_esdg": "-32400",
"dprt": "-29.45"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,304 @@
# 국내주식 안정성비율
- 원본 시트명: 국내주식 안정성비율
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-083
- HTTP Method: GET
- 실전 TR_ID: FHKST66430600
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/stability-ratio
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 안정성비율 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '5. 안정성비율' 기능을 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 | FHKST66430600 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| lblt_rate | 부채 비율 | string | Y | 84 | |
| bram_depn | 차입금 의존도 | string | Y | 92 | |
| crnt_rate | 유동 비율 | string | Y | 84 | |
| quck_rate | 당좌 비율 | string | Y | 84 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"lblt_rate": "25.36",
"bram_depn": "2.78",
"crnt_rate": "258.77",
"quck_rate": "190.59"
},
{
"stac_yymm": "202309",
"lblt_rate": "24.89",
"bram_depn": "2.21",
"crnt_rate": "280.39",
"quck_rate": "205.34"
},
{
"stac_yymm": "202306",
"lblt_rate": "24.80",
"bram_depn": "2.04",
"crnt_rate": "288.18",
"quck_rate": "209.76"
},
{
"stac_yymm": "202303",
"lblt_rate": "26.21",
"bram_depn": "2.19",
"crnt_rate": "281.95",
"quck_rate": "210.40"
},
{
"stac_yymm": "202212",
"lblt_rate": "26.41",
"bram_depn": "2.30",
"crnt_rate": "278.86",
"quck_rate": "212.24"
},
{
"stac_yymm": "202209",
"lblt_rate": "36.35",
"bram_depn": "2.65",
"crnt_rate": "294.17",
"quck_rate": "226.96"
},
{
"stac_yymm": "202206",
"lblt_rate": "36.64",
"bram_depn": "3.89",
"crnt_rate": "283.45",
"quck_rate": "220.96"
},
{
"stac_yymm": "202203",
"lblt_rate": "39.34",
"bram_depn": "4.11",
"crnt_rate": "256.86",
"quck_rate": "204.26"
},
{
"stac_yymm": "202112",
"lblt_rate": "39.92",
"bram_depn": "4.31",
"crnt_rate": "247.58",
"quck_rate": "200.62"
},
{
"stac_yymm": "202109",
"lblt_rate": "38.30",
"bram_depn": "4.65",
"crnt_rate": "259.91",
"quck_rate": "213.74"
},
{
"stac_yymm": "202106",
"lblt_rate": "36.29",
"bram_depn": "4.35",
"crnt_rate": "263.75",
"quck_rate": "217.39"
},
{
"stac_yymm": "202103",
"lblt_rate": "43.23",
"bram_depn": "5.08",
"crnt_rate": "232.11",
"quck_rate": "198.13"
},
{
"stac_yymm": "202012",
"lblt_rate": "37.07",
"bram_depn": "5.35",
"crnt_rate": "262.17",
"quck_rate": "219.79"
},
{
"stac_yymm": "202009",
"lblt_rate": "36.09",
"bram_depn": "5.22",
"crnt_rate": "278.77",
"quck_rate": "234.36"
},
{
"stac_yymm": "202006",
"lblt_rate": "32.67",
"bram_depn": "4.66",
"crnt_rate": "300.88",
"quck_rate": "252.96"
},
{
"stac_yymm": "202003",
"lblt_rate": "34.19",
"bram_depn": "4.38",
"crnt_rate": "288.34",
"quck_rate": "244.41"
},
{
"stac_yymm": "201912",
"lblt_rate": "34.12",
"bram_depn": "5.22",
"crnt_rate": "284.38",
"quck_rate": "242.41"
},
{
"stac_yymm": "201909",
"lblt_rate": "34.14",
"bram_depn": "4.57",
"crnt_rate": "293.89",
"quck_rate": "245.06"
},
{
"stac_yymm": "201906",
"lblt_rate": "33.05",
"bram_depn": "4.51",
"crnt_rate": "292.42",
"quck_rate": "239.74"
},
{
"stac_yymm": "201903",
"lblt_rate": "36.27",
"bram_depn": "3.83",
"crnt_rate": "263.37",
"quck_rate": "216.66"
},
{
"stac_yymm": "201812",
"lblt_rate": "36.97",
"bram_depn": "4.32",
"crnt_rate": "252.89",
"quck_rate": "210.93"
},
{
"stac_yymm": "201809",
"lblt_rate": "39.28",
"bram_depn": "6.43",
"crnt_rate": "235.97",
"quck_rate": "198.16"
},
{
"stac_yymm": "201806",
"lblt_rate": "36.70",
"bram_depn": "5.05",
"crnt_rate": "239.29",
"quck_rate": "197.58"
},
{
"stac_yymm": "201803",
"lblt_rate": "39.96",
"bram_depn": "4.12",
"crnt_rate": "226.86",
"quck_rate": "188.10"
},
{
"stac_yymm": "201712",
"lblt_rate": "40.68",
"bram_depn": "6.23",
"crnt_rate": "218.80",
"quck_rate": "181.61"
},
{
"stac_yymm": "201709",
"lblt_rate": "40.76",
"bram_depn": "6.26",
"crnt_rate": "219.61",
"quck_rate": "178.76"
},
{
"stac_yymm": "201706",
"lblt_rate": "38.31",
"bram_depn": "6.02",
"crnt_rate": "226.06",
"quck_rate": "186.68"
},
{
"stac_yymm": "201703",
"lblt_rate": "39.20",
"bram_depn": "5.01",
"crnt_rate": "227.44",
"quck_rate": "188.99"
},
{
"stac_yymm": "201612",
"lblt_rate": "35.87",
"bram_depn": "5.83",
"crnt_rate": "258.54",
"quck_rate": "224.99"
},
{
"stac_yymm": "201609",
"lblt_rate": "36.17",
"bram_depn": "5.30",
"crnt_rate": "261.93",
"quck_rate": "225.50"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,304 @@
# 국내주식 수익성비율
- 원본 시트명: 국내주식 수익성비율
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-081
- HTTP Method: GET
- 실전 TR_ID: FHKST66430400
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/profit-ratio
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 수익성비율 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '4. 수익성비율' 기능을 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 | FHKST66430400 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| cptl_ntin_rate | 총자본 순이익율 | string | Y | 92 | |
| self_cptl_ntin_inrt | 자기자본 순이익율 | string | Y | 92 | |
| sale_ntin_rate | 매출액 순이익율 | string | Y | 92 | |
| sale_totl_rate | 매출액 총이익율 | string | Y | 92 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"cptl_ntin_rate": "3.43",
"self_cptl_ntin_inrt": "4.14",
"sale_ntin_rate": "5.98",
"sale_totl_rate": "30.33"
},
{
"stac_yymm": "202309",
"cptl_ntin_rate": "2.70",
"self_cptl_ntin_inrt": "3.22",
"sale_ntin_rate": "4.78",
"sale_totl_rate": "29.76"
},
{
"stac_yymm": "202306",
"cptl_ntin_rate": "1.47",
"self_cptl_ntin_inrt": "1.70",
"sale_ntin_rate": "2.67",
"sale_totl_rate": "29.17"
},
{
"stac_yymm": "202303",
"cptl_ntin_rate": "1.40",
"self_cptl_ntin_inrt": "1.61",
"sale_ntin_rate": "2.47",
"sale_totl_rate": "27.83"
},
{
"stac_yymm": "202212",
"cptl_ntin_rate": "12.72",
"self_cptl_ntin_inrt": "17.07",
"sale_ntin_rate": "18.41",
"sale_totl_rate": "37.12"
},
{
"stac_yymm": "202209",
"cptl_ntin_rate": "9.46",
"self_cptl_ntin_inrt": "13.18",
"sale_ntin_rate": "13.73",
"sale_totl_rate": "38.98"
},
{
"stac_yymm": "202206",
"cptl_ntin_rate": "10.25",
"self_cptl_ntin_inrt": "14.36",
"sale_ntin_rate": "14.47",
"sale_totl_rate": "39.77"
},
{
"stac_yymm": "202203",
"cptl_ntin_rate": "10.46",
"self_cptl_ntin_inrt": "14.77",
"sale_ntin_rate": "14.56",
"sale_totl_rate": "39.48"
},
{
"stac_yymm": "202112",
"cptl_ntin_rate": "9.92",
"self_cptl_ntin_inrt": "13.92",
"sale_ntin_rate": "14.27",
"sale_totl_rate": "40.48"
},
{
"stac_yymm": "202109",
"cptl_ntin_rate": "9.83",
"self_cptl_ntin_inrt": "13.72",
"sale_ntin_rate": "14.32",
"sale_totl_rate": "40.18"
},
{
"stac_yymm": "202106",
"cptl_ntin_rate": "8.79",
"self_cptl_ntin_inrt": "12.21",
"sale_ntin_rate": "13.00",
"sale_totl_rate": "39.12"
},
{
"stac_yymm": "202103",
"cptl_ntin_rate": "7.41",
"self_cptl_ntin_inrt": "10.64",
"sale_ntin_rate": "10.92",
"sale_totl_rate": "36.53"
},
{
"stac_yymm": "202012",
"cptl_ntin_rate": "7.23",
"self_cptl_ntin_inrt": "9.99",
"sale_ntin_rate": "11.15",
"sale_totl_rate": "38.98"
},
{
"stac_yymm": "202009",
"cptl_ntin_rate": "7.25",
"self_cptl_ntin_inrt": "10.02",
"sale_ntin_rate": "11.30",
"sale_totl_rate": "39.13"
},
{
"stac_yymm": "202006",
"cptl_ntin_rate": "5.88",
"self_cptl_ntin_inrt": "8.04",
"sale_ntin_rate": "9.64",
"sale_totl_rate": "38.39"
},
{
"stac_yymm": "202003",
"cptl_ntin_rate": "5.50",
"self_cptl_ntin_inrt": "7.62",
"sale_ntin_rate": "8.83",
"sale_totl_rate": "37.09"
},
{
"stac_yymm": "201912",
"cptl_ntin_rate": "6.28",
"self_cptl_ntin_inrt": "8.69",
"sale_ntin_rate": "9.44",
"sale_totl_rate": "36.09"
},
{
"stac_yymm": "201909",
"cptl_ntin_rate": "6.36",
"self_cptl_ntin_inrt": "8.76",
"sale_ntin_rate": "9.68",
"sale_totl_rate": "36.26"
},
{
"stac_yymm": "201906",
"cptl_ntin_rate": "5.99",
"self_cptl_ntin_inrt": "8.30",
"sale_ntin_rate": "9.42",
"sale_totl_rate": "36.70"
},
{
"stac_yymm": "201903",
"cptl_ntin_rate": "5.90",
"self_cptl_ntin_inrt": "8.41",
"sale_ntin_rate": "9.63",
"sale_totl_rate": "37.49"
},
{
"stac_yymm": "201812",
"cptl_ntin_rate": "13.83",
"self_cptl_ntin_inrt": "19.63",
"sale_ntin_rate": "18.19",
"sale_totl_rate": "45.69"
},
{
"stac_yymm": "201809",
"cptl_ntin_rate": "14.98",
"self_cptl_ntin_inrt": "21.47",
"sale_ntin_rate": "19.45",
"sale_totl_rate": "46.68"
},
{
"stac_yymm": "201806",
"cptl_ntin_rate": "14.66",
"self_cptl_ntin_inrt": "20.88",
"sale_ntin_rate": "19.10",
"sale_totl_rate": "46.92"
},
{
"stac_yymm": "201803",
"cptl_ntin_rate": "15.22",
"self_cptl_ntin_inrt": "21.96",
"sale_ntin_rate": "19.30",
"sale_totl_rate": "47.31"
},
{
"stac_yymm": "201712",
"cptl_ntin_rate": "14.96",
"self_cptl_ntin_inrt": "21.01",
"sale_ntin_rate": "17.61",
"sale_totl_rate": "46.03"
},
{
"stac_yymm": "201709",
"cptl_ntin_rate": "14.28",
"self_cptl_ntin_inrt": "20.06",
"sale_ntin_rate": "17.24",
"sale_totl_rate": "46.11"
},
{
"stac_yymm": "201706",
"cptl_ntin_rate": "13.89",
"self_cptl_ntin_inrt": "19.25",
"sale_ntin_rate": "16.80",
"sale_totl_rate": "45.71"
},
{
"stac_yymm": "201703",
"cptl_ntin_rate": "11.68",
"self_cptl_ntin_inrt": "16.21",
"sale_ntin_rate": "15.20",
"sale_totl_rate": "44.30"
},
{
"stac_yymm": "201612",
"cptl_ntin_rate": "9.01",
"self_cptl_ntin_inrt": "12.48",
"sale_ntin_rate": "11.26",
"sale_totl_rate": "40.42"
},
{
"stac_yymm": "201609",
"cptl_ntin_rate": "8.57",
"self_cptl_ntin_inrt": "11.94",
"sale_ntin_rate": "10.53",
"sale_totl_rate": "39.82"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,166 @@
# 예탁원정보(실권주일정)
- 원본 시트명: 예탁원정보(실권주일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-152
- HTTP Method: GET
- 실전 TR_ID: HHKDB669109C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/forfeit
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(실권주일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0668] 실권주 화면의 기능을 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 | HHKDB669109C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| CTS | CTS | string | Y | 17 | 공백 |
### 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| subscr_dt | 청약일 | string | Y | 23 | |
| subscr_price | 공모가 | string | Y | 9 | |
| subscr_stk_qty | 공모주식수 | string | Y | 12 | |
| refund_dt | 환불일 | string | Y | 10 | |
| list_dt | 상장/등록일 | string | Y | 10 | |
| lead_mgr | 주간사 | string | Y | 25 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240131",
"sht_cd": "001440",
"isin_name": "대한전선",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"subscr_price": "000007460",
"subscr_stk_qty": " 62000000",
"refund_dt": "2024/03/19",
"list_dt": "2024/04/02",
"lead_mgr": "케이비증권,미래에셋증권,"
},
{
"record_date": "20240131",
"sht_cd": "001447",
"isin_name": "대한전선2우",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"subscr_price": "000007460",
"subscr_stk_qty": " 62000000",
"refund_dt": "2024/03/19",
"list_dt": "2024/04/02",
"lead_mgr": "케이비증권,미래에셋증권,"
},
{
"record_date": "20240131",
"sht_cd": "001449",
"isin_name": "대한전선3우",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"subscr_price": "000007460",
"subscr_stk_qty": " 62000000",
"refund_dt": "2024/03/19",
"list_dt": "2024/04/02",
"lead_mgr": "케이비증권,미래에셋증권,"
},
{
"record_date": "20240131",
"sht_cd": "00144A",
"isin_name": "대한전선4우",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"subscr_price": "000007460",
"subscr_stk_qty": " 62000000",
"refund_dt": "2024/03/19",
"list_dt": "2024/04/02",
"lead_mgr": "케이비증권,미래에셋증권,"
},
{
"record_date": "20240131",
"sht_cd": "00144K",
"isin_name": "대한전선5우",
"subscr_dt": "2024/03/14 ~ 2024/03/15",
"subscr_price": "000007460",
"subscr_stk_qty": " 62000000",
"refund_dt": "2024/03/19",
"list_dt": "2024/04/02",
"lead_mgr": "케이비증권,미래에셋증권,"
},
{
"record_date": "20240126",
"sht_cd": "034220",
"isin_name": "LG디스플레이",
"subscr_dt": "2024/03/11 ~ 2024/03/12",
"subscr_price": "000009090",
"subscr_stk_qty": " 142184300",
"refund_dt": "2024/03/14",
"list_dt": "2024/03/26",
"lead_mgr": "한국투자증권,NH투자증권,"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,257 @@
# 예탁원정보(의무예치일정)
- 원본 시트명: 예탁원정보(의무예치일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-153
- HTTP Method: GET
- 실전 TR_ID: HHKDB669110C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/mand-deposit
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(의무예치일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0758] 의무예치 화면의 기능을 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 | HHKDB669110C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| CTS | CTS | string | Y | 17 | 공백 |
### 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 array | Y | | array |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| stk_qty | 주식수 | string | Y | 12 | |
| depo_date | 예치일 | string | Y | 23 | |
| depo_reason | 사유 | string | Y | 10 | |
| tot_issue_qty_per_rate | 총발행주식수대비비율(%) | string | Y | 52 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"sht_cd": "27322R",
"isin_name": "뷰텔7우",
"stk_qty": " 68966",
"depo_date": "2024/03/26 ~ 2025/03/26",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "10000"
},
{
"sht_cd": "455900",
"isin_name": "엔젤로보틱스",
"stk_qty": " 48000",
"depo_date": "2024/03/26 ~ 2024/06/26",
"depo_reason": "-",
"tot_issue_qty_per_rate": "33.51"
},
{
"sht_cd": "455900",
"isin_name": "엔젤로보틱스",
"stk_qty": " 4224840",
"depo_date": "2024/03/26 ~ 2027/03/26",
"depo_reason": "최대주주",
"tot_issue_qty_per_rate": "3014."
},
{
"sht_cd": "455900",
"isin_name": "엔젤로보틱스",
"stk_qty": " 307036",
"depo_date": "2024/03/26 ~ 2024/04/26",
"depo_reason": "최대주주",
"tot_issue_qty_per_rate": "214.3"
},
{
"sht_cd": "45590S",
"isin_name": "엔젤로보틱스 8우",
"stk_qty": " 65128",
"depo_date": "2024/03/26 ~ 2024/04/26",
"depo_reason": "벤처금융",
"tot_issue_qty_per_rate": "700.0"
},
{
"sht_cd": "45590S",
"isin_name": "엔젤로보틱스 8우",
"stk_qty": " 865277",
"depo_date": "2024/03/26 ~ 2024/04/26",
"depo_reason": "최대주주",
"tot_issue_qty_per_rate": "9300."
},
{
"sht_cd": "119650",
"isin_name": "케이씨코트렐",
"stk_qty": " 12733857",
"depo_date": "2024/03/25 ~ 2025/03/25",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "2000."
},
{
"sht_cd": "123840",
"isin_name": "뉴온",
"stk_qty": " 62516803",
"depo_date": "2024/03/25 ~ 2024/09/25",
"depo_reason": "-",
"tot_issue_qty_per_rate": "2253."
},
{
"sht_cd": "420570",
"isin_name": "제이투케이바이오",
"stk_qty": " 951",
"depo_date": "2024/03/25 ~ 2024/09/25",
"depo_reason": "-",
"tot_issue_qty_per_rate": " 1.71"
},
{
"sht_cd": "019570",
"isin_name": "리더스기술투자",
"stk_qty": " 8905532",
"depo_date": "2024/03/22 ~ 2025/03/22",
"depo_reason": "-",
"tot_issue_qty_per_rate": "1697."
},
{
"sht_cd": "036180",
"isin_name": "지더블유바이텍",
"stk_qty": " 28911564",
"depo_date": "2024/03/22 ~ 2025/03/22",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "3160."
},
{
"sht_cd": "069110",
"isin_name": "코스온",
"stk_qty": " 4000000",
"depo_date": "2024/03/22 ~ 2025/03/22",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "1107."
},
{
"sht_cd": "440110",
"isin_name": "파두",
"stk_qty": " 270200",
"depo_date": "2024/03/22 ~ 2024/08/07",
"depo_reason": "-",
"tot_issue_qty_per_rate": "55.06"
},
{
"sht_cd": "222080",
"isin_name": "씨아이에스",
"stk_qty": " 42636",
"depo_date": "2024/03/21 ~ 2024/09/21",
"depo_reason": "-",
"tot_issue_qty_per_rate": " 5.97"
},
{
"sht_cd": "245620",
"isin_name": "이원다이애그노믹스",
"stk_qty": " 17633408",
"depo_date": "2024/03/21 ~ 2025/03/21",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "1273."
},
{
"sht_cd": "437730",
"isin_name": "삼현",
"stk_qty": " 33333",
"depo_date": "2024/03/21 ~ 2024/06/21",
"depo_reason": "-",
"tot_issue_qty_per_rate": "31.54"
},
{
"sht_cd": "437730",
"isin_name": "삼현",
"stk_qty": " 390320",
"depo_date": "2024/03/21 ~ 2024/04/21",
"depo_reason": "벤처금융",
"tot_issue_qty_per_rate": "369.3"
},
{
"sht_cd": "476180",
"isin_name": "마이공사",
"stk_qty": " 100000",
"depo_date": "2024/03/20 ~ 2024/09/20",
"depo_reason": "-",
"tot_issue_qty_per_rate": "2000."
},
{
"sht_cd": "082740",
"isin_name": "한화엔진 주식회사",
"stk_qty": " 11903148",
"depo_date": "2024/03/19 ~ 2025/03/19",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "1426."
},
{
"sht_cd": "214870",
"isin_name": "뉴지랩파마",
"stk_qty": " 13670000",
"depo_date": "2024/03/18 ~ 2025/03/18",
"depo_reason": "모집매출",
"tot_issue_qty_per_rate": "2921."
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,552 @@
# 국내주식 손익계산서
- 원본 시트명: 국내주식 손익계산서
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-079
- HTTP Method: GET
- 실전 TR_ID: FHKST66430200
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 없음
- URL 명: /uapi/domestic-stock/v1/finance/income-statement
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 손익계산서 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '2. 손익계산서' 기능을 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 | FHKST66430200 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기<br><br>※ 분기데이터는 연단위 누적합산 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| sale_account | 매출액 | string | Y | 18 | |
| sale_cost | 매출 원가 | string | Y | 182 | |
| sale_totl_prfi | 매출 총 이익 | string | Y | 182 | |
| depr_cost | 감가상각비 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| sell_mang | 판매 및 관리비 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| bsop_prti | 영업 이익 | string | Y | 182 | |
| bsop_non_ernn | 영업 외 수익 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| bsop_non_expn | 영업 외 비용 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| op_prfi | 경상 이익 | string | Y | 182 | |
| spec_prfi | 특별 이익 | string | Y | 182 | |
| spec_loss | 특별 손실 | string | Y | 182 | |
| thtr_ntin | 당기순이익 | string | Y | 102 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"sale_account": "2589355.00",
"sale_cost": "1803886.00",
"sale_totl_prfi": "785469",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "65670.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "110063.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "154871.00"
},
{
"stac_yymm": "202309",
"sale_account": "1911556.00",
"sale_cost": "1342731.00",
"sale_totl_prfi": "568825",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "37423.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "74820.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "91423.00"
},
{
"stac_yymm": "202306",
"sale_account": "1237509.00",
"sale_cost": "876543.00",
"sale_totl_prfi": "360966",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "13087.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "35394.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "32982.00"
},
{
"stac_yymm": "202303",
"sale_account": "637454.00",
"sale_cost": "460071.00",
"sale_totl_prfi": "177383",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "6402.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "18264.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "15746.00"
},
{
"stac_yymm": "202212",
"sale_account": "3022314.00",
"sale_cost": "1900418.00",
"sale_totl_prfi": "1121896",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "433766.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "464405.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "556541.00"
},
{
"stac_yymm": "202209",
"sale_account": "2317668.00",
"sale_cost": "1414141.00",
"sale_totl_prfi": "903527",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "390705.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "413856.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "318126.00"
},
{
"stac_yymm": "202206",
"sale_account": "1549851.00",
"sale_cost": "933418.00",
"sale_totl_prfi": "616433",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "282185.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "295306.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "224234.00"
},
{
"stac_yymm": "202203",
"sale_account": "777815.00",
"sale_cost": "470721.00",
"sale_totl_prfi": "307094",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "141214.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "150698.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "113246.00"
},
{
"stac_yymm": "202112",
"sale_account": "2796048.00",
"sale_cost": "1664113.00",
"sale_totl_prfi": "1131935",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "516339.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "533518.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "399075.00"
},
{
"stac_yymm": "202109",
"sale_account": "2030393.00",
"sale_cost": "1214648.00",
"sale_totl_prfi": "815745",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "377671.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "389889.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "290695.00"
},
{
"stac_yymm": "202106",
"sale_account": "1290601.00",
"sale_cost": "785659.00",
"sale_totl_prfi": "504942",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "219496.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "226331.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "167762.00"
},
{
"stac_yymm": "202103",
"sale_account": "653885.00",
"sale_cost": "415000.00",
"sale_totl_prfi": "238885",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "93829.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "97506.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "71417.00"
},
{
"stac_yymm": "202012",
"sale_account": "2368070.00",
"sale_cost": "1444883.00",
"sale_totl_prfi": "923187",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "359939.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "363451.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "264078.00"
},
{
"stac_yymm": "202009",
"sale_account": "1752555.00",
"sale_cost": "1066834.00",
"sale_totl_prfi": "685721",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "269469.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "273707.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "198007.00"
},
{
"stac_yymm": "202006",
"sale_account": "1082913.00",
"sale_cost": "667129.00",
"sale_totl_prfi": "415784",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "145936.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "145265.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "104400.00"
},
{
"stac_yymm": "202003",
"sale_account": "553252.00",
"sale_cost": "348067.00",
"sale_totl_prfi": "205185",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "64473.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "67569.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "48849.00"
},
{
"stac_yymm": "201912",
"sale_account": "2304009.00",
"sale_cost": "1472396.00",
"sale_totl_prfi": "831613",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "277685.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "304322.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "217389.00"
},
{
"stac_yymm": "201909",
"sale_account": "1705161.00",
"sale_cost": "1086850.00",
"sale_totl_prfi": "618311",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "206082.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "227131.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "165118.00"
},
{
"stac_yymm": "201906",
"sale_account": "1085127.00",
"sale_cost": "686912.00",
"sale_totl_prfi": "398215",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "128303.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "140923.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "102242.00"
},
{
"stac_yymm": "201903",
"sale_account": "523855.00",
"sale_cost": "327464.00",
"sale_totl_prfi": "196391",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "62333.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "69130.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "50436.00"
},
{
"stac_yymm": "201812",
"sale_account": "2437714.00",
"sale_cost": "1323944.00",
"sale_totl_prfi": "1113770",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "588867.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "611600.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "443449.00"
},
{
"stac_yymm": "201809",
"sale_account": "1845064.00",
"sale_cost": "983785.00",
"sale_totl_prfi": "861279",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "480861.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "495521.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "358827.00"
},
{
"stac_yymm": "201806",
"sale_account": "1190464.00",
"sale_cost": "631841.00",
"sale_totl_prfi": "558623",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "305112.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "315827.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "227320.00"
},
{
"stac_yymm": "201803",
"sale_account": "605637.00",
"sale_cost": "319095.00",
"sale_totl_prfi": "286542",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "156422.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "161759.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "116885.00"
},
{
"stac_yymm": "201712",
"sale_account": "2395754.00",
"sale_cost": "1292907.00",
"sale_totl_prfi": "1102847",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "536450.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "561960.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "421867.00"
},
{
"stac_yymm": "201709",
"sale_account": "1735970.00",
"sale_cost": "935596.00",
"sale_totl_prfi": "800374",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "384981.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "394916.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "299316.00"
},
{
"stac_yymm": "201706",
"sale_account": "1115481.00",
"sale_cost": "605555.00",
"sale_totl_prfi": "509926",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "239649.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "245768.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "187382.00"
},
{
"stac_yymm": "201703",
"sale_account": "505475.00",
"sale_cost": "281556.00",
"sale_totl_prfi": "223919",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "98984.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "101646.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "76844.00"
},
{
"stac_yymm": "201612",
"sale_account": "2018667.00",
"sale_cost": "1202777.00",
"sale_totl_prfi": "815890",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "292407.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "307137.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "227261.00"
},
{
"stac_yymm": "201609",
"sale_account": "1485350.00",
"sale_cost": "893942.00",
"sale_totl_prfi": "591408",
"depr_cost": "99.99",
"sell_mang": "99.99",
"bsop_prti": "200199.00",
"bsop_non_ernn": "99.99",
"bsop_non_expn": "99.99",
"op_prfi": "211651.00",
"spec_prfi": "99.99",
"spec_loss": "99.99",
"thtr_ntin": "156381.00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,224 @@
# 당사 대주가능 종목
- 원본 시트명: 당사 대주가능 종목
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-195
- HTTP Method: GET
- 실전 TR_ID: CTSC2702R
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/lendable-by-company
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
당사 대주가능 종목 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0490] 당사 대주가능 종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
※ 본 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 | CTSC2702R |
| 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 |
| --- | --- | --- | --- | --- | --- |
| EXCG_DVSN_CD | 거래소구분코드 | string | Y | 2 | 00(전체), 02(거래소), 03(코스닥) |
| PDNO | 상품번호 | string | Y | 12 | 공백 : 전체조회, 종목코드 입력 시 해당종목만 조회 |
| THCO_STLN_PSBL_YN | 당사대주가능여부 | string | Y | 1 | Y |
| INQR_DVSN_1 | 조회구분1 | string | Y | 1 | 0 : 전체조회, 1: 종목코드순 정렬 |
| CTX_AREA_FK200 | 연속조회검색조건200 | string | Y | 200 | 미입력 (다음조회 불가) |
| 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 | 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 array | Y | | array |
| pdno | 상품번호 | string | Y | 12 | |
| prdt_name | 상품명 | string | Y | 60 | |
| papr | 액면가 | string | Y | 19 | |
| bfdy_clpr | 전일종가 | string | Y | 19 | 전일종가 |
| sbst_prvs | 대용가 | string | Y | 19 | |
| tr_stop_dvsn_name | 거래정지구분명 | string | Y | 60 | |
| psbl_yn_name | 가능여부명 | string | Y | 60 | |
| lmt_qty1 | 한도수량1 | string | Y | 19 | |
| use_qty1 | 사용수량1 | string | Y | 19 | |
| trad_psbl_qty2 | 매매가능수량2 | string | Y | 19 | 가능수량 |
| rght_type_cd | 권리유형코드 | string | Y | 2 | |
| bass_dt | 기준일자 | string | Y | 8 | |
| psbl_yn | 가능여부 | string | Y | 1 | |
| output2 | 응답상세 | object | Y | | |
| tot_stup_lmt_qty | 총설정한도수량 | string | Y | 19 | |
| brch_lmt_qty | 지점한도수량 | string | Y | 19 | |
| rqst_psbl_qty | 신청가능수량 | string | Y | 19 | |
## 예제
### Request Example (Python)
```text
EXCG_DVSN_CD:00
PDNO:
THCO_STLN_PSBL_YN:Y
INQR_DVSN_1:0
CTX_AREA_FK200:
CTX_AREA_NK100:
```
### Response Example
```text
{
"ctx_area_fk200": "00!^!^Y!^0 ",
"ctx_area_nk100": " ",
"output1": [
{
"pdno": "130960",
"prdt_name": "CJ E&M",
"papr": "5000",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "10520",
"use_qty1": "0",
"trad_psbl_qty2": "10520",
"rght_type_cd": "11",
"bass_dt": "20180629",
"psbl_yn": "Y"
},
{
"pdno": "110550",
"prdt_name": "HIT 골드",
"papr": "0",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "32",
"bass_dt": "20111222",
"psbl_yn": "Y"
},
{
"pdno": "124090",
"prdt_name": "HIT 보험",
"papr": "0",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "32",
"bass_dt": "20111219",
"psbl_yn": "Y"
},
{
"pdno": "002550",
"prdt_name": "KB손해보험",
"papr": "500",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "13",
"bass_dt": "20170706",
"psbl_yn": "Y"
},
{
"pdno": "021960",
"prdt_name": "KB캐피탈",
"papr": "5000",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "13",
"bass_dt": "20170706",
"psbl_yn": "Y"
},
{
"pdno": "105270",
"prdt_name": "KINDEX 성장대형F15",
"papr": "0",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "32",
"bass_dt": "20140430",
"psbl_yn": "Y"
},...
{
"pdno": "003450",
"prdt_name": "현대증권",
"papr": "5000",
"bfdy_clpr": "0",
"sbst_prvs": "0",
"tr_stop_dvsn_name": "거래정지",
"psbl_yn_name": "가능",
"lmt_qty1": "0",
"use_qty1": "0",
"trad_psbl_qty2": "0",
"rght_type_cd": "13",
"bass_dt": "20161018",
"psbl_yn": "Y"
}
],
"output2": {
"tot_stup_lmt_qty": "6441070",
"brch_lmt_qty": "-1228",
"rqst_psbl_qty": "6442095"
},
"rt_cd": "0",
"msg_cd": "KIOK0460",
"msg1": "조회 되었습니다. (마지막 자료) "
}
```
File diff suppressed because one or more lines are too long
@@ -0,0 +1,181 @@
# 예탁원정보(유상증자일정)
- 원본 시트명: 예탁원정보(유상증자일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-143
- HTTP Method: GET
- 실전 TR_ID: HHKDB669100C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/paidin-capin
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(유상증자일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0655] 유상증자 화면의 기능을 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 | HHKDB669100C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| CTS | CTS | string | Y | 17 | 공백 |
| GB1 | 조회구분 | string | Y | 1 | 1(청약일별), 2(기준일별) |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| SHT_CD | 종목코드 | string | Y | 9 | 공백(전체), 특정종목 조회시(종목코드) |
### 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
| issue_stk_qty | 발행할주식 | string | Y | 12 | |
| fix_rate | 확정배정율 | string | Y | 152 | |
| disc_rate | 할인율 | string | Y | 52 | |
| fix_price | 발행예정가 | string | Y | 8 | |
| right_dt | 권리락일 | string | Y | 8 | |
| sub_term_ft | 청약기간 | string | Y | 8 | |
| sub_term | 청약기간 | string | Y | 23 | |
| list_date | 상장/등록일 | string | Y | 10 | |
| stk_kind | 주식종류 | string | Y | 2 | |
## 예제
### Request Example (Python)
```text
cts:
gb1:1
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240222",
"sht_cd": "426530",
"isin_name": "메타록",
"tot_issue_stk_qty": " 31000000",
"issue_stk_qty": " 273199",
"fix_rate": " 20.00",
"disc_rate": " 0.00",
"fix_price": " 500",
"right_dt": "20240221",
"sub_term_ft": "20240325",
"sub_term": "2024/03/25 ~ 2024/03/26",
"list_date": "",
"stk_kind": "01"
},
{
"record_date": "20240219",
"sht_cd": "429850",
"isin_name": "애딥",
"tot_issue_stk_qty": " 755400",
"issue_stk_qty": " 1680196",
"fix_rate": "397.14",
"disc_rate": " 0.00",
"fix_price": " 500",
"right_dt": "20240216",
"sub_term_ft": "20240319",
"sub_term": "2024/03/19 ~ 2024/03/20",
"list_date": "",
"stk_kind": "01"
},
{
"record_date": "20240213",
"sht_cd": "321850",
"isin_name": "나이스엘엠에스",
"tot_issue_stk_qty": " 22826013",
"issue_stk_qty": " 5337064",
"fix_rate": " 44.95",
"disc_rate": " 0.00",
"fix_price": " 6000",
"right_dt": "20240208",
"sub_term_ft": "20240318",
"sub_term": "2024/03/18 ~ 2024/03/18",
"list_date": "",
"stk_kind": "01"
},
{
"record_date": "20240216",
"sht_cd": "225340",
"isin_name": "메디셀",
"tot_issue_stk_qty": " 10085593",
"issue_stk_qty": " 1058677",
"fix_rate": " 29.70",
"disc_rate": " 0.00",
"fix_price": " 1000",
"right_dt": "20240215",
"sub_term_ft": "20240314",
"sub_term": "2024/03/14 ~ 2024/03/15",
"list_date": "",
"stk_kind": "01"
},
{
"record_date": "20240131",
"sht_cd": "001440",
"isin_name": "대한전선",
"tot_issue_stk_qty": " 124447300",
"issue_stk_qty": " 62000000",
"fix_rate": " 50.13",
"disc_rate": " 0.00",
"fix_price": " 7460",
"right_dt": "20240130",
"sub_term_ft": "20240311",
"sub_term": "2024/03/11 ~ 2024/03/12",
"list_date": "2024/04/02",
"stk_kind": "01"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,278 @@
# 예탁원정보(주주총회일정)
- 원본 시트명: 예탁원정보(주주총회일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-154
- HTTP Method: GET
- 실전 TR_ID: HHKDB669111C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/sharehld-meet
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(주주총회일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0759] 주주총회 화면의 기능을 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 | HHKDB669111C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| CTS | CTS | string | Y | 17 | 공백 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
### 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| isin_name | 종목명 | string | Y | 40 | |
| gen_meet_dt | 주총일자 | string | Y | 10 | |
| gen_meet_type | 주총사유 | string | Y | 8 | |
| agenda | 주총의안 | string | Y | 71 | |
| vote_tot_qty | 의결권주식총수 | string | Y | 12 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230101
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240322",
"sht_cd": "388370",
"isin_name": "(주)우앤컴퍼니",
"gen_meet_dt": "2024/04/18",
"gen_meet_type": "임시총회",
"agenda": "정관변경",
"vote_tot_qty": " 959800"
},
{
"record_date": "20240322",
"sht_cd": "388370",
"isin_name": "(주)우앤컴퍼니",
"gen_meet_dt": "2024/04/18",
"gen_meet_type": "임시총회",
"agenda": "이사선임",
"vote_tot_qty": " 959800"
},
{
"record_date": "20240321",
"sht_cd": "323530",
"isin_name": "(주)아이월드제약",
"gen_meet_dt": "2024/04/25",
"gen_meet_type": "임시총회",
"agenda": "사내이사 선임",
"vote_tot_qty": " 25721999"
},
{
"record_date": "20240321",
"sht_cd": "323530",
"isin_name": "(주)아이월드제약",
"gen_meet_dt": "2024/04/25",
"gen_meet_type": "임시총회",
"agenda": "정관변경",
"vote_tot_qty": " 25721999"
},
{
"record_date": "20240321",
"sht_cd": "323530",
"isin_name": "(주)아이월드제약",
"gen_meet_dt": "2024/04/25",
"gen_meet_type": "임시총회",
"agenda": "사외이사 선임",
"vote_tot_qty": " 25721999"
},
{
"record_date": "20240315",
"sht_cd": "091090",
"isin_name": "세원이앤씨(주)",
"gen_meet_dt": "2024/04/12",
"gen_meet_type": "임시총회",
"agenda": "이사해임(주주제안)",
"vote_tot_qty": " 52754723"
},
{
"record_date": "20240315",
"sht_cd": "091090",
"isin_name": "세원이앤씨(주)",
"gen_meet_dt": "2024/04/12",
"gen_meet_type": "임시총회",
"agenda": "정관변경(주주제안)",
"vote_tot_qty": " 52754723"
},
{
"record_date": "20240315",
"sht_cd": "091090",
"isin_name": "세원이앤씨(주)",
"gen_meet_dt": "2024/04/12",
"gen_meet_type": "임시총회",
"agenda": "이사해임(주주제안)",
"vote_tot_qty": " 52754723"
},
{
"record_date": "20240315",
"sht_cd": "091090",
"isin_name": "세원이앤씨(주)",
"gen_meet_dt": "2024/04/12",
"gen_meet_type": "임시총회",
"agenda": "사외이사 선임(주주제안)",
"vote_tot_qty": " 52754723"
},
{
"record_date": "20240315",
"sht_cd": "091090",
"isin_name": "세원이앤씨(주)",
"gen_meet_dt": "2024/04/12",
"gen_meet_type": "임시총회",
"agenda": "사내이사 선임(주주제안)",
"vote_tot_qty": " 52754723"
},
{
"record_date": "20240312",
"sht_cd": "380440",
"isin_name": "엔에이치기업인수목적19호(주)",
"gen_meet_dt": "2024/04/19",
"gen_meet_type": "임시총회",
"agenda": "청산결산보고서승인",
"vote_tot_qty": " 10258000"
},
{
"record_date": "20240308",
"sht_cd": "263540",
"isin_name": "(주)어스앤에어로스페이스",
"gen_meet_dt": "2024/04/03",
"gen_meet_type": "임시총회",
"agenda": "사내이사 선임",
"vote_tot_qty": " 14294091"
},
{
"record_date": "20240308",
"sht_cd": "263540",
"isin_name": "(주)어스앤에어로스페이스",
"gen_meet_dt": "2024/04/03",
"gen_meet_type": "임시총회",
"agenda": "사내이사 선임",
"vote_tot_qty": " 14294091"
},
{
"record_date": "20240308",
"sht_cd": "263540",
"isin_name": "(주)어스앤에어로스페이스",
"gen_meet_dt": "2024/04/03",
"gen_meet_type": "임시총회",
"agenda": "정관변경",
"vote_tot_qty": " 14294091"
},
{
"record_date": "20240308",
"sht_cd": "263540",
"isin_name": "(주)어스앤에어로스페이스",
"gen_meet_dt": "2024/04/03",
"gen_meet_type": "임시총회",
"agenda": "사내이사 선임",
"vote_tot_qty": " 14294091"
},
{
"record_date": "20240308",
"sht_cd": "263540",
"isin_name": "(주)어스앤에어로스페이스",
"gen_meet_dt": "2024/04/03",
"gen_meet_type": "임시총회",
"agenda": "사외이사 선임",
"vote_tot_qty": " 14294091"
},
{
"record_date": "20240308",
"sht_cd": "343990",
"isin_name": "비즈플레이(주)",
"gen_meet_dt": "2024/03/27",
"gen_meet_type": "종류총회",
"agenda": "정관변경",
"vote_tot_qty": " 21751896"
},
{
"record_date": "20240307",
"sht_cd": "001140",
"isin_name": "(주)국보",
"gen_meet_dt": "2024/04/26",
"gen_meet_type": "정기총회",
"agenda": "사내이사 선임",
"vote_tot_qty": " 13691728"
},
{
"record_date": "20240307",
"sht_cd": "001140",
"isin_name": "(주)국보",
"gen_meet_dt": "2024/04/26",
"gen_meet_type": "정기총회",
"agenda": "감사선임",
"vote_tot_qty": " 13691728"
},
{
"record_date": "20240307",
"sht_cd": "001140",
"isin_name": "(주)국보",
"gen_meet_dt": "2024/04/26",
"gen_meet_type": "정기총회",
"agenda": "이사 보수한도액 승인",
"vote_tot_qty": " 13691728"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,304 @@
# 국내주식 성장성비율
- 원본 시트명: 국내주식 성장성비율
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-085
- HTTP Method: GET
- 실전 TR_ID: FHKST66430800
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/growth-ratio
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 성장성비율 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '7.성장성비율' 기능을 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 | FHKST66430800 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | ex : 000660 |
| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| grs | 매출액 증가율 | string | Y | 124 | |
| bsop_prfi_inrt | 영업 이익 증가율 | string | Y | 124 | |
| equt_inrt | 자기자본 증가율 | string | Y | 92 | |
| totl_aset_inrt | 총자산 증가율 | string | Y | 92 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"grs": "-14.33",
"bsop_prfi_inrt": "-84.86",
"equt_inrt": "2.52",
"totl_aset_inrt": "1.67"
},
{
"stac_yymm": "202309",
"grs": "-17.52",
"bsop_prfi_inrt": "-90.42",
"equt_inrt": "5.50",
"totl_aset_inrt": "-3.36"
},
{
"stac_yymm": "202306",
"grs": "-20.15",
"bsop_prfi_inrt": "-95.36",
"equt_inrt": "9.47",
"totl_aset_inrt": "-0.01"
},
{
"stac_yymm": "202303",
"grs": "-18.05",
"bsop_prfi_inrt": "-95.47",
"equt_inrt": "14.12",
"totl_aset_inrt": "3.36"
},
{
"stac_yymm": "202212",
"grs": "8.09",
"bsop_prfi_inrt": "-15.99",
"equt_inrt": "16.35",
"totl_aset_inrt": "5.11"
},
{
"stac_yymm": "202209",
"grs": "14.15",
"bsop_prfi_inrt": "3.45",
"equt_inrt": "16.22",
"totl_aset_inrt": "14.58"
},
{
"stac_yymm": "202206",
"grs": "20.09",
"bsop_prfi_inrt": "28.56",
"equt_inrt": "16.15",
"totl_aset_inrt": "16.44"
},
{
"stac_yymm": "202203",
"grs": "18.95",
"bsop_prfi_inrt": "50.50",
"equt_inrt": "14.96",
"totl_aset_inrt": "11.84"
},
{
"stac_yymm": "202112",
"grs": "18.07",
"bsop_prfi_inrt": "43.45",
"equt_inrt": "10.49",
"totl_aset_inrt": "12.79"
},
{
"stac_yymm": "202109",
"grs": "15.85",
"bsop_prfi_inrt": "40.15",
"equt_inrt": "7.47",
"totl_aset_inrt": "9.22"
},
{
"stac_yymm": "202106",
"grs": "19.18",
"bsop_prfi_inrt": "50.41",
"equt_inrt": "4.64",
"totl_aset_inrt": "7.49"
},
{
"stac_yymm": "202103",
"grs": "18.19",
"bsop_prfi_inrt": "45.53",
"equt_inrt": "2.96",
"totl_aset_inrt": "9.89"
},
{
"stac_yymm": "202012",
"grs": "2.78",
"bsop_prfi_inrt": "29.62",
"equt_inrt": "4.97",
"totl_aset_inrt": "7.28"
},
{
"stac_yymm": "202009",
"grs": "2.78",
"bsop_prfi_inrt": "30.76",
"equt_inrt": "4.82",
"totl_aset_inrt": "6.34"
},
{
"stac_yymm": "202006",
"grs": "-0.20",
"bsop_prfi_inrt": "13.74",
"equt_inrt": "4.68",
"totl_aset_inrt": "4.38"
},
{
"stac_yymm": "202003",
"grs": "5.61",
"bsop_prfi_inrt": "3.43",
"equt_inrt": "5.20",
"totl_aset_inrt": "3.59"
},
{
"stac_yymm": "201912",
"grs": "-5.48",
"bsop_prfi_inrt": "-52.84",
"equt_inrt": "6.11",
"totl_aset_inrt": "3.89"
},
{
"stac_yymm": "201909",
"grs": "-7.58",
"bsop_prfi_inrt": "-57.14",
"equt_inrt": "8.81",
"totl_aset_inrt": "4.80"
},
{
"stac_yymm": "201906",
"grs": "-8.85",
"bsop_prfi_inrt": "-57.95",
"equt_inrt": "10.56",
"totl_aset_inrt": "7.61"
},
{
"stac_yymm": "201903",
"grs": "-13.50",
"bsop_prfi_inrt": "-60.15",
"equt_inrt": "13.42",
"totl_aset_inrt": "10.43"
},
{
"stac_yymm": "201812",
"grs": "1.75",
"bsop_prfi_inrt": "9.77",
"equt_inrt": "15.51",
"totl_aset_inrt": "12.46"
},
{
"stac_yymm": "201809",
"grs": "6.28",
"bsop_prfi_inrt": "24.91",
"equt_inrt": "14.91",
"totl_aset_inrt": "13.70"
},
{
"stac_yymm": "201806",
"grs": "6.72",
"bsop_prfi_inrt": "27.32",
"equt_inrt": "16.15",
"totl_aset_inrt": "14.81"
},
{
"stac_yymm": "201803",
"grs": "19.82",
"bsop_prfi_inrt": "58.03",
"equt_inrt": "17.62",
"totl_aset_inrt": "18.26"
},
{
"stac_yymm": "201712",
"grs": "18.68",
"bsop_prfi_inrt": "83.46",
"equt_inrt": "11.16",
"totl_aset_inrt": "15.10"
},
{
"stac_yymm": "201709",
"grs": "16.87",
"bsop_prfi_inrt": "92.30",
"equt_inrt": "17.35",
"totl_aset_inrt": "21.31"
},
{
"stac_yymm": "201706",
"grs": "10.75",
"bsop_prfi_inrt": "61.71",
"equt_inrt": "10.37",
"totl_aset_inrt": "13.78"
},
{
"stac_yymm": "201703",
"grs": "1.54",
"bsop_prfi_inrt": "48.27",
"equt_inrt": "6.44",
"totl_aset_inrt": "9.52"
},
{
"stac_yymm": "201612",
"grs": "0.60",
"bsop_prfi_inrt": "10.70",
"equt_inrt": "7.76",
"totl_aset_inrt": "8.26"
},
{
"stac_yymm": "201609",
"grs": "0.81",
"bsop_prfi_inrt": "-1.24",
"equt_inrt": "-0.66",
"totl_aset_inrt": "-0.85"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,490 @@
# 국내주식 대차대조표
- 원본 시트명: 국내주식 대차대조표
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-078
- HTTP Method: GET
- 실전 TR_ID: FHKST66430100
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/balance-sheet
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 대차대조표 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '1. 대차대조표' 기능을 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 | FHKST66430100 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| FID_DIV_CLS_CODE | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| cras | 유동자산 | string | Y | 112 | |
| fxas | 고정자산 | string | Y | 112 | |
| total_aset | 자산총계 | string | Y | 102 | |
| flow_lblt | 유동부채 | string | Y | 112 | |
| fix_lblt | 고정부채 | string | Y | 112 | |
| total_lblt | 부채총계 | string | Y | 102 | |
| cpfn | 자본금 | string | Y | 22 | |
| cfp_surp | 자본 잉여금 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| prfi_surp | 이익 잉여금 | string | Y | 182 | 출력되지 않는 데이터(99.99 로 표시) |
| total_cptl | 자본총계 | string | Y | 102 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202312",
"cras": "1959366.00",
"fxas": "2599694.00",
"total_aset": "4559060.00",
"flow_lblt": "757195.00",
"fix_lblt": "165087.00",
"total_lblt": "922281.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3636779.00"
},
{
"stac_yymm": "202309",
"cras": "2064386.00",
"fxas": "2480278.00",
"total_aset": "4544664.00",
"flow_lblt": "736252.00",
"fix_lblt": "169486.00",
"total_lblt": "905738.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3638926.00"
},
{
"stac_yymm": "202306",
"cras": "2039754.00",
"fxas": "2440252.00",
"total_aset": "4480006.00",
"flow_lblt": "707806.00",
"fix_lblt": "182443.00",
"total_lblt": "890249.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3589756.00"
},
{
"stac_yymm": "202303",
"cras": "2144421.00",
"fxas": "2396496.00",
"total_aset": "4540918.00",
"flow_lblt": "760574.00",
"fix_lblt": "182349.00",
"total_lblt": "942924.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3597994.00"
},
{
"stac_yymm": "202212",
"cras": "2184706.00",
"fxas": "2299539.00",
"total_aset": "4484245.00",
"flow_lblt": "783449.00",
"fix_lblt": "153301.00",
"total_lblt": "936749.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3547496.00"
},
{
"stac_yymm": "202209",
"cras": "2508806.00",
"fxas": "2193978.00",
"total_aset": "4702784.00",
"flow_lblt": "852857.00",
"fix_lblt": "400859.00",
"total_lblt": "1253715.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3449069.00"
},
{
"stac_yymm": "202206",
"cras": "2362875.00",
"fxas": "2117532.00",
"total_aset": "4480407.00",
"flow_lblt": "833623.00",
"fix_lblt": "367717.00",
"total_lblt": "1201340.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3279067.00"
},
{
"stac_yymm": "202203",
"cras": "2323691.00",
"fxas": "2069579.00",
"total_aset": "4393270.00",
"flow_lblt": "904637.00",
"fix_lblt": "335723.00",
"total_lblt": "1240360.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3152909.00"
},
{
"stac_yymm": "202112",
"cras": "2181632.00",
"fxas": "2084580.00",
"total_aset": "4266212.00",
"flow_lblt": "881171.00",
"fix_lblt": "336041.00",
"total_lblt": "1217212.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "3048999.00"
},
{
"stac_yymm": "202109",
"cras": "2127930.00",
"fxas": "1976277.00",
"total_aset": "4104207.00",
"flow_lblt": "818720.00",
"fix_lblt": "317826.00",
"total_lblt": "1136546.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2967661.00"
},
{
"stac_yymm": "202106",
"cras": "1911185.00",
"fxas": "1936591.00",
"total_aset": "3847777.00",
"flow_lblt": "724615.00",
"fix_lblt": "299920.00",
"total_lblt": "1024534.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2823243.00"
},
{
"stac_yymm": "202103",
"cras": "2091554.00",
"fxas": "1836709.00",
"total_aset": "3928263.00",
"flow_lblt": "901095.00",
"fix_lblt": "284482.00",
"total_lblt": "1185577.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2742686.00"
},
{
"stac_yymm": "202012",
"cras": "1982156.00",
"fxas": "1800201.00",
"total_aset": "3782357.00",
"flow_lblt": "756044.00",
"fix_lblt": "266834.00",
"total_lblt": "1022877.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2759480.00"
},
{
"stac_yymm": "202009",
"cras": "2036349.00",
"fxas": "1721538.00",
"total_aset": "3757887.00",
"flow_lblt": "730464.00",
"fix_lblt": "266061.00",
"total_lblt": "996526.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2761362.00"
},
{
"stac_yymm": "202006",
"cras": "1861368.00",
"fxas": "1718227.00",
"total_aset": "3579595.00",
"flow_lblt": "618637.00",
"fix_lblt": "262880.00",
"total_lblt": "881517.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2698078.00"
},
{
"stac_yymm": "202003",
"cras": "1867397.00",
"fxas": "1707178.00",
"total_aset": "3574575.00",
"flow_lblt": "647633.00",
"fix_lblt": "263065.00",
"total_lblt": "910698.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2663877.00"
},
{
"stac_yymm": "201912",
"cras": "1813853.00",
"fxas": "1711792.00",
"total_aset": "3525645.00",
"flow_lblt": "637828.00",
"fix_lblt": "259013.00",
"total_lblt": "896841.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2628804.00"
},
{
"stac_yymm": "201909",
"cras": "1860421.00",
"fxas": "1673439.00",
"total_aset": "3533860.00",
"flow_lblt": "633032.00",
"fix_lblt": "266405.00",
"total_lblt": "899437.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2634422.00"
},
{
"stac_yymm": "201906",
"cras": "1734335.00",
"fxas": "1695067.00",
"total_aset": "3429401.00",
"flow_lblt": "593093.00",
"fix_lblt": "258838.00",
"total_lblt": "851931.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2577470.00"
},
{
"stac_yymm": "201903",
"cras": "1773885.00",
"fxas": "1676794.00",
"total_aset": "3450679.00",
"flow_lblt": "673541.00",
"fix_lblt": "244986.00",
"total_lblt": "918527.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2532152.00"
},
{
"stac_yymm": "201812",
"cras": "1746974.00",
"fxas": "1646598.00",
"total_aset": "3393572.00",
"flow_lblt": "690815.00",
"fix_lblt": "225226.00",
"total_lblt": "916041.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2477532.00"
},
{
"stac_yymm": "201809",
"cras": "1762820.00",
"fxas": "1609137.00",
"total_aset": "3371958.00",
"flow_lblt": "747059.00",
"fix_lblt": "203868.00",
"total_lblt": "950926.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2421032.00"
},
{
"stac_yymm": "201806",
"cras": "1569768.00",
"fxas": "1617115.00",
"total_aset": "3186884.00",
"flow_lblt": "656023.00",
"fix_lblt": "199612.00",
"total_lblt": "855635.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2331248.00"
},
{
"stac_yymm": "201803",
"cras": "1549420.00",
"fxas": "1575312.00",
"total_aset": "3124731.00",
"flow_lblt": "682986.00",
"fix_lblt": "209146.00",
"total_lblt": "892132.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2232599.00"
},
{
"stac_yymm": "201712",
"cras": "1469825.00",
"fxas": "1547696.00",
"total_aset": "3017521.00",
"flow_lblt": "671751.00",
"fix_lblt": "200855.00",
"total_lblt": "872607.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2144914.00"
},
{
"stac_yymm": "201709",
"cras": "1453223.00",
"fxas": "1512562.00",
"total_aset": "2965786.00",
"flow_lblt": "661726.00",
"fix_lblt": "197147.00",
"total_lblt": "858873.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2106913.00"
},
{
"stac_yymm": "201706",
"cras": "1321727.00",
"fxas": "1454168.00",
"total_aset": "2775894.00",
"flow_lblt": "584684.00",
"fix_lblt": "184153.00",
"total_lblt": "768837.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "2007057.00"
},
{
"stac_yymm": "201703",
"cras": "1292842.00",
"fxas": "1349332.00",
"total_aset": "2642174.00",
"flow_lblt": "568431.00",
"fix_lblt": "175563.00",
"total_lblt": "743994.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "1898180.00"
},
{
"stac_yymm": "201612",
"cras": "1414297.00",
"fxas": "1207446.00",
"total_aset": "2621743.00",
"flow_lblt": "547041.00",
"fix_lblt": "145072.00",
"total_lblt": "692113.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "1929630.00"
},
{
"stac_yymm": "201609",
"cras": "1321668.00",
"fxas": "1123047.00",
"total_aset": "2444715.00",
"flow_lblt": "504595.00",
"fix_lblt": "144756.00",
"total_lblt": "649351.00",
"cpfn": "8975",
"cfp_surp": "99.99",
"prfi_surp": "99.99",
"total_cptl": "1795364.00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,953 @@
# 예탁원정보(합병_분할일정)
- 원본 시트명: 예탁원정보(합병_분할일정)
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-147
- HTTP Method: GET
- 실전 TR_ID: HHKDB669104C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/ksdinfo/merger-split
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
예탁원정보(합병/분할일정) API입니다.
한국투자 HTS(eFriend Plus) &gt; [0664] 합병/분할 화면의 기능을 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 | HHKDB669104C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| CTS | CTS | string | Y | 17 | 공백 |
| F_DT | 조회일자From | string | Y | 8 | 일자 ~ |
| T_DT | 조회일자To | string | Y | 8 | ~ 일자 |
| SHT_CD | 종목코드 | string | Y | 9 | 공백: 전체, 특정종목 조회시 : 종목코드 |
### 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 array | Y | | array |
| record_date | 기준일 | string | Y | 8 | |
| sht_cd | 종목코드 | string | Y | 9 | |
| opp_cust_cd | 피합병(피분할)회사코드 | string | Y | 5 | |
| opp_cust_nm | 피합병(피분할)회사명 | string | Y | 37 | |
| cust_cd | 합병(분할)회사코드 | string | Y | 5 | |
| cust_nm | 합병(분할)회사명 | string | Y | 37 | |
| merge_type | 합병사유 | string | Y | 8 | |
| merge_rate | 비율 | string | Y | 142 | |
| td_stop_dt | 매매거래정지기간 | string | Y | 23 | |
| list_dt | 상장/등록일 | string | Y | 9 | |
| odd_amt_pay_dt | 단주대금지급일 | string | Y | 10 | |
| tot_issue_stk_qty | 발행주식 | string | Y | 12 | |
| issue_stk_qty | 발행할주식 | string | Y | 12 | |
| seq | 연번 | string | Y | 3 | |
## 예제
### Request Example (Python)
```text
cts:
f_dt:20230301
t_dt:20240326
sht_cd:
```
### Response Example
```text
{
"output1": [
{
"record_date": "20240311",
"sht_cd": "224020",
"opp_cust_cd": "22402",
"opp_cust_nm": "에스케이씨에스",
"cust_cd": "17735",
"cust_nm": "베셀",
"merge_type": "흡수합병",
"merge_rate": " 0.66",
"td_stop_dt": "2024/03/08 ~ 2024/03/28",
"list_dt": "20240329",
"odd_amt_pay_dt": "2024/04/05",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240305",
"sht_cd": "397880",
"opp_cust_cd": "39788",
"opp_cust_nm": "교보11호기업인수목적",
"cust_cd": "42057",
"cust_nm": "제이투케이바이오",
"merge_type": "흡수합병",
"merge_rate": " 0.12",
"td_stop_dt": "2024/03/04 ~",
"list_dt": "20240325",
"odd_amt_pay_dt": "2024/04/01",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240229",
"sht_cd": "210980",
"opp_cust_cd": "21098",
"opp_cust_nm": "에스케이디앤디",
"cust_cd": "47515",
"cust_nm": "에스케이이터닉스",
"merge_type": "회사분할",
"merge_rate": " 1.15",
"td_stop_dt": "2024/02/28 ~ 2024/03/28",
"list_dt": "20240329",
"odd_amt_pay_dt": "2024/04/05",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240229",
"sht_cd": "21098L",
"opp_cust_cd": "21098",
"opp_cust_nm": "에스케이디앤디",
"cust_cd": "21098",
"cust_nm": "에스케이디앤디",
"merge_type": "회사분할",
"merge_rate": " 0.77",
"td_stop_dt": "2024/02/28 ~ 2024/03/28",
"list_dt": "20240329",
"odd_amt_pay_dt": "2024/04/05",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240228",
"sht_cd": "072700",
"opp_cust_cd": "07270",
"opp_cust_nm": "더존홀딩스",
"cust_cd": "01251",
"cust_nm": "더존비즈온",
"merge_type": "흡수합병",
"merge_rate": "834.0",
"td_stop_dt": "2024/02/27 ~ 2024/03/21",
"list_dt": "20240322",
"odd_amt_pay_dt": "2024/03/29",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240228",
"sht_cd": "452240",
"opp_cust_cd": "45224",
"opp_cust_nm": "뉴온",
"cust_cd": "12384",
"cust_nm": "뉴온",
"merge_type": "흡수합병",
"merge_rate": "24.52",
"td_stop_dt": "",
"list_dt": "20240325",
"odd_amt_pay_dt": "2024/04/02",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240213",
"sht_cd": "001880",
"opp_cust_cd": "00188",
"opp_cust_nm": "디엘건설",
"cust_cd": "37550",
"cust_nm": "디엘이앤씨",
"merge_type": "주식교환",
"merge_rate": " 0.37",
"td_stop_dt": "2024/02/08 ~ 2024/03/03",
"list_dt": "20240304",
"odd_amt_pay_dt": "2024/03/12",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240213",
"sht_cd": "00188K",
"opp_cust_cd": "00188",
"opp_cust_nm": "디엘건설",
"cust_cd": "00188",
"cust_nm": "디엘건설",
"merge_type": "주식교환",
"merge_rate": " 1.00",
"td_stop_dt": "2024/02/08 ~ 2024/03/03",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240213",
"sht_cd": "115960",
"opp_cust_cd": "11596",
"opp_cust_nm": "연우",
"cust_cd": "16189",
"cust_nm": "한국콜마",
"merge_type": "주식교환",
"merge_rate": " 0.29",
"td_stop_dt": "2024/02/08 ~ 2024/03/05",
"list_dt": "20240306",
"odd_amt_pay_dt": "2024/03/13",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240130",
"sht_cd": "183410",
"opp_cust_cd": "18341",
"opp_cust_nm": "골프존데카",
"cust_cd": "21500",
"cust_nm": "골프존",
"merge_type": "주식교환",
"merge_rate": " 0.01",
"td_stop_dt": "2024/01/29 ~ 2024/02/21",
"list_dt": "20240222",
"odd_amt_pay_dt": "2024/02/28",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240123",
"sht_cd": "372290",
"opp_cust_cd": "37229",
"opp_cust_nm": "하나머스트7호기업인수목적",
"cust_cd": "45243",
"cust_nm": "사피엔반도체",
"merge_type": "흡수합병",
"merge_rate": " 0.13",
"td_stop_dt": "2024/01/22 ~",
"list_dt": "20240219",
"odd_amt_pay_dt": "2024/02/23",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240122",
"sht_cd": "426550",
"opp_cust_cd": "42655",
"opp_cust_nm": "아이비케이에스제19호기업인수목적",
"cust_cd": "44367",
"cust_nm": "에스피소프트",
"merge_type": "흡수합병",
"merge_rate": " 0.62",
"td_stop_dt": "2024/01/19 ~",
"list_dt": "20240215",
"odd_amt_pay_dt": "2024/02/22",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240115",
"sht_cd": "068400",
"opp_cust_cd": "06840",
"opp_cust_nm": "에스케이렌터카",
"cust_cd": "06840",
"cust_nm": "에스케이렌터카",
"merge_type": "주식교환",
"merge_rate": " 1.00",
"td_stop_dt": "2024/01/12 ~ 2024/01/30",
"list_dt": "20240131",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240115",
"sht_cd": "427950",
"opp_cust_cd": "42795",
"opp_cust_nm": "하나금융23호기업인수목적",
"cust_cd": "19955",
"cust_nm": "레이저옵텍",
"merge_type": "흡수합병",
"merge_rate": " 0.23",
"td_stop_dt": "2024/01/12 ~",
"list_dt": "20240201",
"odd_amt_pay_dt": "2024/02/07",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20240108",
"sht_cd": "377400",
"opp_cust_cd": "37740",
"opp_cust_nm": "하이제6호기업인수목적",
"cust_cd": "36299",
"cust_nm": "드림인사이트",
"merge_type": "흡수합병",
"merge_rate": " 0.37",
"td_stop_dt": "2024/01/05 ~",
"list_dt": "20240125",
"odd_amt_pay_dt": "2024/02/02",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231227",
"sht_cd": "033290",
"opp_cust_cd": "03329",
"opp_cust_nm": "코웰패션",
"cust_cd": "47285",
"cust_nm": "폰드그룹",
"merge_type": "회사분할",
"merge_rate": " 0.37",
"td_stop_dt": "2023/12/26 ~ 2024/02/01",
"list_dt": "20240202",
"odd_amt_pay_dt": "2024/02/08",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231219",
"sht_cd": "091990",
"opp_cust_cd": "09199",
"opp_cust_nm": "셀트리온헬스케어",
"cust_cd": "06827",
"cust_nm": "셀트리온",
"merge_type": "흡수합병",
"merge_rate": " 0.45",
"td_stop_dt": "2023/12/18 ~ 2024/01/11",
"list_dt": "20240112",
"odd_amt_pay_dt": "2024/02/08",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231211",
"sht_cd": "404950",
"opp_cust_cd": "40495",
"opp_cust_nm": "디비금융제10호기업인수목적",
"cust_cd": "45219",
"cust_nm": "한빛레이저",
"merge_type": "흡수합병",
"merge_rate": " 0.65",
"td_stop_dt": "2023/12/08 ~",
"list_dt": "20240104",
"odd_amt_pay_dt": "2024/01/11",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231204",
"sht_cd": "450410",
"opp_cust_cd": "45041",
"opp_cust_nm": "엔에이치기업인수목적28호",
"cust_cd": "10967",
"cust_nm": "씨싸이트",
"merge_type": "흡수합병",
"merge_rate": " 0.18",
"td_stop_dt": "2023/12/01 ~",
"list_dt": "20231221",
"odd_amt_pay_dt": "2023/12/28",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231203",
"sht_cd": "046140",
"opp_cust_cd": "04614",
"opp_cust_nm": "에스비에스콘텐츠허브",
"cust_cd": "04614",
"cust_nm": "에스비에스콘텐츠허브",
"merge_type": "주식교환",
"merge_rate": " 1.00",
"td_stop_dt": "2023/11/30 ~ 2023/12/17",
"list_dt": "",
"odd_amt_pay_dt": "2023/12/26",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231107",
"sht_cd": "173200",
"opp_cust_cd": "17320",
"opp_cust_nm": "아센텍",
"cust_cd": "47196",
"cust_nm": "세종에이앤에프",
"merge_type": "회사분할",
"merge_rate": " 0.14",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231107",
"sht_cd": "367360",
"opp_cust_cd": "36736",
"opp_cust_nm": "디비금융제9호기업인수목적",
"cust_cd": "45216",
"cust_nm": "제이엔비",
"merge_type": "흡수합병",
"merge_rate": " 0.35",
"td_stop_dt": "2023/11/06 ~",
"list_dt": "20231124",
"odd_amt_pay_dt": "2023/12/01",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231017",
"sht_cd": "440200",
"opp_cust_cd": "44020",
"opp_cust_nm": "케이비제23호기업인수목적",
"cust_cd": "18826",
"cust_nm": "세니젠",
"merge_type": "흡수합병",
"merge_rate": " 0.24",
"td_stop_dt": "2023/10/16 ~",
"list_dt": "20231103",
"odd_amt_pay_dt": "2023/11/10",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231012",
"sht_cd": "085370",
"opp_cust_cd": "08537",
"opp_cust_nm": "루트로닉",
"cust_cd": "08537",
"cust_nm": "루트로닉",
"merge_type": "주식교환",
"merge_rate": " 1.00",
"td_stop_dt": "2023/10/11 ~",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231012",
"sht_cd": "08537M",
"opp_cust_cd": "08537",
"opp_cust_nm": "루트로닉",
"cust_cd": "08537",
"cust_nm": "루트로닉",
"merge_type": "주식교환",
"merge_rate": " 1.00",
"td_stop_dt": "2023/10/11 ~",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231011",
"sht_cd": "284100",
"opp_cust_cd": "28410",
"opp_cust_nm": "이안프론티어",
"cust_cd": "46939",
"cust_nm": "퍼스트온파트너스",
"merge_type": "회사분할",
"merge_rate": " 0.11",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231011",
"sht_cd": "405350",
"opp_cust_cd": "40535",
"opp_cust_nm": "아이비케이에스제17호기업인수목적",
"cust_cd": "29056",
"cust_nm": "신시웨이",
"merge_type": "흡수합병",
"merge_rate": " 0.23",
"td_stop_dt": "2023/10/10 ~",
"list_dt": "20231103",
"odd_amt_pay_dt": "2023/11/08",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20231010",
"sht_cd": "177900",
"opp_cust_cd": "17790",
"opp_cust_nm": "쓰리에이로직스",
"cust_cd": "46933",
"cust_nm": "쓰리에이솔루션",
"merge_type": "회사분할",
"merge_rate": " 0.20",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "2023/11/29",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230927",
"sht_cd": "077500",
"opp_cust_cd": "07750",
"opp_cust_nm": "유니퀘스트",
"cust_cd": "19265",
"cust_nm": "드림텍",
"merge_type": "분할합병",
"merge_rate": " 0.92",
"td_stop_dt": "2023/09/26 ~ 2023/10/22",
"list_dt": "20231023",
"odd_amt_pay_dt": "2023/11/01",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230919",
"sht_cd": "019360",
"opp_cust_cd": "01936",
"opp_cust_nm": "한국신소재",
"cust_cd": "01796",
"cust_nm": "한국카본",
"merge_type": "흡수합병",
"merge_rate": "39.74",
"td_stop_dt": "",
"list_dt": "20231020",
"odd_amt_pay_dt": "2023/10/27",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230904",
"sht_cd": "366330",
"opp_cust_cd": "36633",
"opp_cust_nm": "신한제7호기업인수목적",
"cust_cd": "38447",
"cust_nm": "코어라인소프트",
"merge_type": "흡수합병",
"merge_rate": " 0.19",
"td_stop_dt": "2023/09/01 ~",
"list_dt": "20230918",
"odd_amt_pay_dt": "2023/09/26",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230831",
"sht_cd": "011810",
"opp_cust_cd": "01181",
"opp_cust_nm": "STX",
"cust_cd": "46577",
"cust_nm": "STX 그린로지스",
"merge_type": "회사분할",
"merge_rate": " 0.23",
"td_stop_dt": "2023/08/30 ~ 2023/09/14",
"list_dt": "20230915",
"odd_amt_pay_dt": "2023/10/31",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230824",
"sht_cd": "048120",
"opp_cust_cd": "04812",
"opp_cust_nm": "원옥",
"cust_cd": "16857",
"cust_nm": "포겟",
"merge_type": "흡수합병",
"merge_rate": "12.00",
"td_stop_dt": "",
"list_dt": "20230912",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230822",
"sht_cd": "400560",
"opp_cust_cd": "40056",
"opp_cust_nm": "하나금융20호기업인수목적",
"cust_cd": "40349",
"cust_nm": "농업회사법인 우듬지팜",
"merge_type": "흡수합병",
"merge_rate": " 0.74",
"td_stop_dt": "2023/08/21 ~",
"list_dt": "20230919",
"odd_amt_pay_dt": "2023/09/26",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230821",
"sht_cd": "259210",
"opp_cust_cd": "25921",
"opp_cust_nm": "글람",
"cust_cd": "25921",
"cust_nm": "글람",
"merge_type": "주식교환",
"merge_rate": " 0.00",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230821",
"sht_cd": "367480",
"opp_cust_cd": "36748",
"opp_cust_nm": "유안타제8호기업인수목적",
"cust_cd": "14606",
"cust_nm": "율촌",
"merge_type": "흡수합병",
"merge_rate": " 0.87",
"td_stop_dt": "2023/08/18 ~",
"list_dt": "20230908",
"odd_amt_pay_dt": "2023/09/14",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230808",
"sht_cd": "409570",
"opp_cust_cd": "40957",
"opp_cust_nm": "한국제10호기업인수목적",
"cust_cd": "35539",
"cust_nm": "크라우드웍스",
"merge_type": "흡수합병",
"merge_rate": " 0.09",
"td_stop_dt": "",
"list_dt": "20230831",
"odd_amt_pay_dt": "2023/09/07",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230807",
"sht_cd": "010050",
"opp_cust_cd": "01005",
"opp_cust_nm": "우리종합금융",
"cust_cd": "31614",
"cust_nm": "우리금융지주",
"merge_type": "주식교환",
"merge_rate": " 0.06",
"td_stop_dt": "2023/08/04 ~ 2023/08/27",
"list_dt": "20230828",
"odd_amt_pay_dt": "2023/08/31",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230807",
"sht_cd": "298870",
"opp_cust_cd": "29887",
"opp_cust_nm": "우리벤처파트너스",
"cust_cd": "31614",
"cust_nm": "우리금융지주",
"merge_type": "주식교환",
"merge_rate": " 0.22",
"td_stop_dt": "2023/08/04 ~ 2023/08/27",
"list_dt": "20230828",
"odd_amt_pay_dt": "2023/08/31",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230702",
"sht_cd": "390620",
"opp_cust_cd": "39062",
"opp_cust_nm": "엠리테일",
"cust_cd": "05788",
"cust_nm": "피에이치씨",
"merge_type": "흡수합병",
"merge_rate": " 0.00",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230630",
"sht_cd": "000480",
"opp_cust_cd": "00048",
"opp_cust_nm": "시알홀딩스",
"cust_cd": "46252",
"cust_nm": "조선내화",
"merge_type": "회사분할",
"merge_rate": " 0.30",
"td_stop_dt": "2023/06/29 ~ 2023/07/27",
"list_dt": "20230728",
"odd_amt_pay_dt": "2023/08/04",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230630",
"sht_cd": "011870",
"opp_cust_cd": "01187",
"opp_cust_nm": "엘티삼보",
"cust_cd": "46220",
"cust_nm": "엘티",
"merge_type": "회사분할",
"merge_rate": " 0.33",
"td_stop_dt": "2023/06/29 ~ 2023/07/30",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230626",
"sht_cd": "046110",
"opp_cust_cd": "04611",
"opp_cust_nm": "한일네트웍스",
"cust_cd": "03787",
"cust_nm": "유베이스",
"merge_type": "주식교환",
"merge_rate": " 0.00",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230531",
"sht_cd": "001230",
"opp_cust_cd": "00123",
"opp_cust_nm": "동국홀딩스",
"cust_cd": "46086",
"cust_nm": "동국제강",
"merge_type": "회사분할",
"merge_rate": " 0.52",
"td_stop_dt": "2023/05/30 ~ 2023/06/15",
"list_dt": "20230616",
"odd_amt_pay_dt": "2023/06/23",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230501",
"sht_cd": "388220",
"opp_cust_cd": "38822",
"opp_cust_nm": "하나금융19호기업인수목적",
"cust_cd": "27183",
"cust_nm": "팸텍",
"merge_type": "흡수합병",
"merge_rate": " 0.41",
"td_stop_dt": "2023/04/27 ~",
"list_dt": "20230523",
"odd_amt_pay_dt": "2023/05/30",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230428",
"sht_cd": "005950",
"opp_cust_cd": "00595",
"opp_cust_nm": "이수화학",
"cust_cd": "45719",
"cust_nm": "이수스페셜티케미컬",
"merge_type": "회사분할",
"merge_rate": " 0.20",
"td_stop_dt": "2023/04/27 ~ 2023/05/30",
"list_dt": "20230531",
"odd_amt_pay_dt": "2023/06/14",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230428",
"sht_cd": "010060",
"opp_cust_cd": "01006",
"opp_cust_nm": "OCI홀딩스",
"cust_cd": "45604",
"cust_nm": "OCI",
"merge_type": "회사분할",
"merge_rate": " 0.31",
"td_stop_dt": "2023/04/27 ~ 2023/05/29",
"list_dt": "20230530",
"odd_amt_pay_dt": "2023/06/05",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230411",
"sht_cd": "246070",
"opp_cust_cd": "24607",
"opp_cust_nm": "딤채홀딩스",
"cust_cd": "00288",
"cust_nm": "대유에이텍",
"merge_type": "흡수합병",
"merge_rate": " 0.00",
"td_stop_dt": "",
"list_dt": "",
"odd_amt_pay_dt": "",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230410",
"sht_cd": "396770",
"opp_cust_cd": "39677",
"opp_cust_nm": "엔에이치기업인수목적22호",
"cust_cd": "29883",
"cust_nm": "슈어소프트테크",
"merge_type": "흡수합병",
"merge_rate": " 0.37",
"td_stop_dt": "2023/04/07 ~",
"list_dt": "20230428",
"odd_amt_pay_dt": "2023/05/04",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230410",
"sht_cd": "421750",
"opp_cust_cd": "42175",
"opp_cust_nm": "벨로크",
"cust_cd": "42476",
"cust_nm": "벨로크",
"merge_type": "흡수합병",
"merge_rate": " 5.12",
"td_stop_dt": "",
"list_dt": "20230428",
"odd_amt_pay_dt": "2023/05/04",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230404",
"sht_cd": "008560",
"opp_cust_cd": "00856",
"opp_cust_nm": "메리츠증권",
"cust_cd": "13804",
"cust_nm": "메리츠금융지주",
"merge_type": "주식교환",
"merge_rate": " 0.16",
"td_stop_dt": "2023/04/03 ~ 2023/04/24",
"list_dt": "20230425",
"odd_amt_pay_dt": "2023/04/28",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230403",
"sht_cd": "426670",
"opp_cust_cd": "42667",
"opp_cust_nm": "대신밸런스제12호기업인수목적",
"cust_cd": "31816",
"cust_nm": "셀바이오휴먼텍",
"merge_type": "흡수합병",
"merge_rate": " 0.33",
"td_stop_dt": "2023/03/31 ~",
"list_dt": "20230420",
"odd_amt_pay_dt": "2023/04/26",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
},
{
"record_date": "20230317",
"sht_cd": "062760",
"opp_cust_cd": "06276",
"opp_cust_nm": "코스텍시스",
"cust_cd": "35515",
"cust_nm": "코스텍시스",
"merge_type": "흡수합병",
"merge_rate": " 6.42",
"td_stop_dt": "2023/03/16 ~ 2023/04/02",
"list_dt": "20230403",
"odd_amt_pay_dt": "2023/04/10",
"tot_issue_stk_qty": " 0",
"issue_stk_qty": " 0",
"seq": "00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,235 @@
# 국내주식 종목추정실적
- 원본 시트명: 국내주식 종목추정실적
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: 국내주식-187
- HTTP Method: GET
- 실전 TR_ID: HHKST668300C0
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 미지원
- URL 명: /uapi/domestic-stock/v1/quotations/estimate-perform
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 종목추정실적 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0613] 종목추정실적 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
※ 본 화면의 추정실적 및 투자의견은 당월 초의 애널리스트의 의견사항이므로 월중 변동 사항이 있을 수 있음을 유의하시기 바랍니다.
※ 종목별 수익추정은 리서치본부에서 매월 발표되는 거래소, 코스닥 160여개 기업에 한정합니다. 구체적인 종목 리스트는 추정종목리스트를 참고하기 바랍니다.
## 레이아웃
### 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 | HHKST668300C0 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| SHT_CD | 종목코드 | string | Y | 2 | ex) 265520 |
### 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 | | |
| sht_cd | ELW단축종목코드 | string | Y | 9 | |
| item_kor_nm | HTS한글종목명 | string | Y | 40 | |
| name1 | ELW현재가 | string | Y | 10 | |
| name2 | 전일대비 | string | Y | 10 | |
| estdate | 전일대비부호 | string | Y | 1 | |
| rcmd_name | 전일대비율 | string | Y | 82 | |
| capital | 누적거래량 | string | Y | 18 | |
| forn_item_lmtrt | 행사가 | string | Y | 112 | |
| output2 | 응답상세 | object array | Y | | '(추정손익계산서-6개 array)<br> 매출액, 매출액증감율,<br> 영업이익, 영업이익증감율,<br> 순이익, 순이익증감율,' |
| data1 | DATA1 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data2 | DATA2 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data3 | DATA3 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data4 | DATA4 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data5 | DATA5 | string | Y | 15 | 결산연월(outblock4) 참조 |
| output3 | 응답상세 | object array | Y | | '(투자지표-8개 array)<br> EBITDA(십억원), EPS(원), <br> EPS 증감율(0.1%), PER(배, 0.1%), <br> EV/EBITDA(배, 0.1), ROE(0.1%),<br> 부채비율(0.1%), 이자보상배율(0.1%)' |
| data1 | DATA1 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data2 | DATA2 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data3 | DATA3 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data4 | DATA4 | string | Y | 15 | 결산연월(outblock4) 참조 |
| data5 | DATA5 | string | Y | 15 | 결산연월(outblock4) 참조 |
| output4 | 응답상세 | object array | Y | | array |
| dt | 결산년월 | string | Y | 8 | DATA1 ~5 결산월 정보 |
## 예제
### Request Example (Python)
```text
SHT_CD:005930
```
### Response Example
```text
{
"output1": {
"sht_cd": "A005930",
"item_kor_nm": "삼성전자",
"name1": "김한국",
"name2": "",
"estdate": "20240109",
"rcmd_name": "매수",
"capital": "8975.0",
"forn_item_lmtrt": "0.00"
},
"output2": [
{
"data1": "2796048.0",
"data2": "3022314.0",
"data3": "2581509.0",
"data4": "3048945.0",
"data5": "3295675.0"
},
{
"data1": "181.0",
"data2": "81.0",
"data3": "-146.0",
"data4": "181.0",
"data5": "81.0"
},
{
"data1": "516339.0",
"data2": "433766.0",
"data3": "65405.0",
"data4": "330172.0",
"data5": "555410.0"
},
{
"data1": "435.0",
"data2": "-160.0",
"data3": "-849.0",
"data4": "4048.0",
"data5": "682.0"
},
{
"data1": "392438.0",
"data2": "547300.0",
"data3": "106144.0",
"data4": "253332.0",
"data5": "422055.0"
},
{
"data1": "504.0",
"data2": "395.0",
"data3": "-806.0",
"data4": "1387.0",
"data5": "666.0"
}
],
"output3": [
{
"data1": "858812.0",
"data2": "824843.0",
"data3": "483199.0",
"data4": "792602.0",
"data5": "1043367.0"
},
{
"data1": "57770.0",
"data2": "80570.0",
"data3": "15609.0",
"data4": "36983.0",
"data5": "61483.0"
},
{
"data1": "504.0",
"data2": "395.0",
"data3": "-806.0",
"data4": "1369.0",
"data5": "662.0"
},
{
"data1": "136.0",
"data2": "69.0",
"data3": "503.0",
"data4": "207.0",
"data5": "124.0"
},
{
"data1": "50.0",
"data2": "34.0",
"data3": "95.0",
"data4": "53.0",
"data5": "39.0"
},
{
"data1": "139.0",
"data2": "171.0",
"data3": "31.0",
"data4": "70.0",
"data5": "109.0"
},
{
"data1": "399.0",
"data2": "264.0",
"data3": "255.0",
"data4": "226.0",
"data5": "163.0"
},
{
"data1": "1197.0",
"data2": "568.0",
"data3": "58.0",
"data4": "232.0",
"data5": "655.0"
}
],
"output4": [
{
"dt": "2021.12"
},
{
"dt": "2022.12"
},
{
"dt": "2023.12E"
},
{
"dt": "2024.12E"
},
{
"dt": "2025.12E"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```
@@ -0,0 +1,304 @@
# 국내주식 기타주요비율
- 원본 시트명: 국내주식 기타주요비율
- API 통신방식: REST
- 메뉴 위치: [국내주식] 종목정보
- API ID: v1_국내주식-082
- HTTP Method: GET
- 실전 TR_ID: FHKST66430500
- 모의 TR_ID: 모의투자 미지원
- 실전 Domain: https://openapi.koreainvestment.com:9443
- 모의 Domain: 모의투자 미지원
- URL 명: /uapi/domestic-stock/v1/finance/other-major-ratios
- 모의투자 지원: 미지원
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
## 개요
국내주식 기타주요비율 API입니다.
한국투자 HTS(eFriend Plus) &gt; [0635] 재무분석종합 화면의 하단 '9. 기타주요비율' 기능을 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 | FHKST66430500 |
| 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 |
| --- | --- | --- | --- | --- | --- |
| fid_input_iscd | 입력 종목코드 | string | Y | 12 | 000660 : 종목코드 |
| fid_div_cls_code | 분류 구분 코드 | string | Y | 2 | 0: 년, 1: 분기 |
| fid_cond_mrkt_div_code | 조건 시장 분류 코드 | string | Y | 2 | J |
### 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 array | Y | | array |
| stac_yymm | 결산 년월 | string | Y | 6 | |
| payout_rate | 배당 성향 | string | Y | 92 | 비정상 출력되는 데이터로 무시 |
| eva | EVA | string | Y | 82 | |
| ebitda | EBITDA | string | Y | 82 | |
| ev_ebitda | EV_EBITDA | string | Y | 82 | |
## 예제
### Request Example (Python)
```text
{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_div_cls_code":"1"
}
```
### Response Example
```text
{
"output": [
{
"stac_yymm": "202309",
"payout_rate": "-0.02",
"eva": "0.00",
"ebitda": "23464.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202306",
"payout_rate": "-0.02",
"eva": "0.00",
"ebitda": "7851.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202303",
"payout_rate": "-0.05",
"eva": "0.00",
"ebitda": "1574.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202212",
"payout_rate": "0.05",
"eva": "-18075.00",
"ebitda": "209609.00",
"ev_ebitda": "3.48"
},
{
"stac_yymm": "202209",
"payout_rate": "0.02",
"eva": "0.00",
"ebitda": "191549.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202206",
"payout_rate": "0.02",
"eva": "0.00",
"ebitda": "139382.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202203",
"payout_rate": "0.06",
"eva": "0.00",
"ebitda": "62600.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202112",
"payout_rate": "0.01",
"eva": "40178.00",
"ebitda": "230671.00",
"ev_ebitda": "4.59"
},
{
"stac_yymm": "202109",
"payout_rate": "0.02",
"eva": "0.00",
"ebitda": "160524.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202106",
"payout_rate": "0.04",
"eva": "0.00",
"ebitda": "91711.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202103",
"payout_rate": "0.12",
"eva": "0.00",
"ebitda": "38610.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202012",
"payout_rate": "0.03",
"eva": "3789.00",
"ebitda": "147848.00",
"ev_ebitda": "6.37"
},
{
"stac_yymm": "202009",
"payout_rate": "0.04",
"eva": "0.00",
"ebitda": "112945.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202006",
"payout_rate": "0.06",
"eva": "0.00",
"ebitda": "75099.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "202003",
"payout_rate": "0.19",
"eva": "0.00",
"ebitda": "31351.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201912",
"payout_rate": "0.06",
"eva": "-24528.00",
"ebitda": "113396.00",
"ev_ebitda": "6.76"
},
{
"stac_yymm": "201909",
"payout_rate": "0.06",
"eva": "0.00",
"ebitda": "87849.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201906",
"payout_rate": "0.07",
"eva": "0.00",
"ebitda": "61528.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201903",
"payout_rate": "0.11",
"eva": "0.00",
"ebitda": "34045.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201812",
"payout_rate": "0.01",
"eva": "123025.00",
"ebitda": "272721.00",
"ev_ebitda": "1.62"
},
{
"stac_yymm": "201809",
"payout_rate": "0.01",
"eva": "0.00",
"ebitda": "210889.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201806",
"payout_rate": "0.02",
"eva": "0.00",
"ebitda": "129647.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201803",
"payout_rate": "0.04",
"eva": "0.00",
"ebitda": "58160.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201712",
"payout_rate": "0.01",
"eva": "77272.00",
"ebitda": "187476.00",
"ev_ebitda": "2.97"
},
{
"stac_yymm": "201709",
"payout_rate": "0.02",
"eva": "0.00",
"ebitda": "129433.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201706",
"payout_rate": "0.03",
"eva": "0.00",
"ebitda": "78973.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201703",
"payout_rate": "0.06",
"eva": "0.00",
"ebitda": "36327.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201612",
"payout_rate": "0.04",
"eva": "11971.00",
"ebitda": "77332.00",
"ev_ebitda": "4.23"
},
{
"stac_yymm": "201609",
"payout_rate": "0.09",
"eva": "0.00",
"ebitda": "50536.00",
"ev_ebitda": "0.00"
},
{
"stac_yymm": "201606",
"payout_rate": "0.16",
"eva": "0.00",
"ebitda": "32197.00",
"ev_ebitda": "0.00"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
```