feat: add messaging transport rollout
This commit is contained in:
@@ -0,0 +1,136 @@
|
||||
# 주식현재가 일자별
|
||||
|
||||
- 원본 시트명: 주식현재가 일자별
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-010
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010400
|
||||
- 모의 TR_ID: FHKST01010400
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-price
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 일자별 API입니다. 일/주/월별 주가를 확인할 수 있으며 최근 30일(주,별)로 제한되어 있습니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHKST01010400 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
| FID_PERIOD_DIV_CODE | 기간 분류 코드 | string | Y | 32 | 'D : (일)최근 30거래일 <br>W : (주)최근 30주 <br>M : (월)최근 30개월' |
|
||||
| FID_ORG_ADJ_PRC | 수정주가 원주가 가격 | string | Y | 10 | '0 : 수정주가미반영<br>1 : 수정주가반영<br>* 수정주가는 액면분할/액면병합 등 권리 발생 시 과거 시세를 현재 주가에 맞게 보정한 가격' |
|
||||
|
||||
### 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_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| stck_clpr | 주식 종가 | string | Y | 10 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | 13(8.4) |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | 11(8.2) |
|
||||
| hts_frgn_ehrt | HTS 외국인 소진율 | string | Y | 82 | 11(8.2) |
|
||||
| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
|
||||
| flng_cls_code | 락 구분 코드 | string | Y | 2 | '01 : 권리락 <br>02 : 배당락 <br>03 : 분배락 <br>04 : 권배락 <br>05 : 중간(분기)배당락 <br>06 : 권리중간배당락 <br>07 : 권리분기배당락' |
|
||||
| acml_prtt_rate | 누적 분할 비율 | string | Y | 84 | 13(8.4) |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660",
|
||||
"fid_org_adj_prc": "0000000001",
|
||||
"fid_period_div_code": "D"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": [
|
||||
{
|
||||
"stck_bsop_date": "20220111",
|
||||
"stck_oprc": "125500",
|
||||
"stck_hgpr": "128500",
|
||||
"stck_lwpr": "124500",
|
||||
"stck_clpr": "128000",
|
||||
"acml_vol": "3908418",
|
||||
"prdy_vrss_vol_rate": "13.31",
|
||||
"prdy_vrss": "3500",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "2.81",
|
||||
"hts_frgn_ehrt": "49.39",
|
||||
"frgn_ntby_qty": "0",
|
||||
"flng_cls_code": "00",
|
||||
"acml_prtt_rate": "1.00"
|
||||
},
|
||||
{
|
||||
"stck_bsop_date": "20220110",
|
||||
"stck_oprc": "126500",
|
||||
"stck_hgpr": "127000",
|
||||
"stck_lwpr": "123000",
|
||||
"stck_clpr": "124500",
|
||||
"acml_vol": "3449197",
|
||||
"prdy_vrss_vol_rate": "5.48",
|
||||
"prdy_vrss": "-2500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"prdy_ctrt": "-1.97",
|
||||
"hts_frgn_ehrt": "49.39",
|
||||
"frgn_ntby_qty": "293389",
|
||||
"flng_cls_code": "00",
|
||||
"acml_prtt_rate": "0.00"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,250 @@
|
||||
# 주식현재가 시세
|
||||
|
||||
- 원본 시트명: 주식현재가 시세
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-008
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010100
|
||||
- 모의 TR_ID: FHKST01010100
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-price
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식 현재가 시세 API입니다. 실시간 시세를 원하신다면 웹소켓 API를 활용하세요.
|
||||
|
||||
※ 종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
|
||||
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHKST01010100 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) // ETN은 종목코드 6자리 앞에 Q 입력 필수 |
|
||||
|
||||
### Response Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | |
|
||||
| output | 응답상세 | object | Y | | |
|
||||
| iscd_stat_cls_code | 종목 상태 구분 코드 | string | Y | 3 | 51 : 관리종목<br>52 : 투자위험<br>53 : 투자경고<br>54 : 투자주의<br>55 : 신용가능<br>57 : 증거금 100%<br>58 : 거래정지<br>59 : 단기과열종목 |
|
||||
| marg_rate | 증거금 비율 | string | Y | 84 | |
|
||||
| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
|
||||
| new_hgpr_lwpr_cls_code | 신 고가 저가 구분 코드 | string | Y | 10 | |
|
||||
| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | |
|
||||
| temp_stop_yn | 임시 정지 여부 | string | Y | 1 | |
|
||||
| oprc_rang_cont_yn | 시가 범위 연장 여부 | string | Y | 1 | |
|
||||
| clpr_rang_cont_yn | 종가 범위 연장 여부 | string | Y | 1 | |
|
||||
| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
|
||||
| grmn_rate_cls_code | 보증금 비율 구분 코드 | string | Y | 3 | |
|
||||
| elw_pblc_yn | ELW 발행 여부 | string | Y | 1 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| stck_mxpr | 주식 상한가 | string | Y | 10 | |
|
||||
| stck_llam | 주식 하한가 | string | Y | 10 | |
|
||||
| stck_sdpr | 주식 기준가 | string | Y | 10 | |
|
||||
| wghn_avrg_stck_prc | 가중 평균 주식 가격 | string | Y | 192 | |
|
||||
| hts_frgn_ehrt | HTS 외국인 소진율 | string | Y | 82 | |
|
||||
| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
|
||||
| pgtr_ntby_qty | 프로그램매매 순매수 수량 | string | Y | 18 | |
|
||||
| pvt_scnd_dmrs_prc | 피벗 2차 디저항 가격 | string | Y | 10 | |
|
||||
| pvt_frst_dmrs_prc | 피벗 1차 디저항 가격 | string | Y | 10 | |
|
||||
| pvt_pont_val | 피벗 포인트 값 | string | Y | 10 | |
|
||||
| pvt_frst_dmsp_prc | 피벗 1차 디지지 가격 | string | Y | 10 | |
|
||||
| pvt_scnd_dmsp_prc | 피벗 2차 디지지 가격 | string | Y | 10 | |
|
||||
| dmrs_val | 디저항 값 | string | Y | 10 | |
|
||||
| dmsp_val | 디지지 값 | string | Y | 10 | |
|
||||
| cpfn | 자본금 | string | Y | 22 | |
|
||||
| rstc_wdth_prc | 제한 폭 가격 | string | Y | 10 | |
|
||||
| stck_fcam | 주식 액면가 | string | Y | 11 | |
|
||||
| stck_sspr | 주식 대용가 | string | Y | 10 | |
|
||||
| aspr_unit | 호가단위 | string | Y | 10 | |
|
||||
| hts_deal_qty_unit_val | HTS 매매 수량 단위 값 | string | Y | 10 | |
|
||||
| lstn_stcn | 상장 주수 | string | Y | 18 | |
|
||||
| hts_avls | HTS 시가총액 | string | Y | 18 | |
|
||||
| per | PER | string | Y | 82 | |
|
||||
| pbr | PBR | string | Y | 82 | |
|
||||
| stac_month | 결산 월 | string | Y | 2 | |
|
||||
| vol_tnrt | 거래량 회전율 | string | Y | 82 | |
|
||||
| eps | EPS | string | Y | 112 | |
|
||||
| bps | BPS | string | Y | 112 | |
|
||||
| d250_hgpr | 250일 최고가 | string | Y | 10 | |
|
||||
| d250_hgpr_date | 250일 최고가 일자 | string | Y | 8 | |
|
||||
| d250_hgpr_vrss_prpr_rate | 250일 최고가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| d250_lwpr | 250일 최저가 | string | Y | 10 | |
|
||||
| d250_lwpr_date | 250일 최저가 일자 | string | Y | 8 | |
|
||||
| d250_lwpr_vrss_prpr_rate | 250일 최저가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| stck_dryy_hgpr | 주식 연중 최고가 | string | Y | 10 | |
|
||||
| dryy_hgpr_vrss_prpr_rate | 연중 최고가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| dryy_hgpr_date | 연중 최고가 일자 | string | Y | 8 | |
|
||||
| stck_dryy_lwpr | 주식 연중 최저가 | string | Y | 10 | |
|
||||
| dryy_lwpr_vrss_prpr_rate | 연중 최저가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| dryy_lwpr_date | 연중 최저가 일자 | string | Y | 8 | |
|
||||
| w52_hgpr | 52주일 최고가 | string | Y | 10 | |
|
||||
| w52_hgpr_vrss_prpr_ctrt | 52주일 최고가 대비 현재가 대비 | string | Y | 82 | |
|
||||
| w52_hgpr_date | 52주일 최고가 일자 | string | Y | 8 | |
|
||||
| w52_lwpr | 52주일 최저가 | string | Y | 10 | |
|
||||
| w52_lwpr_vrss_prpr_ctrt | 52주일 최저가 대비 현재가 대비 | string | Y | 82 | |
|
||||
| w52_lwpr_date | 52주일 최저가 일자 | string | Y | 8 | |
|
||||
| whol_loan_rmnd_rate | 전체 융자 잔고 비율 | string | Y | 84 | |
|
||||
| ssts_yn | 공매도가능여부 | string | Y | 1 | |
|
||||
| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
|
||||
| fcam_cnnm | 액면가 통화명 | string | Y | 20 | |
|
||||
| cpfn_cnnm | 자본금 통화명 | string | Y | 20 | |
|
||||
| apprch_rate | 접근도 | string | Y | 112 | |
|
||||
| frgn_hldn_qty | 외국인 보유 수량 | string | Y | 18 | |
|
||||
| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
|
||||
| ovtm_vi_cls_code | 시간외단일가VI적용구분코드 | string | Y | 1 | |
|
||||
| last_ssts_cntg_qty | 최종 공매도 체결 수량 | string | Y | 12 | |
|
||||
| invt_caful_yn | 투자유의여부 | string | Y | 1 | |
|
||||
| mrkt_warn_cls_code | 시장경고코드 | string | Y | 2 | |
|
||||
| short_over_yn | 단기과열여부 | string | Y | 1 | |
|
||||
| sltr_yn | 정리매매여부 | string | Y | 1 | |
|
||||
| mang_issu_cls_code | 관리종목여부 | string | Y | 1 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"iscd_stat_cls_code": "55",
|
||||
"marg_rate": "20.00",
|
||||
"rprs_mrkt_kor_name": "KOSPI200",
|
||||
"bstp_kor_isnm": "전기.전자",
|
||||
"temp_stop_yn": "N",
|
||||
"oprc_rang_cont_yn": "N",
|
||||
"clpr_rang_cont_yn": "N",
|
||||
"crdt_able_yn": "Y",
|
||||
"grmn_rate_cls_code": "40",
|
||||
"elw_pblc_yn": "Y",
|
||||
"stck_prpr": "128500",
|
||||
"prdy_vrss": "0",
|
||||
"prdy_vrss_sign": "3",
|
||||
"prdy_ctrt": "0.00",
|
||||
"acml_tr_pbmn": "344570137500",
|
||||
"acml_vol": "2669075",
|
||||
"prdy_vrss_vol_rate": "75.14",
|
||||
"stck_oprc": "128500",
|
||||
"stck_hgpr": "130000",
|
||||
"stck_lwpr": "128500",
|
||||
"stck_mxpr": "167000",
|
||||
"stck_llam": "90000",
|
||||
"stck_sdpr": "128500",
|
||||
"wghn_avrg_stck_prc": "129097.23",
|
||||
"hts_frgn_ehrt": "49.48",
|
||||
"frgn_ntby_qty": "0",
|
||||
"pgtr_ntby_qty": "287715",
|
||||
"pvt_scnd_dmrs_prc": "131833",
|
||||
"pvt_frst_dmrs_prc": "130166",
|
||||
"pvt_pont_val": "128333",
|
||||
"pvt_frst_dmsp_prc": "126666",
|
||||
"pvt_scnd_dmsp_prc": "124833",
|
||||
"dmrs_val": "129250",
|
||||
"dmsp_val": "125750",
|
||||
"cpfn": "36577",
|
||||
"rstc_wdth_prc": "38500",
|
||||
"stck_fcam": "5000",
|
||||
"stck_sspr": "97660",
|
||||
"aspr_unit": "500",
|
||||
"hts_deal_qty_unit_val": "1",
|
||||
"lstn_stcn": "728002365",
|
||||
"hts_avls": "935483",
|
||||
"per": "19.67",
|
||||
"pbr": "1.72",
|
||||
"stac_month": "12",
|
||||
"vol_tnrt": "0.37",
|
||||
"eps": "6532.00",
|
||||
"bps": "74721.00",
|
||||
"d250_hgpr": "149500",
|
||||
"d250_hgpr_date": "20210225",
|
||||
"d250_hgpr_vrss_prpr_rate": "-14.05",
|
||||
"d250_lwpr": "90500",
|
||||
"d250_lwpr_date": "20211013",
|
||||
"d250_lwpr_vrss_prpr_rate": "41.99",
|
||||
"stck_dryy_hgpr": "132500",
|
||||
"dryy_hgpr_vrss_prpr_rate": "-3.02",
|
||||
"dryy_hgpr_date": "20220103",
|
||||
"stck_dryy_lwpr": "121500",
|
||||
"dryy_lwpr_vrss_prpr_rate": "5.76",
|
||||
"dryy_lwpr_date": "20220105",
|
||||
"w52_hgpr": "149500",
|
||||
"w52_hgpr_vrss_prpr_ctrt": "-14.05",
|
||||
"w52_hgpr_date": "20210225",
|
||||
"w52_lwpr": "90500",
|
||||
"w52_lwpr_vrss_prpr_ctrt": "41.99",
|
||||
"w52_lwpr_date": "20211013",
|
||||
"whol_loan_rmnd_rate": "0.22",
|
||||
"ssts_yn": "Y",
|
||||
"stck_shrn_iscd": "000660",
|
||||
"fcam_cnnm": "5,000",
|
||||
"cpfn_cnnm": "36,576 억",
|
||||
"frgn_hldn_qty": "360220601",
|
||||
"vi_cls_code": "N",
|
||||
"ovtm_vi_cls_code": "N",
|
||||
"last_ssts_cntg_qty": "43916",
|
||||
"invt_caful_yn": "N",
|
||||
"mrkt_warn_cls_code": "00",
|
||||
"short_over_yn": "N",
|
||||
"sltr_yn": "N"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,151 @@
|
||||
# 국내주식 시간외현재가
|
||||
|
||||
- 원본 시트명: 국내주식 시간외현재가
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: 국내주식-076
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02300000
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-overtime-price
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
국내주식 시간외현재가 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0230] 시간외 현재가 화면의 좌측 상단기능을 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 | FHPST02300000 |
|
||||
| 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_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
|
||||
|
||||
### Response Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | |
|
||||
| output | 응답상세 | object | Y | | |
|
||||
| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
|
||||
| mang_issu_cls_name | 관리 종목 구분 명 | string | Y | 40 | |
|
||||
| ovtm_untp_prpr | 시간외 단일가 현재가 | string | Y | 10 | |
|
||||
| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | Y | 10 | |
|
||||
| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | Y | 1 | |
|
||||
| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | Y | 82 | |
|
||||
| ovtm_untp_vol | 시간외 단일가 거래량 | string | Y | 18 | |
|
||||
| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | Y | 18 | |
|
||||
| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | Y | 18 | |
|
||||
| ovtm_untp_llam | 시간외 단일가 하한가 | string | Y | 18 | |
|
||||
| ovtm_untp_oprc | 시간외 단일가 시가2 | string | Y | 10 | |
|
||||
| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | Y | 10 | |
|
||||
| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | Y | 10 | |
|
||||
| marg_rate | 증거금 비율 | string | Y | 84 | |
|
||||
| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | Y | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | Y | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | Y | 1 | |
|
||||
| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | Y | 82 | |
|
||||
| ovtm_untp_antc_cnqn | 시간외 단일가 예상 체결량 | string | Y | 18 | |
|
||||
| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
|
||||
| new_lstn_cls_name | 신규 상장 구분 명 | string | Y | 40 | |
|
||||
| sltr_yn | 정리매매 여부 | string | Y | 1 | |
|
||||
| mang_issu_yn | 관리 종목 여부 | string | Y | 1 | |
|
||||
| mrkt_warn_cls_code | 시장 경고 구분 코드 | string | Y | 2 | |
|
||||
| trht_yn | 거래정지 여부 | string | Y | 1 | |
|
||||
| vlnt_deal_cls_name | 임의 매매 구분 명 | string | Y | 16 | |
|
||||
| ovtm_untp_sdpr | 시간외 단일가 기준가 | string | Y | 10 | |
|
||||
| mrkt_warn_cls_name | 시장 경구 구분 명 | string | Y | 40 | |
|
||||
| revl_issu_reas_name | 재평가 종목 사유 명 | string | Y | 40 | |
|
||||
| insn_pbnt_yn | 불성실 공시 여부 | string | Y | 1 | |
|
||||
| flng_cls_name | 락 구분 이름 | string | Y | 40 | |
|
||||
| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
|
||||
| ovtm_vi_cls_code | 시간외단일가VI적용구분코드 | string | Y | 1 | |
|
||||
| bidp | 매수호가 | string | Y | 10 | |
|
||||
| askp | 매도호가 | string | Y | 10 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
fid_cond_mrkt_div_code:J
|
||||
fid_input_iscd:005930
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"bstp_kor_isnm": "전기.전자",
|
||||
"ovtm_untp_prpr": "83600",
|
||||
"ovtm_untp_prdy_vrss": "-100",
|
||||
"ovtm_untp_prdy_vrss_sign": "5",
|
||||
"ovtm_untp_prdy_ctrt": "-0.12",
|
||||
"ovtm_untp_vol": "3500",
|
||||
"ovtm_untp_tr_pbmn": "292600000",
|
||||
"ovtm_untp_mxpr": "92000",
|
||||
"ovtm_untp_llam": "75400",
|
||||
"ovtm_untp_oprc": "83600",
|
||||
"ovtm_untp_hgpr": "83600",
|
||||
"ovtm_untp_lwpr": "83600",
|
||||
"marg_rate": "20.00",
|
||||
"ovtm_untp_antc_cnpr": "83500",
|
||||
"ovtm_untp_antc_cntg_vrss": "-200",
|
||||
"ovtm_untp_antc_cntg_vrss_sign": "5",
|
||||
"ovtm_untp_antc_cntg_ctrt": "-0.24",
|
||||
"ovtm_untp_antc_cnqn": "4442",
|
||||
"crdt_able_yn": "Y",
|
||||
"new_lstn_cls_name": " ",
|
||||
"sltr_yn": "N",
|
||||
"mang_issu_yn": "N",
|
||||
"mrkt_warn_cls_code": "00",
|
||||
"trht_yn": "N",
|
||||
"vlnt_deal_cls_name": " ",
|
||||
"ovtm_untp_sdpr": "83700",
|
||||
"insn_pbnt_yn": "N",
|
||||
"rprs_mrkt_kor_name": "KOSPI200",
|
||||
"ovtm_vi_cls_code": "N",
|
||||
"bidp": "83600",
|
||||
"askp": "83700"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,167 @@
|
||||
# 주식현재가 시간외시간별체결
|
||||
|
||||
- 원본 시트명: 주식현재가 시간외시간별체결
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-025
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02310000
|
||||
- 모의 TR_ID: FHPST02310000
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-overtimeconclusion
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 시간외시간별체결 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0231] 시간외 시간별체결의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### Request Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
|
||||
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
|
||||
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
|
||||
| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]<br>FHPST02310000 |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| custtype | 고객 타입 | string | N | 1 | B : 법인 <br>P : 개인 |
|
||||
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
|
||||
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
|
||||
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
|
||||
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Request Query Parameter
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J : 주식, ETF, ETN |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)<br>ETN의 경우, Q로 시작 (EX. Q500001) |
|
||||
| FID_HOUR_CLS_CODE | 시간 구분 코드 | string | Y | 5 | 1 : 시간외 (Default) |
|
||||
|
||||
### Response Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | |
|
||||
| output1 | 응답상세1 | object | N | | 기본정보 |
|
||||
| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
|
||||
| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | |
|
||||
| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
|
||||
| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | N | 18 | |
|
||||
| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | N | 18 | |
|
||||
| ovtm_untp_llam | 시간외 단일가 하한가 | string | N | 18 | |
|
||||
| ovtm_untp_oprc | 시간외 단일가 시가2 | string | N | 10 | |
|
||||
| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | N | 10 | |
|
||||
| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | N | 1 | |
|
||||
| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | N | 11 | |
|
||||
| ovtm_untp_antc_vol | 시간외 단일가 예상 거래량 | string | N | 18 | |
|
||||
| uplm_sign | 상한 부호 | string | N | 1 | |
|
||||
| lslm_sign | 하한 부호 | string | N | 1 | |
|
||||
| output2 | 응답상세2 | object array | N | | Array 시간별체결 정보 |
|
||||
| stck_cntg_hour | 주식 체결 시간 | string | N | 6 | |
|
||||
| stck_prpr | 주식 현재가 | string | N | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | N | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | N | 11 | |
|
||||
| askp | 매도호가 | string | N | 10 | |
|
||||
| bidp | 매수호가 | string | N | 10 | |
|
||||
| acml_vol | 누적 거래량 | string | N | 18 | |
|
||||
| cntg_vol | 체결 거래량 | string | N | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
"input": {
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_hour_CLS_CODE": "1",
|
||||
"fid_input_iscd": "018000"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
"output1": {
|
||||
"lslm_sign": "4",
|
||||
"ovtm_untp_antc_cnpr": "0",
|
||||
"ovtm_untp_antc_cntg_ctrt": "0.00",
|
||||
"ovtm_untp_antc_cntg_vrss": "0",
|
||||
"ovtm_untp_antc_cntg_vrss_sign": "3",
|
||||
"ovtm_untp_antc_vol": "0",
|
||||
"ovtm_untp_hgpr": "2900",
|
||||
"ovtm_untp_llam": "2615",
|
||||
"ovtm_untp_lwpr": "2835",
|
||||
"ovtm_untp_mxpr": "3195",
|
||||
"ovtm_untp_oprc": "2900",
|
||||
"ovtm_untp_prdy_ctrt": "-2.41",
|
||||
"ovtm_untp_prdy_vrss": "-70",
|
||||
"ovtm_untp_prdy_vrss_sign": "5",
|
||||
"ovtm_untp_prpr": "2835",
|
||||
"ovtm_untp_tr_pbmn": "194135625",
|
||||
"ovtm_untp_vol": "68086",
|
||||
"uplm_sign": "1"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"acml_vol": "68086",
|
||||
"askp": "2840",
|
||||
"bidp": "2835",
|
||||
"cntg_vol": "12865",
|
||||
"prdy_ctrt": "-2.41",
|
||||
"prdy_vrss": "-70",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "180025",
|
||||
"stck_prpr": "2835"
|
||||
},
|
||||
{
|
||||
"acml_vol": "55221",
|
||||
"askp": "2840",
|
||||
"bidp": "2835",
|
||||
"cntg_vol": "6852",
|
||||
"prdy_ctrt": "-2.24",
|
||||
"prdy_vrss": "-65",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "175026",
|
||||
"stck_prpr": "2840"
|
||||
},
|
||||
....
|
||||
{
|
||||
"acml_vol": "668",
|
||||
"askp": "2900",
|
||||
"bidp": "2895",
|
||||
"cntg_vol": "668",
|
||||
"prdy_ctrt": "-0.17",
|
||||
"prdy_vrss": "-5",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "161022",
|
||||
"stck_prpr": "2900"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0"
|
||||
```
|
||||
@@ -0,0 +1,130 @@
|
||||
# NAV 비교추이(종목)
|
||||
|
||||
- 원본 시트명: NAV 비교추이(종목)
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-069
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02440000
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/etfetn/v1/quotations/nav-comparison-trend
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
NAV 비교추이(종목) API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면의 기능을 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 | FHPST02440000 |
|
||||
| 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_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 |
|
||||
|
||||
### 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 | | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 8 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 8 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 2 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 4 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 12 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 60 | |
|
||||
| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| stck_mxpr | 주식 상한가 | string | Y | 10 | |
|
||||
| stck_llam | 주식 하한가 | string | Y | 10 | |
|
||||
| output2 | 응답상세 | object | Y | | |
|
||||
| nav | NAV | string | Y | 11 | |
|
||||
| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
|
||||
| nav_prdy_vrss | NAV 전일 대비 | string | Y | 11 | |
|
||||
| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 8 | |
|
||||
| prdy_clpr_nav | NAV전일종가 | string | Y | 11 | |
|
||||
| oprc_nav | NAV시가 | string | Y | 11 | |
|
||||
| hprc_nav | NAV고가 | string | Y | 11 | |
|
||||
| lprc_nav | NAV저가 | string | Y | 11 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code":"J",
|
||||
"fid_input_iscd":"069500"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output1": {
|
||||
"stck_prpr": "36090",
|
||||
"prdy_vrss": "110",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.31",
|
||||
"acml_vol": "3720111",
|
||||
"acml_tr_pbmn": "134826697200",
|
||||
"stck_prdy_clpr": "35980",
|
||||
"stck_oprc": "36300",
|
||||
"stck_hgpr": "36510",
|
||||
"stck_lwpr": "36040",
|
||||
"stck_mxpr": "46770",
|
||||
"stck_llam": "25190"
|
||||
},
|
||||
"output2": {
|
||||
"nav": "36127.30",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "91.08",
|
||||
"nav_prdy_ctrt": "0.25",
|
||||
"prdy_clpr_nav": "36036.22",
|
||||
"oprc_nav": "36065.99",
|
||||
"hprc_nav": "36543.62",
|
||||
"lprc_nav": "36065.99"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,170 @@
|
||||
# 주식현재가 시간외일자별주가
|
||||
|
||||
- 원본 시트명: 주식현재가 시간외일자별주가
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-026
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02320000
|
||||
- 모의 TR_ID: FHPST02320000
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-overtimeprice
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 시간외일자별주가 API입니다. (최근일 30건만 조회 가능)
|
||||
한국투자 HTS(eFriend Plus) > [0232] 시간외 일자별주가의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### Request Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
|
||||
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
|
||||
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요!) |
|
||||
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
|
||||
| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]<br>FHPST02320000 |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| custtype | 고객 타입 | string | N | 1 | B : 법인 <br>P : 개인 |
|
||||
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
|
||||
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
|
||||
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
|
||||
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Request Query Parameter
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J : 주식, ETF, ETN |
|
||||
| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)<br>ETN의 경우, Q로 시작 (EX. Q500001) |
|
||||
|
||||
### Response Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | |
|
||||
| output1 | 응답상세1 | object | N | | 기본정보 |
|
||||
| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
|
||||
| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | 11(8.2) |
|
||||
| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
|
||||
| ovtm_untp_tr_pbmn | 시간외 단일가 거래 대금 | string | N | 18 | |
|
||||
| ovtm_untp_mxpr | 시간외 단일가 상한가 | string | N | 18 | |
|
||||
| ovtm_untp_llam | 시간외 단일가 하한가 | string | N | 18 | |
|
||||
| ovtm_untp_oprc | 시간외 단일가 시가2 | string | N | 10 | |
|
||||
| ovtm_untp_hgpr | 시간외 단일가 최고가 | string | N | 10 | |
|
||||
| ovtm_untp_lwpr | 시간외 단일가 최저가 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cnpr | 시간외 단일가 예상 체결가 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss | 시간외 단일가 예상 체결 대비 | string | N | 10 | |
|
||||
| ovtm_untp_antc_cntg_vrss_sign | 시간외 단일가 예상 체결 대비 | string | N | 1 | |
|
||||
| ovtm_untp_antc_cntg_ctrt | 시간외 단일가 예상 체결 대비율 | string | N | 11 | 11(8.2) |
|
||||
| ovtm_untp_antc_vol | 시간외 단일가 예상 거래량 | string | N | 18 | |
|
||||
| output2 | 응답상세2 | object array | N | | Array 일자별 정보 |
|
||||
| stck_bsop_date | 주식 영업 일자 | string | N | 8 | |
|
||||
| ovtm_untp_prpr | 시간외 단일가 현재가 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss | 시간외 단일가 전일 대비 | string | N | 10 | |
|
||||
| ovtm_untp_prdy_vrss_sign | 시간외 단일가 전일 대비 부호 | string | N | 1 | |
|
||||
| ovtm_untp_prdy_ctrt | 시간외 단일가 전일 대비율 | string | N | 11 | 11(8.2) |
|
||||
| ovtm_untp_vol | 시간외 단일가 거래량 | string | N | 18 | |
|
||||
| stck_clpr | 주식 종가 | string | N | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | N | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | N | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | N | 11 | 11(8.2) |
|
||||
| acml_vol | 누적 거래량 | string | N | 18 | |
|
||||
| ovtm_untp_tr_pbmn | 시간외 단일가 거래대금 | string | N | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
'"input": {'
|
||||
'"fid_cond_mrkt_div_code":"J"'
|
||||
','
|
||||
'"fid_input_iscd":"000660"'
|
||||
'}'
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
"output1": {
|
||||
"ovtm_untp_antc_cnpr": "0",
|
||||
"ovtm_untp_antc_cntg_ctrt": "0.00",
|
||||
"ovtm_untp_antc_cntg_vrss": "0",
|
||||
"ovtm_untp_antc_cntg_vrss_sign": "3",
|
||||
"ovtm_untp_antc_vol": "0",
|
||||
"ovtm_untp_hgpr": "106000",
|
||||
"ovtm_untp_llam": "95000",
|
||||
"ovtm_untp_lwpr": "105500",
|
||||
"ovtm_untp_mxpr": "116000",
|
||||
"ovtm_untp_oprc": "0",
|
||||
"ovtm_untp_prdy_ctrt": "0.47",
|
||||
"ovtm_untp_prdy_vrss": "500",
|
||||
"ovtm_untp_prdy_vrss_sign": "2",
|
||||
"ovtm_untp_prpr": "106000",
|
||||
"ovtm_untp_tr_pbmn": "1348318000",
|
||||
"ovtm_untp_vol": "12740"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"acml_vol": "4640744",
|
||||
"ovtm_untp_prdy_ctrt": "0.47",
|
||||
"ovtm_untp_prdy_vrss": "500",
|
||||
"ovtm_untp_prdy_vrss_sign": "2",
|
||||
"ovtm_untp_prpr": "106000",
|
||||
"ovtm_untp_tr_pbmn": "1348318000",
|
||||
"ovtm_untp_vol": "12740",
|
||||
"prdy_ctrt": "-0.47",
|
||||
"prdy_vrss": "-500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_bsop_date": "20220609",
|
||||
"stck_clpr": "105500"
|
||||
},
|
||||
{
|
||||
"acml_vol": "3075530",
|
||||
"ovtm_untp_prdy_ctrt": "0.47",
|
||||
"ovtm_untp_prdy_vrss": "500",
|
||||
"ovtm_untp_prdy_vrss_sign": "2",
|
||||
"ovtm_untp_prpr": "106500",
|
||||
"ovtm_untp_tr_pbmn": "1882068000",
|
||||
"ovtm_untp_vol": "17672",
|
||||
"prdy_ctrt": "1.92",
|
||||
"prdy_vrss": "2000",
|
||||
......
|
||||
{
|
||||
"acml_vol": "2969516",
|
||||
"ovtm_untp_prdy_ctrt": "0.00",
|
||||
"ovtm_untp_prdy_vrss": "0",
|
||||
"ovtm_untp_prdy_vrss_sign": "3",
|
||||
"ovtm_untp_prpr": "111000",
|
||||
"ovtm_untp_tr_pbmn": "2273650500",
|
||||
"ovtm_untp_vol": "20565",
|
||||
"prdy_ctrt": "2.78",
|
||||
"prdy_vrss": "3000",
|
||||
"prdy_vrss_sign": "2",
|
||||
"stck_bsop_date": "20220426",
|
||||
"stck_clpr": "111000"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0"
|
||||
```
|
||||
@@ -0,0 +1,219 @@
|
||||
# 국내주식 시간외호가
|
||||
|
||||
- 원본 시트명: 국내주식 시간외호가
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: 국내주식-077
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02300400
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-overtime-asking-price
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
국내주식 시간외호가 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0230] 시간외 현재가 화면의 '호가' 기능을 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 | FHPST02300400 |
|
||||
| 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 | 종목코드 |
|
||||
| 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 | |
|
||||
| output1 | 응답상세 | object | Y | | |
|
||||
| ovtm_untp_last_hour | 시간외 단일가 최종 시간 | string | Y | 6 | |
|
||||
| ovtm_untp_askp1 | 시간외 단일가 매도호가1 | string | Y | 10 | |
|
||||
| ovtm_untp_askp2 | 시간외 단일가 매도호가2 | string | Y | 10 | |
|
||||
| ovtm_untp_askp3 | 시간외 단일가 매도호가3 | string | Y | 10 | |
|
||||
| ovtm_untp_askp4 | 시간외 단일가 매도호가4 | string | Y | 10 | |
|
||||
| ovtm_untp_askp5 | 시간외 단일가 매도호가5 | string | Y | 10 | |
|
||||
| ovtm_untp_askp6 | 시간외 단일가 매도호가6 | string | Y | 10 | |
|
||||
| ovtm_untp_askp7 | 시간외 단일가 매도호가7 | string | Y | 10 | |
|
||||
| ovtm_untp_askp8 | 시간외 단일가 매도호가8 | string | Y | 10 | |
|
||||
| ovtm_untp_askp9 | 시간외 단일가 매도호가9 | string | Y | 10 | |
|
||||
| ovtm_untp_askp10 | 시간외 단일가 매도호가10 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp1 | 시간외 단일가 매수호가1 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp2 | 시간외 단일가 매수호가2 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp3 | 시간외 단일가 매수호가3 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp4 | 시간외 단일가 매수호가4 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp5 | 시간외 단일가 매수호가5 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp6 | 시간외 단일가 매수호가6 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp7 | 시간외 단일가 매수호가7 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp8 | 시간외 단일가 매수호가8 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp9 | 시간외 단일가 매수호가9 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp10 | 시간외 단일가 매수호가10 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc1 | 시간외 단일가 매도호가 증감1 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc2 | 시간외 단일가 매도호가 증감2 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc3 | 시간외 단일가 매도호가 증감3 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc4 | 시간외 단일가 매도호가 증감4 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc5 | 시간외 단일가 매도호가 증감5 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc6 | 시간외 단일가 매도호가 증감6 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc7 | 시간외 단일가 매도호가 증감7 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc8 | 시간외 단일가 매도호가 증감8 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc9 | 시간외 단일가 매도호가 증감9 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_icdc10 | 시간외 단일가 매도호가 증감10 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc1 | 시간외 단일가 매수호가 증감1 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc2 | 시간외 단일가 매수호가 증감2 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc3 | 시간외 단일가 매수호가 증감3 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc4 | 시간외 단일가 매수호가 증감4 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc5 | 시간외 단일가 매수호가 증감5 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc6 | 시간외 단일가 매수호가 증감6 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc7 | 시간외 단일가 매수호가 증감7 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc8 | 시간외 단일가 매수호가 증감8 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc9 | 시간외 단일가 매수호가 증감9 | string | Y | 10 | |
|
||||
| ovtm_untp_bidp_icdc10 | 시간외 단일가 매수호가 증감10 | string | Y | 10 | |
|
||||
| ovtm_untp_askp_rsqn1 | 시간외 단일가 매도호가 잔량1 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn2 | 시간외 단일가 매도호가 잔량2 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn3 | 시간외 단일가 매도호가 잔량3 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn4 | 시간외 단일가 매도호가 잔량4 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn5 | 시간외 단일가 매도호가 잔량5 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn6 | 시간외 단일가 매도호가 잔량6 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn7 | 시간외 단일가 매도호가 잔량7 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn8 | 시간외 단일가 매도호가 잔량8 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn9 | 시간외 단일가 매도호가 잔량9 | string | Y | 12 | |
|
||||
| ovtm_untp_askp_rsqn10 | 시간외 단일가 매도호가 잔량10 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn1 | 시간외 단일가 매수호가 잔량1 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn2 | 시간외 단일가 매수호가 잔량2 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn3 | 시간외 단일가 매수호가 잔량3 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn4 | 시간외 단일가 매수호가 잔량4 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn5 | 시간외 단일가 매수호가 잔량5 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn6 | 시간외 단일가 매수호가 잔량6 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn7 | 시간외 단일가 매수호가 잔량7 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn8 | 시간외 단일가 매수호가 잔량8 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn9 | 시간외 단일가 매수호가 잔량9 | string | Y | 12 | |
|
||||
| ovtm_untp_bidp_rsqn10 | 시간외 단일가 매수호가 잔량10 | string | Y | 12 | |
|
||||
| ovtm_untp_total_askp_rsqn | 시간외 단일가 총 매도호가 잔량 | string | Y | 12 | |
|
||||
| ovtm_untp_total_bidp_rsqn | 시간외 단일가 총 매수호가 잔량 | string | Y | 12 | |
|
||||
| ovtm_untp_total_askp_rsqn_icdc | 시간외 단일가 총 매도호가 잔량 | string | Y | 10 | |
|
||||
| ovtm_untp_total_bidp_rsqn_icdc | 시간외 단일가 총 매수호가 잔량 | string | Y | 10 | |
|
||||
| ovtm_untp_ntby_bidp_rsqn | 시간외 단일가 순매수 호가 잔량 | string | Y | 12 | |
|
||||
| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
|
||||
| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
|
||||
| total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | string | Y | 10 | |
|
||||
| total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | string | Y | 10 | |
|
||||
| ovtm_total_askp_rsqn | 시간외 총 매도호가 잔량 | string | Y | 12 | |
|
||||
| ovtm_total_bidp_rsqn | 시간외 총 매수호가 잔량 | string | Y | 12 | |
|
||||
| ovtm_total_askp_icdc | 시간외 총 매도호가 증감 | string | Y | 10 | |
|
||||
| ovtm_total_bidp_icdc | 시간외 총 매수호가 증감 | string | Y | 10 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
fid_cond_mrkt_div_code:J
|
||||
fid_input_iscd:005930
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"ovtm_untp_last_hour": "161847",
|
||||
"ovtm_untp_askp1": "83600",
|
||||
"ovtm_untp_askp2": "83700",
|
||||
"ovtm_untp_askp3": "83800",
|
||||
"ovtm_untp_askp4": "0",
|
||||
"ovtm_untp_askp5": "0",
|
||||
"ovtm_untp_askp6": "0",
|
||||
"ovtm_untp_askp7": "0",
|
||||
"ovtm_untp_askp8": "0",
|
||||
"ovtm_untp_askp9": "0",
|
||||
"ovtm_untp_askp10": "0",
|
||||
"ovtm_untp_bidp1": "83500",
|
||||
"ovtm_untp_bidp2": "83400",
|
||||
"ovtm_untp_bidp3": "83300",
|
||||
"ovtm_untp_bidp4": "0",
|
||||
"ovtm_untp_bidp5": "0",
|
||||
"ovtm_untp_bidp6": "0",
|
||||
"ovtm_untp_bidp7": "0",
|
||||
"ovtm_untp_bidp8": "0",
|
||||
"ovtm_untp_bidp9": "0",
|
||||
"ovtm_untp_bidp10": "0",
|
||||
"ovtm_untp_askp_icdc1": "0",
|
||||
"ovtm_untp_askp_icdc2": "0",
|
||||
"ovtm_untp_askp_icdc3": "0",
|
||||
"ovtm_untp_bidp_icdc1": "1",
|
||||
"ovtm_untp_bidp_icdc2": "0",
|
||||
"ovtm_untp_bidp_icdc3": "0",
|
||||
"ovtm_untp_askp_rsqn1": "4498",
|
||||
"ovtm_untp_askp_rsqn2": "11671",
|
||||
"ovtm_untp_askp_rsqn3": "9625",
|
||||
"ovtm_untp_askp_rsqn4": "0",
|
||||
"ovtm_untp_askp_rsqn5": "0",
|
||||
"ovtm_untp_askp_rsqn6": "0",
|
||||
"ovtm_untp_askp_rsqn7": "0",
|
||||
"ovtm_untp_askp_rsqn8": "0",
|
||||
"ovtm_untp_askp_rsqn9": "0",
|
||||
"ovtm_untp_askp_rsqn10": "0",
|
||||
"ovtm_untp_bidp_rsqn1": "1219",
|
||||
"ovtm_untp_bidp_rsqn2": "2242",
|
||||
"ovtm_untp_bidp_rsqn3": "5603",
|
||||
"ovtm_untp_bidp_rsqn4": "0",
|
||||
"ovtm_untp_bidp_rsqn5": "0",
|
||||
"ovtm_untp_bidp_rsqn6": "0",
|
||||
"ovtm_untp_bidp_rsqn7": "0",
|
||||
"ovtm_untp_bidp_rsqn8": "0",
|
||||
"ovtm_untp_bidp_rsqn9": "0",
|
||||
"ovtm_untp_bidp_rsqn10": "0",
|
||||
"ovtm_untp_total_askp_rsqn": "25794",
|
||||
"ovtm_untp_total_bidp_rsqn": "9064",
|
||||
"ovtm_untp_total_askp_rsqn_icdc": "0",
|
||||
"ovtm_untp_total_bidp_rsqn_icdc": "1",
|
||||
"ovtm_untp_ntby_bidp_rsqn": "-16730",
|
||||
"total_askp_rsqn": "923970",
|
||||
"total_bidp_rsqn": "756893",
|
||||
"total_askp_rsqn_icdc": "0",
|
||||
"total_bidp_rsqn_icdc": "0",
|
||||
"ovtm_total_askp_rsqn": "36230",
|
||||
"ovtm_total_bidp_rsqn": "0",
|
||||
"ovtm_total_askp_icdc": "0",
|
||||
"ovtm_total_bidp_icdc": "0"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,150 @@
|
||||
# 주식현재가 당일시간대별체결
|
||||
|
||||
- 원본 시트명: 주식현재가 당일시간대별체결
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-023
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST01060000
|
||||
- 모의 TR_ID: FHPST01060000
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-itemconclusion
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 당일시간대별체결 API입니다.
|
||||
|
||||
* FID_INPUT_HOUR_1 를 이용하여 과거시간대 체결데이터 확인 가능
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHPST01060000 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
| FID_INPUT_HOUR_1 | 입력 시간1 | 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 | |
|
||||
| output1 | 응답상세 | object | Y | | single |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| prdy_vol | 전일 거래량 | string | Y | 18 | |
|
||||
| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
|
||||
| output2 | 응답상세 | object | Y | | single |
|
||||
| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
|
||||
| stck_pbpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
|
||||
| askp | 매도호가 | string | Y | 10 | |
|
||||
| bidp | 매수호가 | string | Y | 10 | |
|
||||
| tday_rltv | 당일 체결강도 | string | Y | 14 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| cnqn | 체결량 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
"input": {
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_hour_1": "141200",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
"output1": {
|
||||
"acml_vol": "2315529",
|
||||
"prdy_ctrt": "-2.80",
|
||||
"prdy_vol": "1638006",
|
||||
"prdy_vrss": "-3000",
|
||||
"prdy_vrss_sign": "5",
|
||||
"rprs_mrkt_kor_name": "KOSPI200",
|
||||
"stck_prpr": "104000"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"acml_vol": "1979727",
|
||||
"askp": "105000",
|
||||
"bidp": "104500",
|
||||
"cnqn": "20",
|
||||
"prdy_ctrt": "-2.34",
|
||||
"prdy_vrss": "-2500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "141159",
|
||||
"stck_prpr": "104500",
|
||||
"tday_rltv": "42.43"
|
||||
},
|
||||
{
|
||||
"acml_vol": "1979707",
|
||||
"askp": "105000",
|
||||
"bidp": "104500",
|
||||
"cnqn": "4",
|
||||
"prdy_ctrt": "-2.34",
|
||||
"prdy_vrss": "-2500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "141158",
|
||||
"stck_prpr": "104500",
|
||||
"tday_rltv": "42.43"
|
||||
},
|
||||
....
|
||||
{
|
||||
"acml_vol": "1979079",
|
||||
"askp": "105000",
|
||||
"bidp": "104500",
|
||||
"cnqn": "92",
|
||||
"prdy_ctrt": "-2.34",
|
||||
"prdy_vrss": "-2500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_cntg_hour": "141142",
|
||||
"stck_prpr": "104500",
|
||||
"tday_rltv": "42.44"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0"
|
||||
```
|
||||
@@ -0,0 +1,188 @@
|
||||
# 주식현재가 시세2
|
||||
|
||||
- 원본 시트명: 주식현재가 시세2
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-054
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST01010000
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-price-2
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 시세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 | FHPST01010000 |
|
||||
| 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 | FID 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | FID 입력 종목코드 | 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 | Y | | |
|
||||
| rprs_mrkt_kor_name | 대표 시장 한글 명 | string | Y | 40 | |
|
||||
| new_hgpr_lwpr_cls_code | 신 고가 저가 구분 코드 | string | Y | 10 | 특정 경우에만 데이터 출력 |
|
||||
| mxpr_llam_cls_code | 상하한가 구분 코드 | string | Y | 10 | 특정 경우에만 데이터 출력 |
|
||||
| crdt_able_yn | 신용 가능 여부 | string | Y | 1 | |
|
||||
| stck_mxpr | 주식 상한가 | string | Y | 10 | |
|
||||
| elw_pblc_yn | ELW 발행 여부 | string | Y | 1 | |
|
||||
| prdy_clpr_vrss_oprc_rate | 전일 종가 대비 시가2 비율 | string | Y | 84 | |
|
||||
| crdt_rate | 신용 비율 | string | Y | 84 | |
|
||||
| marg_rate | 증거금 비율 | string | Y | 84 | |
|
||||
| lwpr_vrss_prpr | 최저가 대비 현재가 | string | Y | 10 | |
|
||||
| lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | string | Y | 1 | |
|
||||
| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 84 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| hgpr_vrss_prpr | 최고가 대비 현재가 | string | Y | 10 | |
|
||||
| hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | string | Y | 1 | |
|
||||
| prdy_clpr_vrss_hgpr_rate | 전일 종가 대비 최고가 비율 | string | Y | 84 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| oprc_vrss_prpr | 시가2 대비 현재가 | string | Y | 10 | |
|
||||
| oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | string | Y | 1 | |
|
||||
| mang_issu_yn | 관리 종목 여부 | string | Y | 1 | |
|
||||
| divi_app_cls_code | 동시호가배분처리코드 | string | Y | 2 | 11:매수상한배분 12:매수하한배분 13: 매도상한배분 14:매도하한배분 |
|
||||
| short_over_yn | 단기과열여부 | string | Y | 1 | |
|
||||
| mrkt_warn_cls_code | 시장경고코드 | string | Y | 2 | 00: 없음 01: 투자주의 02:투자경고 03:투자위험 |
|
||||
| invt_caful_yn | 투자유의여부 | string | Y | 1 | |
|
||||
| stange_runup_yn | 이상급등여부 | string | Y | 1 | |
|
||||
| ssts_hot_yn | 공매도과열 여부 | string | Y | 1 | |
|
||||
| low_current_yn | 저유동성 종목 여부 | string | Y | 1 | |
|
||||
| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
|
||||
| short_over_cls_code | 단기과열구분코드 | string | Y | 10 | |
|
||||
| stck_llam | 주식 하한가 | string | Y | 10 | |
|
||||
| new_lstn_cls_name | 신규 상장 구분 명 | string | Y | 40 | |
|
||||
| vlnt_deal_cls_name | 임의 매매 구분 명 | string | Y | 16 | |
|
||||
| flng_cls_name | 락 구분 이름 | string | Y | 40 | 특정 경우에만 데이터 출력 |
|
||||
| revl_issu_reas_name | 재평가 종목 사유 명 | string | Y | 40 | 특정 경우에만 데이터 출력 |
|
||||
| mrkt_warn_cls_name | 시장 경고 구분 명 | string | Y | 40 | 특정 경우에만 데이터 출력<br>"투자환기" / "투자경고" |
|
||||
| stck_sdpr | 주식 기준가 | string | Y | 10 | |
|
||||
| bstp_cls_code | 업종 구분 코드 | string | Y | 4 | |
|
||||
| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
|
||||
| insn_pbnt_yn | 불성실 공시 여부 | string | Y | 1 | |
|
||||
| fcam_mod_cls_name | 액면가 변경 구분 명 | string | Y | 10 | 특정 경우에만 데이터 출력 |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| prdy_vrss_vol_rate | 전일 대비 거래량 비율 | string | Y | 84 | |
|
||||
| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
|
||||
| sltr_yn | 정리매매 여부 | string | Y | 1 | |
|
||||
| trht_yn | 거래정지 여부 | string | Y | 1 | |
|
||||
| oprc_rang_cont_yn | 시가 범위 연장 여부 | string | Y | 1 | |
|
||||
| vlnt_fin_cls_code | 임의 종료 구분 코드 | string | Y | 1 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| prdy_vol | 전일 거래량 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code":"J",
|
||||
"fid_input_iscd":"005930"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"rprs_mrkt_kor_name": "KOSPI200",
|
||||
"insn_pbnt_yn": "N",
|
||||
"stck_prpr": "74400",
|
||||
"prdy_vrss": "1000",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "1.36",
|
||||
"acml_tr_pbmn": "276161183000",
|
||||
"acml_vol": "3733708",
|
||||
"prdy_vol": "11160062",
|
||||
"prdy_vrss_vol_rate": "33.46",
|
||||
"bstp_kor_isnm": "전기.전자",
|
||||
"sltr_yn": "N",
|
||||
"mang_issu_yn": "N",
|
||||
"trht_yn": "N",
|
||||
"oprc_rang_cont_yn": "N",
|
||||
"vlnt_fin_cls_code": "N",
|
||||
"stck_prdy_clpr": "73400",
|
||||
"stck_oprc": "73800",
|
||||
"prdy_clpr_vrss_oprc_rate": "0.54",
|
||||
"oprc_vrss_prpr_sign": "2",
|
||||
"oprc_vrss_prpr": "600",
|
||||
"stck_hgpr": "74500",
|
||||
"prdy_clpr_vrss_hgpr_rate": "1.50",
|
||||
"hgpr_vrss_prpr_sign": "5",
|
||||
"hgpr_vrss_prpr": "-100",
|
||||
"stck_lwpr": "73500",
|
||||
"prdy_clpr_vrss_lwpr_rate": "0.14",
|
||||
"lwpr_vrss_prpr_sign": "2",
|
||||
"lwpr_vrss_prpr": "900",
|
||||
"marg_rate": "20.00",
|
||||
"crdt_rate": "20.00",
|
||||
"crdt_able_yn": "Y",
|
||||
"elw_pblc_yn": "Y",
|
||||
"stck_mxpr": "95400",
|
||||
"stck_llam": "51400",
|
||||
"bstp_cls_code": "005930",
|
||||
"stck_sdpr": "73400",
|
||||
"vlnt_deal_cls_name": " ",
|
||||
"new_lstn_cls_name": " ",
|
||||
"divi_app_cls_code": " ",
|
||||
"short_over_cls_code": " ",
|
||||
"vi_cls_code": "N",
|
||||
"low_current_yn": "N",
|
||||
"ssts_hot_yn": " ",
|
||||
"stange_runup_yn": "N",
|
||||
"invt_caful_yn": "N",
|
||||
"mrkt_warn_cls_code": "00",
|
||||
"short_over_yn": "N"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,155 @@
|
||||
# 주식일별분봉조회
|
||||
|
||||
- 원본 시트명: 주식일별분봉조회
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: 국내주식-213
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST03010230
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-dailychartprice
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식일별분봉조회 API입니다.
|
||||
|
||||
실전계좌의 경우, 한 번의 호출에 최대 120건까지 확인 가능하며,
|
||||
FID_INPUT_DATE_1, FID_INPUT_HOUR_1 이용하여 과거일자 분봉조회 가능합니다.
|
||||
|
||||
※ 과거 분봉 조회 시, 당사 서버에서 보관하고 있는 만큼의 데이터만 확인이 가능합니다. (최대 1년 분봉 보관)
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHKST03010230 |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
|
||||
| custtype | 고객 타입 | string | Y | 1 | B : 법인 <br>P : 개인 |
|
||||
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
|
||||
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
|
||||
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 <br>ex) 01011112222 (하이픈 등 구분값 제거) |
|
||||
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Request Query Parameter
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 입력 시간(ex 13시 130000) |
|
||||
| FID_INPUT_DATE_1 | 입력 날짜1 | string | Y | 2 | 입력 날짜(20241023) |
|
||||
| FID_PW_DATA_INCU_YN | 과거 데이터 포함 여부 | string | Y | 2 | |
|
||||
| FID_FAKE_TICK_INCU_YN | 허봉 포함 여부 | string | N | 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 | 공백 : 초기 조회 <br>N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | |
|
||||
| output1 | 응답상세 | object | Y | | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
|
||||
| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| output2 | 응답상세 | object array | Y | | array |
|
||||
| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
|
||||
| stck_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| cntg_vol | 체결 거래량 | string | Y | 18 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
FID_COND_MRKT_DIV_CODE:J
|
||||
FID_INPUT_ISCD:005930
|
||||
FID_INPUT_DATE_1:20241108
|
||||
FID_INPUT_HOUR_1:140000
|
||||
FID_PW_DATA_INCU_YN:Y
|
||||
FID_FAKE_TICK_INCU_YN:N
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output1": {
|
||||
"prdy_vrss": "-500",
|
||||
"prdy_vrss_sign": "5",
|
||||
"prdy_ctrt": "-0.87",
|
||||
"stck_prdy_clpr": "57500",
|
||||
"acml_vol": "13531211",
|
||||
"acml_tr_pbmn": "779692013500",
|
||||
"hts_kor_isnm": "삼성전자",
|
||||
"stck_prpr": "57000"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"stck_bsop_date": "20241108",
|
||||
"stck_cntg_hour": "140000",
|
||||
"stck_prpr": "57300",
|
||||
"stck_oprc": "57300",
|
||||
"stck_hgpr": "57400",
|
||||
"stck_lwpr": "57200",
|
||||
"cntg_vol": "59047",
|
||||
"acml_tr_pbmn": "538940180600"
|
||||
},
|
||||
{
|
||||
"stck_bsop_date": "20241108",
|
||||
"stck_cntg_hour": "135900",
|
||||
"stck_prpr": "57300",
|
||||
"stck_oprc": "57400",
|
||||
"stck_hgpr": "57500",
|
||||
"stck_lwpr": "57300",
|
||||
"cntg_vol": "118619",
|
||||
"acml_tr_pbmn": "535556648100"
|
||||
},
|
||||
...
|
||||
{
|
||||
"stck_bsop_date": "20241108",
|
||||
"stck_cntg_hour": "120100",
|
||||
"stck_prpr": "57700",
|
||||
"stck_oprc": "57700",
|
||||
"stck_hgpr": "57800",
|
||||
"stck_lwpr": "57700",
|
||||
"cntg_vol": "3856",
|
||||
"acml_tr_pbmn": "357875441100"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,182 @@
|
||||
# 국내주식기간별시세(일_주_월_년)
|
||||
|
||||
- 원본 시트명: 국내주식기간별시세(일_주_월_년)
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-016
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST03010100
|
||||
- 모의 TR_ID: FHKST03010100
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-daily-itemchartprice
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
국내주식기간별시세(일/주/월/년) 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 | FHKST03010100 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
| FID_INPUT_DATE_1 | 입력 날짜 1 | string | Y | 10 | 조회 시작일자 |
|
||||
| FID_INPUT_DATE_2 | 입력 날짜 2 | string | Y | 10 | 조회 종료일자 (최대 100개) |
|
||||
| FID_PERIOD_DIV_CODE | 기간분류코드 | string | Y | 32 | D:일봉 W:주봉, M:월봉, Y:년봉 |
|
||||
| FID_ORG_ADJ_PRC | 수정주가 원주가 가격 여부 | string | Y | 10 | 0:수정주가 1:원주가 |
|
||||
|
||||
### 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 | | single |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 11 | |
|
||||
| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
|
||||
| prdy_vol | 전일 거래량 | string | Y | 18 | |
|
||||
| stck_mxpr | 주식 상한가 | string | Y | 10 | |
|
||||
| stck_llam | 주식 하한가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| stck_prdy_oprc | 주식 전일 시가 | string | Y | 10 | |
|
||||
| stck_prdy_hgpr | 주식 전일 최고가 | string | Y | 10 | |
|
||||
| stck_prdy_lwpr | 주식 전일 최저가 | string | Y | 10 | |
|
||||
| askp | 매도호가 | string | Y | 10 | |
|
||||
| bidp | 매수호가 | string | Y | 10 | |
|
||||
| prdy_vrss_vol | 전일 대비 거래량 | string | Y | 18 | |
|
||||
| vol_tnrt | 거래량 회전율 | string | Y | 11 | 11(8.2) |
|
||||
| stck_fcam | 주식 액면가 | string | Y | 11 | |
|
||||
| lstn_stcn | 상장 주수 | string | Y | 18 | |
|
||||
| cpfn | 자본금 | string | Y | 22 | |
|
||||
| hts_avls | HTS 시가총액 | string | Y | 18 | |
|
||||
| per | PER | string | Y | 11 | 11(8.2) |
|
||||
| eps | EPS | string | Y | 14 | 14(11.2) |
|
||||
| pbr | PBR | string | Y | 11 | 11(8.2) |
|
||||
| itewhol_loan_rmnd_ratem | 전체 융자 잔고 비율 | string | Y | 13 | 13(8.4) |
|
||||
| output2 | 응답상세 | object array | Y | | Array |
|
||||
| stck_bsop_date | 주식 영업 일자 | string | Y | 8 | |
|
||||
| stck_clpr | 주식 종가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| acml_tr_pbmn | 누적 거래 대금 | string | Y | 18 | |
|
||||
| flng_cls_code | 락 구분 코드 | string | Y | 2 | 01 : 권리락<br>02 : 배당락<br>03 : 분배락<br>04 : 권배락<br>05 : 중간(분기)배당락<br>06 : 권리중간배당락<br>07 : 권리분기배당락 |
|
||||
| prtt_rate | 분할 비율 | string | Y | 11 | 기준가/전일 종가 |
|
||||
| mod_yn | 변경 여부 | string | Y | 1 | 현재 영업일에 체결이 발생하지 않아 시가가 없을경우 Y 로 표시(차트에서 사용) |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| revl_issu_reas | 재평가사유코드 | string | Y | 2 | 00:해당없음<br>01:회사분할<br>02:자본감소<br>03:장기간정지<br>04:초과분배<br>05:대규모배당<br>06:회사분할합병<br>07:ETN증권병합/분할<br>08:신종증권기세조정<br>99:기타 |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
"input": {
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_date_1": "20220411",
|
||||
"fid_input_date_2": "20220509",
|
||||
"fid_input_iscd": "000660",
|
||||
"fid_org_adj_prc": "0",
|
||||
"fid_period_div_code": "D"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
"msg_cd": "MCA00000",
|
||||
"output1": {
|
||||
"acml_tr_pbmn": "236062833000",
|
||||
"acml_vol": "2106409",
|
||||
"askp": "112500",
|
||||
"bidp": "112000",
|
||||
"cpfn": "36577",
|
||||
"eps": "13190.00",
|
||||
"hts_avls": "815363",
|
||||
"hts_kor_isnm": "SK\ud558\uc774\ub2c9\uc2a4",
|
||||
"itewhol_loan_rmnd_ratem name": "0.32",
|
||||
"lstn_stcn": "728002365",
|
||||
"pbr": "1.26",
|
||||
"per": "8.49",
|
||||
"prdy_ctrt": "0.90",
|
||||
"prdy_vol": "3680049",
|
||||
"prdy_vrss": "1000",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_vrss_vol": "-1573640",
|
||||
"stck_fcam": "5000",
|
||||
"stck_hgpr": "113000",
|
||||
"stck_llam": "78000",
|
||||
"stck_lwpr": "111000",
|
||||
"stck_mxpr": "144000",
|
||||
"stck_oprc": "111500",
|
||||
"stck_prdy_clpr": "111000",
|
||||
"stck_prdy_hgpr": "112500",
|
||||
"stck_prdy_lwpr": "110000",
|
||||
"stck_prdy_oprc": "110500",
|
||||
"stck_prpr": "112000",
|
||||
"stck_shrn_iscd": "000660",
|
||||
"vol_tnrt": "0.29"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"acml_tr_pbmn": "237914727500",
|
||||
"acml_vol": "2203472",
|
||||
"flng_cls_code": "00",
|
||||
"mod_yn": "N",
|
||||
"prdy_vrss": "0",
|
||||
"prdy_vrss_sign": "3",
|
||||
"prtt_rate": "0.00",
|
||||
"revl_issu_reas": "",
|
||||
"stck_bsop_date": "20220509",
|
||||
"stck_clpr": "107500",
|
||||
"stck_hgpr": "109000",
|
||||
"stck_lwpr": "106500",
|
||||
"stck_oprc": "107000"
|
||||
},
|
||||
....
|
||||
```
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,257 @@
|
||||
# 주식현재가 호가_예상체결
|
||||
|
||||
- 원본 시트명: 주식현재가 호가_예상체결
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-011
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010200
|
||||
- 모의 TR_ID: FHKST01010200
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-asking-price-exp-ccn
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 호가 예상체결 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 | FHKST01010200 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
|
||||
### 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 | | |
|
||||
| aspr_acpt_hour | 호가 접수 시간 | string | Y | 6 | |
|
||||
| askp1 | 매도호가1 | string | Y | 10 | |
|
||||
| askp2 | 매도호가2 | string | Y | 10 | |
|
||||
| askp3 | 매도호가3 | string | Y | 10 | |
|
||||
| askp4 | 매도호가4 | string | Y | 10 | |
|
||||
| askp5 | 매도호가5 | string | Y | 10 | |
|
||||
| askp6 | 매도호가6 | string | Y | 10 | |
|
||||
| askp7 | 매도호가7 | string | Y | 10 | |
|
||||
| askp8 | 매도호가8 | string | Y | 10 | |
|
||||
| askp9 | 매도호가9 | string | Y | 10 | |
|
||||
| askp10 | 매도호가10 | string | Y | 10 | |
|
||||
| bidp1 | 매수호가1 | string | Y | 10 | |
|
||||
| bidp2 | 매수호가2 | string | Y | 10 | |
|
||||
| bidp3 | 매수호가3 | string | Y | 10 | |
|
||||
| bidp4 | 매수호가4 | string | Y | 10 | |
|
||||
| bidp5 | 매수호가5 | string | Y | 10 | |
|
||||
| bidp6 | 매수호가6 | string | Y | 10 | |
|
||||
| bidp7 | 매수호가7 | string | Y | 10 | |
|
||||
| bidp8 | 매수호가8 | string | Y | 10 | |
|
||||
| bidp9 | 매수호가9 | string | Y | 10 | |
|
||||
| bidp10 | 매수호가10 | string | Y | 10 | |
|
||||
| askp_rsqn1 | 매도호가 잔량1 | string | Y | 12 | |
|
||||
| askp_rsqn2 | 매도호가 잔량2 | string | Y | 12 | |
|
||||
| askp_rsqn3 | 매도호가 잔량3 | string | Y | 12 | |
|
||||
| askp_rsqn4 | 매도호가 잔량4 | string | Y | 12 | |
|
||||
| askp_rsqn5 | 매도호가 잔량5 | string | Y | 12 | |
|
||||
| askp_rsqn6 | 매도호가 잔량6 | string | Y | 12 | |
|
||||
| askp_rsqn7 | 매도호가 잔량7 | string | Y | 12 | |
|
||||
| askp_rsqn8 | 매도호가 잔량8 | string | Y | 12 | |
|
||||
| askp_rsqn9 | 매도호가 잔량9 | string | Y | 12 | |
|
||||
| askp_rsqn10 | 매도호가 잔량10 | string | Y | 12 | |
|
||||
| bidp_rsqn1 | 매수호가 잔량1 | string | Y | 12 | |
|
||||
| bidp_rsqn2 | 매수호가 잔량2 | string | Y | 12 | |
|
||||
| bidp_rsqn3 | 매수호가 잔량3 | string | Y | 12 | |
|
||||
| bidp_rsqn4 | 매수호가 잔량4 | string | Y | 12 | |
|
||||
| bidp_rsqn5 | 매수호가 잔량5 | string | Y | 12 | |
|
||||
| bidp_rsqn6 | 매수호가 잔량6 | string | Y | 12 | |
|
||||
| bidp_rsqn7 | 매수호가 잔량7 | string | Y | 12 | |
|
||||
| bidp_rsqn8 | 매수호가 잔량8 | string | Y | 12 | |
|
||||
| bidp_rsqn9 | 매수호가 잔량9 | string | Y | 12 | |
|
||||
| bidp_rsqn10 | 매수호가 잔량10 | string | Y | 12 | |
|
||||
| askp_rsqn_icdc1 | 매도호가 잔량 증감1 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc2 | 매도호가 잔량 증감2 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc3 | 매도호가 잔량 증감3 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc4 | 매도호가 잔량 증감4 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc5 | 매도호가 잔량 증감5 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc6 | 매도호가 잔량 증감6 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc7 | 매도호가 잔량 증감7 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc8 | 매도호가 잔량 증감8 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc9 | 매도호가 잔량 증감9 | string | Y | 10 | |
|
||||
| askp_rsqn_icdc10 | 매도호가 잔량 증감10 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc1 | 매수호가 잔량 증감1 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc2 | 매수호가 잔량 증감2 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc3 | 매수호가 잔량 증감3 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc4 | 매수호가 잔량 증감4 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc5 | 매수호가 잔량 증감5 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc6 | 매수호가 잔량 증감6 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc7 | 매수호가 잔량 증감7 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc8 | 매수호가 잔량 증감8 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc9 | 매수호가 잔량 증감9 | string | Y | 10 | |
|
||||
| bidp_rsqn_icdc10 | 매수호가 잔량 증감10 | string | Y | 10 | |
|
||||
| total_askp_rsqn | 총 매도호가 잔량 | string | Y | 12 | |
|
||||
| total_bidp_rsqn | 총 매수호가 잔량 | string | Y | 12 | |
|
||||
| total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | string | Y | 10 | |
|
||||
| total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | string | Y | 10 | |
|
||||
| ovtm_total_askp_icdc | 시간외 총 매도호가 증감 | string | Y | 10 | |
|
||||
| ovtm_total_bidp_icdc | 시간외 총 매수호가 증감 | string | Y | 10 | |
|
||||
| ovtm_total_askp_rsqn | 시간외 총 매도호가 잔량 | string | Y | 12 | |
|
||||
| ovtm_total_bidp_rsqn | 시간외 총 매수호가 잔량 | string | Y | 12 | |
|
||||
| ntby_aspr_rsqn | 순매수 호가 잔량 | string | Y | 12 | |
|
||||
| new_mkop_cls_code | 신 장운영 구분 코드 | string | Y | 2 | ' '00' : 장전 예상체결가와 장마감 동시호가<br>'49' : 장후 예상체결가<br><br>(1) 첫 번째 비트<br>1 : 장개시전<br>2 : 장중<br>3 : 장종료후<br>4 : 시간외단일가<br>7 : 일반Buy-in<br>8 : 당일Buy-in<br>(2) 두 번째 비트<br>0 : 보통<br>1 : 종가<br>2 : 대량<br>3 : 바스켓<br>7 : 정리매매<br>8 : Buy-in' |
|
||||
| output2 | 응답상세 | object | Y | | |
|
||||
| antc_mkop_cls_code | 예상 장운영 구분 코드 | string | Y | 3 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| stck_sdpr | 주식 기준가 | string | Y | 10 | |
|
||||
| antc_cnpr | 예상 체결가 | string | Y | 10 | |
|
||||
| antc_cntg_vrss_sign | 예상 체결 대비 부호 | string | Y | 1 | |
|
||||
| antc_cntg_vrss | 예상 체결 대비 | string | Y | 10 | |
|
||||
| antc_cntg_prdy_ctrt | 예상 체결 전일 대비율 | string | Y | 11 | |
|
||||
| antc_vol | 예상 거래량 | string | Y | 18 | |
|
||||
| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
|
||||
| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output1": {
|
||||
"aspr_acpt_hour": "160000",
|
||||
"askp1": "128000",
|
||||
"askp2": "128500",
|
||||
"askp3": "129000",
|
||||
"askp4": "129500",
|
||||
"askp5": "130000",
|
||||
"askp6": "130500",
|
||||
"askp7": "131000",
|
||||
"askp8": "131500",
|
||||
"askp9": "132000",
|
||||
"askp10": "132500",
|
||||
"bidp1": "127500",
|
||||
"bidp2": "127000",
|
||||
"bidp3": "126500",
|
||||
"bidp4": "126000",
|
||||
"bidp5": "125500",
|
||||
"bidp6": "125000",
|
||||
"bidp7": "124500",
|
||||
"bidp8": "124000",
|
||||
"bidp9": "123500",
|
||||
"bidp10": "123000",
|
||||
"askp_rsqn1": "69454",
|
||||
"askp_rsqn2": "189698",
|
||||
"askp_rsqn3": "154732",
|
||||
"askp_rsqn4": "85703",
|
||||
"askp_rsqn5": "158696",
|
||||
"askp_rsqn6": "31395",
|
||||
"askp_rsqn7": "50738",
|
||||
"askp_rsqn8": "21039",
|
||||
"askp_rsqn9": "39424",
|
||||
"askp_rsqn10": "29126",
|
||||
"bidp_rsqn1": "83147",
|
||||
"bidp_rsqn2": "27469",
|
||||
"bidp_rsqn3": "25200",
|
||||
"bidp_rsqn4": "18544",
|
||||
"bidp_rsqn5": "13251",
|
||||
"bidp_rsqn6": "15742",
|
||||
"bidp_rsqn7": "15070",
|
||||
"bidp_rsqn8": "24995",
|
||||
"bidp_rsqn9": "11658",
|
||||
"bidp_rsqn10": "15773",
|
||||
"askp_rsqn_icdc1": "0",
|
||||
"askp_rsqn_icdc2": "0",
|
||||
"askp_rsqn_icdc3": "0",
|
||||
"askp_rsqn_icdc4": "0",
|
||||
"askp_rsqn_icdc5": "0",
|
||||
"askp_rsqn_icdc6": "0",
|
||||
"askp_rsqn_icdc7": "0",
|
||||
"askp_rsqn_icdc8": "0",
|
||||
"askp_rsqn_icdc9": "0",
|
||||
"askp_rsqn_icdc10": "0",
|
||||
"bidp_rsqn_icdc1": "0",
|
||||
"bidp_rsqn_icdc2": "0",
|
||||
"bidp_rsqn_icdc3": "0",
|
||||
"bidp_rsqn_icdc4": "0",
|
||||
"bidp_rsqn_icdc5": "0",
|
||||
"bidp_rsqn_icdc6": "0",
|
||||
"bidp_rsqn_icdc7": "0",
|
||||
"bidp_rsqn_icdc8": "0",
|
||||
"bidp_rsqn_icdc9": "0",
|
||||
"bidp_rsqn_icdc10": "0",
|
||||
"total_askp_rsqn": "830005",
|
||||
"total_bidp_rsqn": "250849",
|
||||
"total_askp_rsqn_icdc": "0",
|
||||
"total_bidp_rsqn_icdc": "0",
|
||||
"ovtm_total_askp_icdc": "0",
|
||||
"ovtm_total_bidp_icdc": "0",
|
||||
"ovtm_total_askp_rsqn": "2943",
|
||||
"ovtm_total_bidp_rsqn": "0",
|
||||
"ntby_aspr_rsqn": "-579156",
|
||||
"new_mkop_cls_code": "31"
|
||||
},
|
||||
"output2": {
|
||||
"antc_mkop_cls_code": "112",
|
||||
"stck_prpr": "128000",
|
||||
"stck_oprc": "125500",
|
||||
"stck_hgpr": "128500",
|
||||
"stck_lwpr": "124500",
|
||||
"stck_sdpr": "124500",
|
||||
"antc_cnpr": "128000",
|
||||
"antc_cntg_vrss_sign": "2",
|
||||
"antc_cntg_vrss": "3500",
|
||||
"antc_cntg_prdy_ctrt": "2.81",
|
||||
"antc_vol": "220006",
|
||||
"stck_shrn_iscd": "000660",
|
||||
"vi_cls_code": "N"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,115 @@
|
||||
# 주식현재가 체결
|
||||
|
||||
- 원본 시트명: 주식현재가 체결
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-009
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010300
|
||||
- 모의 TR_ID: FHKST01010300
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-ccnl
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 체결 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [010] 현재가 화면 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
|
||||
|
||||
더 많은 체결데이터 확인이 필요할 경우 주식현재가 당일시간대별체결 API를 이용하세요
|
||||
(FID_INPUT_HOUR_1 를 이용하여 과거시간대 체결데이터 확인 가능)
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHKST01010300 |
|
||||
| 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 | 8 | J:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 2 | 종목코드 (ex 005930 삼성전자) |
|
||||
|
||||
### 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_cntg_hour | 주식 체결 시간 | string | Y | 6 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| cntg_vol | 체결 거래량 | string | Y | 18 | |
|
||||
| tday_rltv | 당일 체결강도 | string | Y | 112 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": [
|
||||
{
|
||||
"stck_cntg_hour": "155955",
|
||||
"stck_prpr": "78900",
|
||||
"prdy_vrss": "900",
|
||||
"prdy_vrss_sign": "2",
|
||||
"cntg_vol": "2",
|
||||
"tday_rltv": "114.05",
|
||||
"prdy_ctrt": "1.15"
|
||||
},
|
||||
{
|
||||
"stck_cntg_hour": "155935",
|
||||
"stck_prpr": "78900",
|
||||
"prdy_vrss": "900",
|
||||
"prdy_vrss_sign": "2",
|
||||
"cntg_vol": "10",
|
||||
"tday_rltv": "114.05",
|
||||
"prdy_ctrt": "1.15"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,220 @@
|
||||
# 주식현재가 회원사
|
||||
|
||||
- 원본 시트명: 주식현재가 회원사
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-013
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010600
|
||||
- 모의 TR_ID: FHKST01010600
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-member
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식 현재가 회원사 API입니다. 회원사의 투자 정보를 확인할 수 있습니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### Request Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | N | 40 | application/json; charset=utf-8 |
|
||||
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token<br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)<br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
|
||||
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
|
||||
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
|
||||
| tr_id | 거래ID | string | Y | 13 | [실전투자/모의투자]<br>FHKST01010600 : 주식현재가 회원사 |
|
||||
| tr_cont | 연속 거래 여부 | string | N | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| custtype | 고객타입 | string | N | 1 | B : 법인<br>P : 개인 |
|
||||
| seq_no | 일련번호 | string | N | 2 | [법인 필수] 001 |
|
||||
| mac_address | 맥주소 | string | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
|
||||
| phone_number | 핸드폰번호 | string | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호<br>ex) 01011112222 (하이픈 등 구분값 제거) |
|
||||
| ip_addr | 접속 단말 공인 IP | string | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
|
||||
| gt_uid | Global UID | string | N | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Request Query Parameter
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | string | Y | 2 | J:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | FID 입력 종목코드 | string | Y | 12 | 종목번호 (6자리)<br>ETN의 경우, Q로 시작 (EX. Q500001) |
|
||||
|
||||
### Response Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| tr_id | 거래ID | string | Y | 13 | 요청한 tr_id |
|
||||
| tr_cont | 연속 거래 여부 | string | Y | 1 | tr_cont를 이용한 다음조회 불가 API |
|
||||
| gt_uid | Global UID | string | Y | 32 | [법인 전용] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
|
||||
|
||||
### Response Body
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| rt_cd | 성공 실패 여부 | string | Y | 1 | 성공 실패 여부 <br>성공 : 0 실패 : 0외 값 |
|
||||
| msg_cd | 응답코드 | string | Y | 8 | 응답코드 |
|
||||
| msg1 | 응답메세지 | string | Y | 80 | 응답메세지 |
|
||||
| output | 응답상세 | array | Y | null | |
|
||||
| seln_mbcr_no1 | 매도 회원사 번호1 | string | Y | 5 | |
|
||||
| seln_mbcr_no2 | 매도 회원사 번호2 | string | Y | 5 | |
|
||||
| seln_mbcr_no3 | 매도 회원사 번호3 | string | Y | 5 | |
|
||||
| seln_mbcr_no4 | 매도 회원사 번호4 | string | Y | 5 | |
|
||||
| seln_mbcr_no5 | 매도 회원사 번호5 | string | Y | 5 | |
|
||||
| seln_mbcr_name1 | 매도 회원사 명1 | string | Y | 40 | |
|
||||
| seln_mbcr_name2 | 매도 회원사 명2 | string | Y | 40 | |
|
||||
| seln_mbcr_name3 | 매도 회원사 명3 | string | Y | 40 | |
|
||||
| seln_mbcr_name4 | 매도 회원사 명4 | string | Y | 40 | |
|
||||
| seln_mbcr_name5 | 매도 회원사 명5 | string | Y | 40 | |
|
||||
| total_seln_qty1 | 총 매도 수량1 | string | Y | 18 | |
|
||||
| total_seln_qty2 | 총 매도 수량2 | string | Y | 18 | |
|
||||
| total_seln_qty3 | 총 매도 수량3 | string | Y | 18 | |
|
||||
| total_seln_qty4 | 총 매도 수량4 | string | Y | 18 | |
|
||||
| total_seln_qty5 | 총 매도 수량5 | string | Y | 18 | |
|
||||
| seln_mbcr_rlim1 | 매도 회원사 비중1 | string | Y | 9 | |
|
||||
| seln_mbcr_rlim2 | 매도 회원사 비중2 | string | Y | 9 | |
|
||||
| seln_mbcr_rlim3 | 매도 회원사 비중3 | string | Y | 9 | |
|
||||
| seln_mbcr_rlim4 | 매도 회원사 비중4 | string | Y | 9 | |
|
||||
| seln_mbcr_rlim5 | 매도 회원사 비중5 | string | Y | 9 | |
|
||||
| seln_qty_icdc1 | 매도 수량 증감1 | string | Y | 10 | |
|
||||
| seln_qty_icdc2 | 매도 수량 증감2 | string | Y | 10 | |
|
||||
| seln_qty_icdc3 | 매도 수량 증감3 | string | Y | 10 | |
|
||||
| seln_qty_icdc4 | 매도 수량 증감4 | string | Y | 10 | |
|
||||
| seln_qty_icdc5 | 매도 수량 증감5 | string | Y | 10 | |
|
||||
| shnu_mbcr_no1 | 매수2 회원사 번호1 | string | Y | 5 | |
|
||||
| shnu_mbcr_no2 | 매수2 회원사 번호2 | string | Y | 5 | |
|
||||
| shnu_mbcr_no3 | 매수2 회원사 번호3 | string | Y | 5 | |
|
||||
| shnu_mbcr_no4 | 매수2 회원사 번호4 | string | Y | 5 | |
|
||||
| shnu_mbcr_no5 | 매수2 회원사 번호5 | string | Y | 5 | |
|
||||
| shnu_mbcr_name1 | 매수2 회원사 명1 | string | Y | 40 | |
|
||||
| shnu_mbcr_name2 | 매수2 회원사 명2 | string | Y | 40 | |
|
||||
| shnu_mbcr_name3 | 매수2 회원사 명3 | string | Y | 40 | |
|
||||
| shnu_mbcr_name4 | 매수2 회원사 명4 | string | Y | 40 | |
|
||||
| shnu_mbcr_name5 | 매수2 회원사 명5 | string | Y | 40 | |
|
||||
| total_shnu_qty1 | 총 매수2 수량1 | string | Y | 18 | |
|
||||
| total_shnu_qty2 | 총 매수2 수량2 | string | Y | 18 | |
|
||||
| total_shnu_qty3 | 총 매수2 수량3 | string | Y | 18 | |
|
||||
| total_shnu_qty4 | 총 매수2 수량4 | string | Y | 18 | |
|
||||
| total_shnu_qty5 | 총 매수2 수량5 | string | Y | 18 | |
|
||||
| shnu_mbcr_rlim1 | 매수2 회원사 비중1 | string | Y | 9 | |
|
||||
| shnu_mbcr_rlim2 | 매수2 회원사 비중2 | string | Y | 9 | |
|
||||
| shnu_mbcr_rlim3 | 매수2 회원사 비중3 | string | Y | 9 | |
|
||||
| shnu_mbcr_rlim4 | 매수2 회원사 비중4 | string | Y | 9 | |
|
||||
| shnu_mbcr_rlim5 | 매수2 회원사 비중5 | string | Y | 9 | |
|
||||
| shnu_qty_icdc1 | 매수2 수량 증감1 | string | Y | 10 | |
|
||||
| shnu_qty_icdc2 | 매수2 수량 증감2 | string | Y | 10 | |
|
||||
| shnu_qty_icdc3 | 매수2 수량 증감3 | string | Y | 10 | |
|
||||
| shnu_qty_icdc4 | 매수2 수량 증감4 | string | Y | 10 | |
|
||||
| shnu_qty_icdc5 | 매수2 수량 증감5 | string | Y | 10 | |
|
||||
| glob_total_seln_qty | 외국계 총 매도 수량 | string | Y | 18 | |
|
||||
| glob_seln_rlim | 외국계 매도 비중 | string | Y | 9 | |
|
||||
| glob_ntby_qty | 외국계 순매수 수량 | string | Y | 12 | |
|
||||
| glob_total_shnu_qty | 외국계 총 매수2 수량 | string | Y | 18 | |
|
||||
| glob_shnu_rlim | 외국계 매수2 비중 | string | Y | 9 | |
|
||||
| seln_mbcr_glob_yn_1 | 매도 회원사 외국계 여부1 | string | Y | 1 | |
|
||||
| seln_mbcr_glob_yn_2 | 매도 회원사 외국계 여부2 | string | Y | 1 | |
|
||||
| seln_mbcr_glob_yn_3 | 매도 회원사 외국계 여부3 | string | Y | 1 | |
|
||||
| seln_mbcr_glob_yn_4 | 매도 회원사 외국계 여부4 | string | Y | 1 | |
|
||||
| seln_mbcr_glob_yn_5 | 매도 회원사 외국계 여부5 | string | Y | 1 | |
|
||||
| shnu_mbcr_glob_yn_1 | 매수2 회원사 외국계 여부1 | string | Y | 1 | |
|
||||
| shnu_mbcr_glob_yn_2 | 매수2 회원사 외국계 여부2 | string | Y | 1 | |
|
||||
| shnu_mbcr_glob_yn_3 | 매수2 회원사 외국계 여부3 | string | Y | 1 | |
|
||||
| shnu_mbcr_glob_yn_4 | 매수2 회원사 외국계 여부4 | string | Y | 1 | |
|
||||
| shnu_mbcr_glob_yn_5 | 매수2 회원사 외국계 여부5 | string | Y | 1 | |
|
||||
| glob_total_seln_qty_icdc | 외국계 총 매도 수량 증감 | string | Y | 10 | |
|
||||
| glob_total_shnu_qty_icdc | 외국계 총 매수2 수량 증감 | string | Y | 10 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"seln_mbcr_no1": "00086",
|
||||
"seln_mbcr_no2": "00005",
|
||||
"seln_mbcr_no3": "00050",
|
||||
"seln_mbcr_no4": "00030",
|
||||
"seln_mbcr_no5": "00002",
|
||||
"seln_mbcr_name1": "BNK증권",
|
||||
"seln_mbcr_name2": "미래에셋증권",
|
||||
"seln_mbcr_name3": "키움증권",
|
||||
"seln_mbcr_name4": "삼성증권",
|
||||
"seln_mbcr_name5": "신한투자",
|
||||
"total_seln_qty1": "801848",
|
||||
"total_seln_qty2": "684589",
|
||||
"total_seln_qty3": "310639",
|
||||
"total_seln_qty4": "275035",
|
||||
"total_seln_qty5": "235001",
|
||||
"seln_mbcr_rlim1": "20.52",
|
||||
"seln_mbcr_rlim2": "17.52",
|
||||
"seln_mbcr_rlim3": "7.95",
|
||||
"seln_mbcr_rlim4": "7.04",
|
||||
"seln_mbcr_rlim5": "6.01",
|
||||
"seln_qty_icdc1": "8000",
|
||||
"seln_qty_icdc2": "39472",
|
||||
"seln_qty_icdc3": "27755",
|
||||
"seln_qty_icdc4": "13612",
|
||||
"seln_qty_icdc5": "4047",
|
||||
"shnu_mbcr_no1": "00086",
|
||||
"shnu_mbcr_no2": "00005",
|
||||
"shnu_mbcr_no3": "00033",
|
||||
"shnu_mbcr_no4": "00045",
|
||||
"shnu_mbcr_no5": "00036",
|
||||
"shnu_mbcr_name1": "BNK증권",
|
||||
"shnu_mbcr_name2": "미래에셋증권",
|
||||
"shnu_mbcr_name3": "JP모간",
|
||||
"shnu_mbcr_name4": "골드만",
|
||||
"shnu_mbcr_name5": "모간서울",
|
||||
"total_shnu_qty1": "822175",
|
||||
"total_shnu_qty2": "598966",
|
||||
"total_shnu_qty3": "378758",
|
||||
"total_shnu_qty4": "354965",
|
||||
"total_shnu_qty5": "261357",
|
||||
"shnu_mbcr_rlim1": "21.04",
|
||||
"shnu_mbcr_rlim2": "15.33",
|
||||
"shnu_mbcr_rlim3": "9.69",
|
||||
"shnu_mbcr_rlim4": "9.08",
|
||||
"shnu_mbcr_rlim5": "6.69",
|
||||
"shnu_qty_icdc1": "0",
|
||||
"shnu_qty_icdc2": "2397",
|
||||
"shnu_qty_icdc3": "20698",
|
||||
"shnu_qty_icdc4": "17168",
|
||||
"shnu_qty_icdc5": "11893",
|
||||
"glob_total_seln_qty": "38125",
|
||||
"glob_seln_rlim": "0.98",
|
||||
"glob_ntby_qty": "1142513",
|
||||
"glob_total_shnu_qty": "1180638",
|
||||
"glob_shnu_rlim": "30.21",
|
||||
"seln_mbcr_glob_yn_1": "N",
|
||||
"seln_mbcr_glob_yn_2": "N",
|
||||
"seln_mbcr_glob_yn_3": "N",
|
||||
"seln_mbcr_glob_yn_4": "N",
|
||||
"seln_mbcr_glob_yn_5": "N",
|
||||
"shnu_mbcr_glob_yn_1": "N",
|
||||
"shnu_mbcr_glob_yn_2": "N",
|
||||
"shnu_mbcr_glob_yn_3": "Y",
|
||||
"shnu_mbcr_glob_yn_4": "Y",
|
||||
"shnu_mbcr_glob_yn_5": "Y",
|
||||
"glob_total_seln_qty_icdc": "0",
|
||||
"glob_total_shnu_qty_icdc": "49759"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,553 @@
|
||||
# NAV 비교추이(분)
|
||||
|
||||
- 원본 시트명: NAV 비교추이(분)
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-070
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02440100
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/etfetn/v1/quotations/nav-comparison-time-trend
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
NAV 비교추이(분) API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0244] ETF/ETN 비교추이(NAV/IIV) 좌측 화면 "분별" 비교추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
|
||||
실전계좌의 경우, 한 번의 호출에 최근 30건까지 확인 가능합니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHPST02440100 |
|
||||
| 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_hour_cls_code | FID 시간 구분 코드 | string | Y | 5 | 1분 :60, 3분: 180 … 120분:7200 |
|
||||
| fid_cond_mrkt_div_code | FID 조건 시장 분류 코드 | string | Y | 2 | E - 고정값 |
|
||||
| fid_input_iscd | FID 입력 종목코드 | string | Y | 12 | 종목코드 |
|
||||
|
||||
### 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 |
|
||||
| bsop_hour | 영업 시간 | string | Y | 6 | |
|
||||
| nav | NAV | string | Y | 112 | |
|
||||
| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
|
||||
| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
|
||||
| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 84 | |
|
||||
| nav_vrss_prpr | NAV 대비 현재가 | string | Y | 112 | |
|
||||
| dprt | 괴리율 | string | Y | 82 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| cntg_vol | 체결 거래량 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code":"E",
|
||||
"fid_input_iscd":"069500",
|
||||
"fid_hour_cls_code":"60"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": [
|
||||
{
|
||||
"bsop_hour": "153000",
|
||||
"nav": "36127.30",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "91.08",
|
||||
"nav_prdy_ctrt": "0.25",
|
||||
"nav_vrss_prpr": "-37.30",
|
||||
"dprt": "-0.10",
|
||||
"stck_prpr": "36090",
|
||||
"prdy_vrss": "110",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.31",
|
||||
"acml_vol": "3714732",
|
||||
"cntg_vol": "93993"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152900",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152800",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152700",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152600",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152500",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152400",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152300",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152200",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152100",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "152000",
|
||||
"nav": "36170.22",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "134.00",
|
||||
"nav_prdy_ctrt": "0.37",
|
||||
"nav_vrss_prpr": "-60.22",
|
||||
"dprt": "-0.17",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151900",
|
||||
"nav": "36160.15",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "123.93",
|
||||
"nav_prdy_ctrt": "0.34",
|
||||
"nav_vrss_prpr": "-50.15",
|
||||
"dprt": "-0.14",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3620739",
|
||||
"cntg_vol": "46"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151800",
|
||||
"nav": "36166.66",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "130.44",
|
||||
"nav_prdy_ctrt": "0.36",
|
||||
"nav_vrss_prpr": "-51.66",
|
||||
"dprt": "-0.14",
|
||||
"stck_prpr": "36115",
|
||||
"prdy_vrss": "135",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.38",
|
||||
"acml_vol": "3600900",
|
||||
"cntg_vol": "67"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151700",
|
||||
"nav": "36138.90",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "102.68",
|
||||
"nav_prdy_ctrt": "0.28",
|
||||
"nav_vrss_prpr": "-28.90",
|
||||
"dprt": "-0.08",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3574190",
|
||||
"cntg_vol": "100"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151600",
|
||||
"nav": "36151.53",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "115.31",
|
||||
"nav_prdy_ctrt": "0.32",
|
||||
"nav_vrss_prpr": "-36.53",
|
||||
"dprt": "-0.10",
|
||||
"stck_prpr": "36115",
|
||||
"prdy_vrss": "135",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.38",
|
||||
"acml_vol": "3566213",
|
||||
"cntg_vol": "127"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151500",
|
||||
"nav": "36148.81",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "112.59",
|
||||
"nav_prdy_ctrt": "0.31",
|
||||
"nav_vrss_prpr": "-38.81",
|
||||
"dprt": "-0.11",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3561650",
|
||||
"cntg_vol": "1"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151400",
|
||||
"nav": "36144.32",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "108.10",
|
||||
"nav_prdy_ctrt": "0.30",
|
||||
"nav_vrss_prpr": "-34.32",
|
||||
"dprt": "-0.09",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3554609",
|
||||
"cntg_vol": "20"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151300",
|
||||
"nav": "36153.81",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "117.59",
|
||||
"nav_prdy_ctrt": "0.33",
|
||||
"nav_vrss_prpr": "-38.81",
|
||||
"dprt": "-0.11",
|
||||
"stck_prpr": "36115",
|
||||
"prdy_vrss": "135",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.38",
|
||||
"acml_vol": "3548014",
|
||||
"cntg_vol": "17"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151200",
|
||||
"nav": "36146.99",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "110.77",
|
||||
"nav_prdy_ctrt": "0.31",
|
||||
"nav_vrss_prpr": "-36.99",
|
||||
"dprt": "-0.10",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3531673",
|
||||
"cntg_vol": "5000"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151100",
|
||||
"nav": "36134.21",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "97.99",
|
||||
"nav_prdy_ctrt": "0.27",
|
||||
"nav_vrss_prpr": "-34.21",
|
||||
"dprt": "-0.09",
|
||||
"stck_prpr": "36100",
|
||||
"prdy_vrss": "120",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.33",
|
||||
"acml_vol": "3508924",
|
||||
"cntg_vol": "1"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "151000",
|
||||
"nav": "36125.95",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "89.73",
|
||||
"nav_prdy_ctrt": "0.25",
|
||||
"nav_vrss_prpr": "-30.95",
|
||||
"dprt": "-0.09",
|
||||
"stck_prpr": "36095",
|
||||
"prdy_vrss": "115",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.32",
|
||||
"acml_vol": "3497610",
|
||||
"cntg_vol": "107"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150900",
|
||||
"nav": "36140.40",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "104.18",
|
||||
"nav_prdy_ctrt": "0.29",
|
||||
"nav_vrss_prpr": "-40.40",
|
||||
"dprt": "-0.11",
|
||||
"stck_prpr": "36100",
|
||||
"prdy_vrss": "120",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.33",
|
||||
"acml_vol": "3465289",
|
||||
"cntg_vol": "1"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150800",
|
||||
"nav": "36142.41",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "106.19",
|
||||
"nav_prdy_ctrt": "0.29",
|
||||
"nav_vrss_prpr": "-52.41",
|
||||
"dprt": "-0.15",
|
||||
"stck_prpr": "36090",
|
||||
"prdy_vrss": "110",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.31",
|
||||
"acml_vol": "3455837",
|
||||
"cntg_vol": "2"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150700",
|
||||
"nav": "36128.14",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "91.92",
|
||||
"nav_prdy_ctrt": "0.25",
|
||||
"nav_vrss_prpr": "-38.14",
|
||||
"dprt": "-0.11",
|
||||
"stck_prpr": "36090",
|
||||
"prdy_vrss": "110",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.31",
|
||||
"acml_vol": "3443292",
|
||||
"cntg_vol": "6"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150600",
|
||||
"nav": "36143.67",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "107.45",
|
||||
"nav_prdy_ctrt": "0.30",
|
||||
"nav_vrss_prpr": "-43.67",
|
||||
"dprt": "-0.12",
|
||||
"stck_prpr": "36100",
|
||||
"prdy_vrss": "120",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.33",
|
||||
"acml_vol": "3438545",
|
||||
"cntg_vol": "38"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150500",
|
||||
"nav": "36149.19",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "112.97",
|
||||
"nav_prdy_ctrt": "0.31",
|
||||
"nav_vrss_prpr": "-49.19",
|
||||
"dprt": "-0.14",
|
||||
"stck_prpr": "36100",
|
||||
"prdy_vrss": "120",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.33",
|
||||
"acml_vol": "3429629",
|
||||
"cntg_vol": "1"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150400",
|
||||
"nav": "36144.80",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "108.58",
|
||||
"nav_prdy_ctrt": "0.30",
|
||||
"nav_vrss_prpr": "-34.80",
|
||||
"dprt": "-0.11",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "125",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.35",
|
||||
"acml_vol": "3425274",
|
||||
"cntg_vol": "50"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150300",
|
||||
"nav": "36152.94",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "116.72",
|
||||
"nav_prdy_ctrt": "0.32",
|
||||
"nav_vrss_prpr": "-42.94",
|
||||
"dprt": "-0.12",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3417931",
|
||||
"cntg_vol": "10"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150200",
|
||||
"nav": "36152.33",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "116.11",
|
||||
"nav_prdy_ctrt": "0.32",
|
||||
"nav_vrss_prpr": "-37.33",
|
||||
"dprt": "-0.08",
|
||||
"stck_prpr": "36115",
|
||||
"prdy_vrss": "145",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.40",
|
||||
"acml_vol": "3410977",
|
||||
"cntg_vol": "276"
|
||||
},
|
||||
{
|
||||
"bsop_hour": "150100",
|
||||
"nav": "36156.58",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_vrss": "120.36",
|
||||
"nav_prdy_ctrt": "0.33",
|
||||
"nav_vrss_prpr": "-46.58",
|
||||
"dprt": "-0.13",
|
||||
"stck_prpr": "36110",
|
||||
"prdy_vrss": "130",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_ctrt": "0.36",
|
||||
"acml_vol": "3400392",
|
||||
"cntg_vol": "5"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,160 @@
|
||||
# 주식현재가 투자자
|
||||
|
||||
- 원본 시트명: 주식현재가 투자자
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-012
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST01010900
|
||||
- 모의 TR_ID: FHKST01010900
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-investor
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식현재가 투자자 API입니다. 개인, 외국인, 기관 등 투자 정보를 확인할 수 있습니다.
|
||||
|
||||
[유의사항]
|
||||
- 외국인은 외국인(외국인투자등록 고유번호가 있는 경우)+기타 외국인을 지칭합니다.
|
||||
- 당일 데이터는 장 종료 후 제공됩니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### Request Header
|
||||
|
||||
| Element | 한글명 | Type | Required | Length | Description |
|
||||
| --- | --- | --- | --- | --- | --- |
|
||||
| content-type | 컨텐츠타입 | string | Y | 40 | application/json; charset=utf-8 |
|
||||
| authorization | 접근토큰 | string | Y | 350 | OAuth 토큰이 필요한 API 경우 발급한 Access token <br>일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) <br>법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
|
||||
| appkey | 앱키 | string | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| appsecret | 앱시크릿키 | string | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
|
||||
| personalseckey | 고객식별키 | string | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
|
||||
| tr_id | 거래ID | string | Y | 13 | FHKST01010900 |
|
||||
| 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 : KRX, NX : NXT, UN : 통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
|
||||
### 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_clpr | 주식 종가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prsn_ntby_qty | 개인 순매수 수량 | string | Y | 12 | |
|
||||
| frgn_ntby_qty | 외국인 순매수 수량 | string | Y | 12 | |
|
||||
| orgn_ntby_qty | 기관계 순매수 수량 | string | Y | 18 | |
|
||||
| prsn_ntby_tr_pbmn | 개인 순매수 거래 대금 | string | Y | 18 | |
|
||||
| frgn_ntby_tr_pbmn | 외국인 순매수 거래 대금 | string | Y | 18 | |
|
||||
| orgn_ntby_tr_pbmn | 기관계 순매수 거래 대금 | string | Y | 18 | |
|
||||
| prsn_shnu_vol | 개인 매수2 거래량 | string | Y | 18 | |
|
||||
| frgn_shnu_vol | 외국인 매수2 거래량 | string | Y | 18 | |
|
||||
| orgn_shnu_vol | 기관계 매수2 거래량 | string | Y | 18 | |
|
||||
| prsn_shnu_tr_pbmn | 개인 매수2 거래 대금 | string | Y | 18 | |
|
||||
| frgn_shnu_tr_pbmn | 외국인 매수2 거래 대금 | string | Y | 18 | |
|
||||
| orgn_shnu_tr_pbmn | 기관계 매수2 거래 대금 | string | Y | 18 | |
|
||||
| prsn_seln_vol | 개인 매도 거래량 | string | Y | 18 | |
|
||||
| frgn_seln_vol | 외국인 매도 거래량 | string | Y | 18 | |
|
||||
| orgn_seln_vol | 기관계 매도 거래량 | string | Y | 18 | |
|
||||
| prsn_seln_tr_pbmn | 개인 매도 거래 대금 | string | Y | 18 | |
|
||||
| frgn_seln_tr_pbmn | 외국인 매도 거래 대금 | string | Y | 18 | |
|
||||
| orgn_seln_tr_pbmn | 기관계 매도 거래 대금 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_input_iscd": "000660"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": [
|
||||
{
|
||||
"stck_bsop_date": "20220113",
|
||||
"stck_clpr": "129500",
|
||||
"prdy_vrss": "1000",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prsn_ntby_qty": "-287624",
|
||||
"frgn_ntby_qty": "797458",
|
||||
"orgn_ntby_qty": "-503653",
|
||||
"prsn_ntby_tr_pbmn": "-37176",
|
||||
"frgn_ntby_tr_pbmn": "102959",
|
||||
"orgn_ntby_tr_pbmn": "-64984",
|
||||
"prsn_shnu_vol": "467525",
|
||||
"frgn_shnu_vol": "1442791",
|
||||
"orgn_shnu_vol": "2219433",
|
||||
"prsn_shnu_tr_pbmn": "60368",
|
||||
"frgn_shnu_tr_pbmn": "186166",
|
||||
"orgn_shnu_tr_pbmn": "286505",
|
||||
"prsn_seln_vol": "755149",
|
||||
"frgn_seln_vol": "645333",
|
||||
"orgn_seln_vol": "2723086",
|
||||
"prsn_seln_tr_pbmn": "97544",
|
||||
"frgn_seln_tr_pbmn": "83207",
|
||||
"orgn_seln_tr_pbmn": "351489"
|
||||
},
|
||||
{
|
||||
"stck_bsop_date": "20220112",
|
||||
"stck_clpr": "128500",
|
||||
"prdy_vrss": "500",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prsn_ntby_qty": "-74249",
|
||||
"frgn_ntby_qty": "-134600",
|
||||
"orgn_ntby_qty": "206812",
|
||||
"prsn_ntby_tr_pbmn": "-9687",
|
||||
"frgn_ntby_tr_pbmn": "-17094",
|
||||
"orgn_ntby_tr_pbmn": "26530",
|
||||
"prsn_shnu_vol": "608748",
|
||||
"frgn_shnu_vol": "721756",
|
||||
"orgn_shnu_vol": "2201966",
|
||||
"prsn_shnu_tr_pbmn": "77943",
|
||||
"frgn_shnu_tr_pbmn": "92615",
|
||||
"orgn_shnu_tr_pbmn": "281965",
|
||||
"prsn_seln_vol": "682997",
|
||||
"frgn_seln_vol": "856356",
|
||||
"orgn_seln_vol": "1995154",
|
||||
"prsn_seln_tr_pbmn": "87630",
|
||||
"frgn_seln_tr_pbmn": "109708",
|
||||
"orgn_seln_tr_pbmn": "255435"
|
||||
}
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,204 @@
|
||||
# ETF_ETN 현재가
|
||||
|
||||
- 원본 시트명: ETF_ETN 현재가
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-068
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHPST02400000
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 모의투자 미지원
|
||||
- URL 명: /uapi/etfetn/v1/quotations/inquire-price
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
ETF/ETN 현재가 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0240] ETF/ETN 현재가 화면의 기능을 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 | FHPST02400000 |
|
||||
| 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 | FID 입력 종목코드 | string | Y | 12 | 종목코드 |
|
||||
| fid_cond_mrkt_div_code | FID 조건 시장 분류 코드 | 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 | Y | | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | |
|
||||
| prdy_vol | 전일 거래량 | string | Y | 18 | |
|
||||
| stck_mxpr | 주식 상한가 | string | Y | 10 | |
|
||||
| stck_llam | 주식 하한가 | string | Y | 10 | |
|
||||
| stck_prdy_clpr | 주식 전일 종가 | string | Y | 10 | |
|
||||
| stck_oprc | 주식 시가2 | string | Y | 10 | |
|
||||
| prdy_clpr_vrss_oprc_rate | 전일 종가 대비 시가2 비율 | string | Y | 84 | |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | |
|
||||
| prdy_clpr_vrss_hgpr_rate | 전일 종가 대비 최고가 비율 | string | Y | 84 | |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | |
|
||||
| prdy_clpr_vrss_lwpr_rate | 전일 종가 대비 최저가 비율 | string | Y | 84 | |
|
||||
| prdy_last_nav | 전일 최종 NAV | string | Y | 112 | |
|
||||
| nav | NAV | string | Y | 112 | |
|
||||
| nav_prdy_vrss | NAV 전일 대비 | string | Y | 112 | |
|
||||
| nav_prdy_vrss_sign | NAV 전일 대비 부호 | string | Y | 1 | |
|
||||
| nav_prdy_ctrt | NAV 전일 대비율 | string | Y | 82 | |
|
||||
| trc_errt | 추적 오차율 | string | Y | 82 | |
|
||||
| stck_sdpr | 주식 기준가 | string | Y | 10 | |
|
||||
| stck_sspr | 주식 대용가 | string | Y | 10 | |
|
||||
| nmix_ctrt | 지수 대비율 | string | Y | 135 | |
|
||||
| etf_crcl_stcn | ETF 유통 주수 | string | Y | 18 | |
|
||||
| etf_ntas_ttam | ETF 순자산 총액 | string | Y | 22 | |
|
||||
| etf_frcr_ntas_ttam | ETF 외화 순자산 총액 | string | Y | 22 | |
|
||||
| frgn_limt_rate | 외국인 한도 비율 | string | Y | 84 | |
|
||||
| frgn_oder_able_qty | 외국인 주문 가능 수량 | string | Y | 18 | |
|
||||
| etf_cu_unit_scrt_cnt | ETF CU 단위 증권 수 | string | Y | 18 | |
|
||||
| etf_cnfg_issu_cnt | ETF 구성 종목 수 | string | Y | 18 | |
|
||||
| etf_dvdn_cycl | ETF 배당 주기 | string | Y | 2 | |
|
||||
| crcd | 통화 코드 | string | Y | 4 | |
|
||||
| etf_crcl_ntas_ttam | ETF 유통 순자산 총액 | string | Y | 22 | |
|
||||
| etf_frcr_crcl_ntas_ttam | ETF 외화 유통 순자산 총액 | string | Y | 22 | |
|
||||
| etf_frcr_last_ntas_wrth_val | ETF 외화 최종 순자산 가치 값 | string | Y | 13 | |
|
||||
| lp_oder_able_cls_code | LP 주문 가능 구분 코드 | string | Y | 2 | |
|
||||
| stck_dryy_hgpr | 주식 연중 최고가 | string | Y | 10 | |
|
||||
| dryy_hgpr_vrss_prpr_rate | 연중 최고가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| dryy_hgpr_date | 연중 최고가 일자 | string | Y | 8 | |
|
||||
| stck_dryy_lwpr | 주식 연중 최저가 | string | Y | 10 | |
|
||||
| dryy_lwpr_vrss_prpr_rate | 연중 최저가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| dryy_lwpr_date | 연중 최저가 일자 | string | Y | 8 | |
|
||||
| bstp_kor_isnm | 업종 한글 종목명 | string | Y | 40 | ※ 거래소 정보로 특정 종목은 업종구분이 없어 데이터 미회신 |
|
||||
| vi_cls_code | VI적용구분코드 | string | Y | 1 | |
|
||||
| lstn_stcn | 상장 주수 | string | Y | 18 | |
|
||||
| frgn_hldn_qty | 외국인 보유 수량 | string | Y | 18 | |
|
||||
| frgn_hldn_qty_rate | 외국인 보유 수량 비율 | string | Y | 84 | |
|
||||
| etf_trc_ert_mltp | ETF 추적 수익률 배수 | string | Y | 126 | |
|
||||
| dprt | 괴리율 | string | Y | 82 | |
|
||||
| mbcr_name | 회원사 명 | string | Y | 50 | |
|
||||
| stck_lstn_date | 주식 상장 일자 | string | Y | 8 | |
|
||||
| mtrt_date | 만기 일자 | string | Y | 8 | |
|
||||
| shrg_type_code | 분배금형태코드 | string | Y | 2 | |
|
||||
| lp_hldn_rate | LP 보유 비율 | string | Y | 84 | |
|
||||
| etf_trgt_nmix_bstp_code | ETF대상지수업종코드 | string | Y | 4 | |
|
||||
| etf_div_name | ETF 분류 명 | string | Y | 40 | |
|
||||
| etf_rprs_bstp_kor_isnm | ETF 대표 업종 한글 종목명 | string | Y | 40 | |
|
||||
| lp_hldn_vol | ETN LP 보유량 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code":"J",
|
||||
"fid_input_iscd":"069500"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": {
|
||||
"stck_prpr": "36090",
|
||||
"prdy_vrss_sign": "2",
|
||||
"prdy_vrss": "110",
|
||||
"prdy_ctrt": "0.31",
|
||||
"acml_vol": "3719307",
|
||||
"prdy_vol": "6463600",
|
||||
"stck_mxpr": "46770",
|
||||
"stck_llam": "25190",
|
||||
"stck_prdy_clpr": "35980",
|
||||
"stck_oprc": "36300",
|
||||
"prdy_clpr_vrss_oprc_rate": "0.89",
|
||||
"stck_hgpr": "36510",
|
||||
"prdy_clpr_vrss_hgpr_rate": "1.47",
|
||||
"stck_lwpr": "36040",
|
||||
"prdy_clpr_vrss_lwpr_rate": "0.17",
|
||||
"prdy_last_nav": "36036.22",
|
||||
"nav": "36127.30",
|
||||
"nav_prdy_vrss": "91.08",
|
||||
"nav_prdy_vrss_sign": "2",
|
||||
"nav_prdy_ctrt": "0.25",
|
||||
"trc_errt": "0.53",
|
||||
"stck_sdpr": "35980",
|
||||
"stck_sspr": "28780",
|
||||
"etf_crcl_stcn": "191550000",
|
||||
"etf_ntas_ttam": "69027",
|
||||
"etf_frcr_ntas_ttam": "0",
|
||||
"frgn_limt_rate": "100.0000",
|
||||
"frgn_oder_able_qty": "150950685",
|
||||
"etf_cu_unit_scrt_cnt": "50000",
|
||||
"etf_cnfg_issu_cnt": "201",
|
||||
"etf_dvdn_cycl": "2",
|
||||
"crcd": "KRW",
|
||||
"etf_crcl_ntas_ttam": "0",
|
||||
"etf_frcr_crcl_ntas_ttam": "0",
|
||||
"etf_frcr_last_ntas_wrth_val": "0",
|
||||
"lp_oder_able_cls_code": "N",
|
||||
"stck_dryy_hgpr": "36510",
|
||||
"dryy_hgpr_vrss_prpr_rate": "-1.15",
|
||||
"dryy_hgpr_date": "20240223",
|
||||
"stck_dryy_lwpr": "32748",
|
||||
"dryy_lwpr_vrss_prpr_rate": "10.21",
|
||||
"dryy_lwpr_date": "20240118",
|
||||
"bstp_kor_isnm": "ETF(실물복제/수익증권)",
|
||||
"vi_cls_code": "N",
|
||||
"lstn_stcn": "191550000",
|
||||
"frgn_hldn_qty": "40599315",
|
||||
"frgn_hldn_qty_rate": "21.20",
|
||||
"etf_trc_ert_mltp": "1.00",
|
||||
"dprt": "-0.10",
|
||||
"mbcr_name": "삼성자산운용(ETF)",
|
||||
"stck_lstn_date": "20021014",
|
||||
"mtrt_date": "0",
|
||||
"shrg_type_code": " ",
|
||||
"lp_hldn_rate": "0.00",
|
||||
"etf_trgt_nmix_bstp_code": "2001",
|
||||
"etf_div_name": "수익증권형",
|
||||
"etf_rprs_bstp_kor_isnm": "KOSPI200",
|
||||
"lp_hldn_vol": "0"
|
||||
},
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,99 @@
|
||||
# 국내주식 장마감 예상체결가
|
||||
|
||||
- 원본 시트명: 국내주식 장마감 예상체결가
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: 국내주식-120
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST117300C0
|
||||
- 모의 TR_ID: 모의투자 미지원
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: 미지원
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/exp-closing-price
|
||||
- 모의투자 지원: 미지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
국내주식 장마감 예상체결가 API입니다.
|
||||
한국투자 HTS(eFriend Plus) > [0183] 장마감 예상체결가 화면의 기능을 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 | FHKST117300C0 |
|
||||
| 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:상한가마감예상, 2:하한가마감예상, 3:직전대비상승률상위 ,4:직전대비하락률상위 |
|
||||
| FID_COND_MRKT_DIV_CODE | 조건 시장 분류 코드 | string | Y | 2 | 시장구분코드 (주식 J) |
|
||||
| FID_COND_SCR_DIV_CODE | 조건 화면 분류 코드 | string | Y | 5 | Unique key(11173) |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100 |
|
||||
| FID_BLNG_CLS_CODE | 소속 구분 코드 | string | Y | 2 | 0:전체, 1:종가범위연장 |
|
||||
|
||||
### 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 |
|
||||
| stck_shrn_iscd | 주식 단축 종목코드 | string | Y | 9 | |
|
||||
| hts_kor_isnm | HTS 한글 종목명 | string | Y | 40 | |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 82 | |
|
||||
| sdpr_vrss_prpr | 기준가 대비 현재가 | string | Y | 10 | |
|
||||
| sdpr_vrss_prpr_rate | 기준가 대비 현재가 비율 | string | Y | 84 | |
|
||||
| cntg_vol | 체결 거래량 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
fid_cond_mrkt_div_code:J
|
||||
fid_cond_scr_div_code:11173
|
||||
fid_input_iscd:0001
|
||||
fid_blng_cls_code:0
|
||||
fid_rank_sort_cls_code:0
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output": [],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다."
|
||||
}
|
||||
```
|
||||
@@ -0,0 +1,153 @@
|
||||
# 주식당일분봉조회
|
||||
|
||||
- 원본 시트명: 주식당일분봉조회
|
||||
- API 통신방식: REST
|
||||
- 메뉴 위치: [국내주식] 기본시세
|
||||
- API ID: v1_국내주식-022
|
||||
- HTTP Method: GET
|
||||
- 실전 TR_ID: FHKST03010200
|
||||
- 모의 TR_ID: FHKST03010200
|
||||
- 실전 Domain: https://openapi.koreainvestment.com:9443
|
||||
- 모의 Domain: https://openapivts.koreainvestment.com:29443
|
||||
- URL 명: /uapi/domestic-stock/v1/quotations/inquire-time-itemchartprice
|
||||
- 모의투자 지원: 지원
|
||||
- 원본 워크북: [한국투자증권_오픈API_전체문서_20260430_030000.xlsx](../../../../../한국투자증권_오픈API_전체문서_20260430_030000.xlsx)
|
||||
|
||||
## 개요
|
||||
|
||||
주식당일분봉조회 API입니다.
|
||||
실전계좌/모의계좌의 경우, 한 번의 호출에 최대 30건까지 확인 가능합니다.
|
||||
|
||||
※ 당일 분봉 데이터만 제공됩니다. (전일자 분봉 미제공)
|
||||
|
||||
※ input > FID_INPUT_HOUR_1 에 미래일시 입력 시에 현재가로 조회됩니다.
|
||||
ex) 오전 10시에 113000 입력 시에 오전 10시~11시30분 사이의 데이터가 오전 10시 값으로 조회됨
|
||||
|
||||
※ output2의 첫번째 배열의 체결량(cntg_vol)은 첫체결이 발생되기 전까지는 이전 분봉의 체결량이 해당 위치에 표시됩니다.
|
||||
해당 분봉의 첫 체결이 발생되면 해당 이전분 체결량이 두번째 배열로 이동되면서 새로운 체결량으로 업데이트됩니다.
|
||||
|
||||
## 레이아웃
|
||||
|
||||
### 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 | FHKST03010200 |
|
||||
| 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:KRX, NX:NXT, UN:통합 |
|
||||
| FID_INPUT_ISCD | 입력 종목코드 | string | Y | 12 | 종목코드 (ex 005930 삼성전자) |
|
||||
| FID_INPUT_HOUR_1 | 입력 시간1 | string | Y | 10 | 입력시간 |
|
||||
| FID_PW_DATA_INCU_YN | 과거 데이터 포함 여부 | string | Y | 2 | |
|
||||
| FID_ETC_CLS_CODE | 기타 구분 코드 | string | Y | 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 | Y | | |
|
||||
| prdy_vrss | 전일 대비 | string | Y | 10 | 전일 대비 변동 (+-변동차이) |
|
||||
| prdy_vrss_sign | 전일 대비 부호 | string | Y | 1 | 전일 대비 부호 |
|
||||
| prdy_ctrt | 전일 대비율 | string | Y | 10 | 소수점 두자리까지 제공 |
|
||||
| stck_prdy_clpr | 전일대비 종가 | string | Y | 10 | 전일대비 종가 |
|
||||
| acml_vol | 누적 거래량 | string | Y | 18 | 누적 거래량 |
|
||||
| acml_tr_pbmn | 누적 거래대금 | string | Y | 18 | 누적 거래대금 |
|
||||
| hts_kor_isnm | 한글 종목명 | string | Y | 40 | 한글 종목명 (HTS 기준) |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | 주식 현재가 |
|
||||
| output2 | 응답상세 | object array | Y | | Array |
|
||||
| stck_bsop_date | 주식 영업일자 | string | Y | 8 | 주식 영업일자 |
|
||||
| stck_cntg_hour | 주식 체결시간 | string | Y | 6 | 주식 체결시간 |
|
||||
| stck_prpr | 주식 현재가 | string | Y | 10 | 주식 현재가 |
|
||||
| stck_oprc | 주식 시가 | string | Y | 10 | 주식 시가 |
|
||||
| stck_hgpr | 주식 최고가 | string | Y | 10 | 주식 최고가 |
|
||||
| stck_lwpr | 주식 최저가 | string | Y | 10 | 주식 최저가 |
|
||||
| cntg_vol | 체결 거래량 | string | Y | 18 | |
|
||||
| acml_tr_pbmn | 누적 거래대금 | string | Y | 18 | |
|
||||
|
||||
## 예제
|
||||
|
||||
### Request Example (Python)
|
||||
|
||||
```text
|
||||
{
|
||||
"fid_cond_mrkt_div_code": "J",
|
||||
"fid_etc_cls_code": "",
|
||||
"fid_input_hour_1": "100000",
|
||||
"fid_input_iscd": "000660",
|
||||
"fid_pw_data_incu_yn": "Y"
|
||||
}
|
||||
```
|
||||
|
||||
### Response Example
|
||||
|
||||
```text
|
||||
{
|
||||
"output1": {
|
||||
"acml_tr_pbmn": "96910660000",
|
||||
"acml_vol": "1046883",
|
||||
"hts_kor_isnm": "SK하이닉스",
|
||||
"prdy_ctrt": "-0.11",
|
||||
"prdy_vrss": "-100",
|
||||
"prdy_vrss_sign": "5",
|
||||
"stck_prdy_clpr": "92400",
|
||||
"stck_prpr": "92300"
|
||||
},
|
||||
"output2": [
|
||||
{
|
||||
"acml_tr_pbmn": "55858827400",
|
||||
"cntg_vol": "1383",
|
||||
"stck_bsop_date": "20220902",
|
||||
"stck_cntg_hour": "100000",
|
||||
"stck_hgpr": "92500",
|
||||
"stck_lwpr": "92400",
|
||||
"stck_oprc": "92400",
|
||||
"stck_prpr": "92500"
|
||||
},
|
||||
{
|
||||
"acml_tr_pbmn": "55731000300",
|
||||
"cntg_vol": "1564",
|
||||
"stck_bsop_date": "20220902",
|
||||
"stck_cntg_hour": "095900",
|
||||
"stck_hgpr": "92500",
|
||||
"stck_lwpr": "92400",
|
||||
"stck_oprc": "92500",
|
||||
"stck_prpr": "92400"
|
||||
"stck_hgpr": "93300",
|
||||
"stck_lwpr": "93100",
|
||||
"stck_oprc": "93100",
|
||||
"stck_prpr": "93200"
|
||||
}
|
||||
......
|
||||
],
|
||||
"rt_cd": "0",
|
||||
"msg_cd": "MCA00000",
|
||||
"msg1": "정상처리 되었습니다!"
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user