API 문서 HOME API 문서 [국내주식] ELW시세
[국내주식] ELW시세
ELW현재가 시세[v1_국내주식-014]
REST
ELW현재가 시세[v1_국내주식-014]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domainhttps://openapivts.koreainvestment.com:29443
- URL/uapi/domestic-stock/v1/quotations/inquire-elw-price
- Format
- Content-Type
개요
ELW 현재가 시세 API입니다. ELW 관련 정보를 얻을 수 있습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | N | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appsecret (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | [실전투자/모의투자]
FHKEW15010000 : ELW현재가 시세 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객타입 | String | N | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | FID 조건 시장 분류 코드 | String | Y | 2 | W : ELW |
| FID_INPUT_ISCD | FID 입력 종목코드 | String | Y | 12 | 종목번호 (6자리) |
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 | F or M : 다음 데이터 있음
D or E : 마지막 데이터 |
| gt_uid | Global UID | String | Y | 32 | 거래고유번호 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | 0 : 성공
0 이외의 값 : 실패 |
| msg_cd | 응답코드 | String | Y | 8 | 응답코드 |
| msg1 | 응답메세지 | String | Y | 80 | 응답메세지 |
| output | 응답상세 | Array | Y | null | |
| -elw_shrn_iscd | ELW 단축 종목코드 | String | Y | 9 | |
| -hts_kor_isnm | HTS 한글 종목명 | String | Y | 40 | |
| -elw_prpr | ELW 현재가 | String | Y | 10 | |
| -prdy_vrss | 전일 대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일 대비 부호 | String | Y | 1 | |
| -prdy_ctrt | 전일 대비율 | String | Y | 10 | |
| -acml_vol | 누적 거래량 | String | Y | 18 | |
| -prdy_vrss_vol_rate | 전일 대비 거래량 비율 | String | Y | 12 | |
| -unas_shrn_iscd | 기초자산 단축 종목코드 | String | Y | 9 | |
| -unas_isnm | 기초자산 종목명 | String | Y | 40 | |
| -unas_prpr | 기초자산 현재가 | String | Y | 13 | |
| -unas_prdy_vrss | 기초자산 전일 대비 | String | Y | 13 | |
| -unas_prdy_vrss_sign | 기초자산 전일 대비 부호 | String | Y | 1 | |
| -unas_prdy_ctrt | 기초자산 전일 대비율 | String | Y | 10 | |
| -bidp | 매수호가 | String | Y | 10 | |
| -askp | 매도호가 | String | Y | 10 | |
| -acml_tr_pbmn | 누적 거래 대금 | String | Y | 18 | |
| -vol_tnrt | 거래량 회전율 | String | Y | 10 | |
| -elw_oprc | ELW 시가2 | String | Y | 10 | |
| -elw_hgpr | ELW 최고가 | String | Y | 10 | |
| -elw_lwpr | ELW 최저가 | String | Y | 10 | |
| -stck_prdy_clpr | 주식 전일 종가 | String | Y | 10 | |
| -hts_thpr | HTS 이론가 | String | Y | 13 | |
| -dprt | 괴리율 | String | Y | 10 | |
| -atm_cls_name | ATM 구분 명 | String | Y | 10 | |
| -hts_ints_vltl | HTS 내재 변동성 | String | Y | 15 | |
| -acpr | 행사가 | String | Y | 13 | |
| -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 | |
| -dmsp_val | 디지지 값 | String | Y | 10 | |
| -dmrs_val | 디저항 값 | String | Y | 10 | |
| -elw_sdpr | ELW 기준가 | String | Y | 10 | |
| -apprch_rate | 접근도 | String | Y | 13 | |
| -tick_conv_prc | 틱환산가 | String | Y | 11 | |
| -invt_epmd_cntt | 투자 유의 내용 | String | Y | 200 |
Example
Request
{
"fid_cond_mrkt_div_code": "J",
"fid_input_iscd": "000660"
}
"fid_cond_mrkt_div_code": "J",
"fid_input_iscd": "000660"
}
Response
{
"output": {
"elw_prpr": "0",
"prdy_vrss": "0",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"prdy_vrss_vol_rate": "0.00",
"unas_isnm": "BASKET",
"unas_prpr": "0.00",
"unas_prdy_vrss": "0.00",
"unas_prdy_vrss_sign": "3",
"unas_prdy_ctrt": "0.00",
"bidp": "0",
"askp": "0",
"acml_tr_pbmn": "0",
"vol_tnrt": "0.00",
"elw_oprc": "0",
"elw_hgpr": "0",
"elw_lwpr": "0",
"stck_prdy_clpr": "0",
"hts_thpr": "0.00",
"dprt": "0.00",
"atm_cls_name": "ATM",
"hts_ints_vltl": "0.00",
"acpr": "0.00",
"pvt_scnd_dmrs_prc": "0",
"pvt_frst_dmrs_prc": "0",
"pvt_pont_val": "0",
"pvt_frst_dmsp_prc": "0",
"pvt_scnd_dmsp_prc": "0",
"dmsp_val": "0",
"dmrs_val": "0",
"elw_sdpr": "0",
"apprch_rate": "0.00",
"tick_conv_prc": "0.00"
},
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다!"
}
"output": {
"elw_prpr": "0",
"prdy_vrss": "0",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"prdy_vrss_vol_rate": "0.00",
"unas_isnm": "BASKET",
"unas_prpr": "0.00",
"unas_prdy_vrss": "0.00",
"unas_prdy_vrss_sign": "3",
"unas_prdy_ctrt": "0.00",
"bidp": "0",
"askp": "0",
"acml_tr_pbmn": "0",
"vol_tnrt": "0.00",
"elw_oprc": "0",
"elw_hgpr": "0",
"elw_lwpr": "0",
"stck_prdy_clpr": "0",
"hts_thpr": "0.00",
"dprt": "0.00",
"atm_cls_name": "ATM",
"hts_ints_vltl": "0.00",
"acpr": "0.00",
"pvt_scnd_dmrs_prc": "0",
"pvt_frst_dmrs_prc": "0",
"pvt_pont_val": "0",
"pvt_frst_dmsp_prc": "0",
"pvt_scnd_dmsp_prc": "0",
"dmsp_val": "0",
"dmrs_val": "0",
"elw_sdpr": "0",
"apprch_rate": "0.00",
"tick_conv_prc": "0.00"
},
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다!"
}
ELW 상승률순위[국내주식-167]
REST
ELW 상승률순위[국내주식-167]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/ranking/updown-rate
- Format
- Content-Type
개요
ELW 상승률순위 API입니다.
한국투자 HTS(eFriend Plus) > [0277] ELW 상승률순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0277] ELW 상승률순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02770000 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 사용자권한정보 | String | Y | 2 | 시장구분코드 (W) |
| FID_COND_SCR_DIV_CODE | 거래소코드 | String | Y | 5 | Unique key(20277) |
| FID_UNAS_INPUT_ISCD | 상승율/하락율 구분 | String | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
| FID_INPUT_ISCD | N일자값 | String | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
| FID_INPUT_RMNN_DYNU_1 | 거래량조건 | String | Y | 5 | '0(전체), 1(1개월이하), 2(1개월~2개월),
3(2개월~3개월), 4(3개월~6개월), 5(6개월~9개월),6(9개월~12개월), 7(12개월이상)' |
| FID_DIV_CLS_CODE | NEXT KEY BUFF | String | Y | 2 | 0(전체), 1(콜), 2(풋) |
| FID_INPUT_PRICE_1 | 사용자권한정보 | String | Y | 12 | |
| FID_INPUT_PRICE_2 | 거래소코드 | String | Y | 12 | |
| FID_INPUT_VOL_1 | 상승율/하락율 구분 | String | Y | 18 | |
| FID_INPUT_VOL_2 | N일자값 | String | Y | 18 | |
| FID_INPUT_DATE_1 | 거래량조건 | String | Y | 10 | |
| FID_RANK_SORT_CLS_CODE | NEXT KEY BUFF | String | Y | 2 | '0(상승율), 1(하락율), 2(시가대비상승율)
, 3(시가대비하락율), 4(변동율)' |
| FID_BLNG_CLS_CODE | 사용자권한정보 | String | Y | 2 | 0(전체) |
| FID_INPUT_DATE_2 | 거래소코드 | String | Y | 10 |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -hts_kor_isnm | HTS한글종목명 | String | Y | 40 | |
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -stck_sdpr | 주식기준가 | String | Y | 10 | |
| -sdpr_vrss_prpr_sign | 기준가대비현재가부호 | String | Y | 1 | |
| -sdpr_vrss_prpr | 기준가대비현재가 | String | Y | 10 | |
| -sdpr_vrss_prpr_rate | 기준가대비현재가비율 | String | Y | 84 | |
| -stck_oprc | 주식시가2 | String | Y | 10 | |
| -oprc_vrss_prpr_sign | 시가2대비현재가부호 | String | Y | 1 | |
| -oprc_vrss_prpr | 시가2대비현재가 | String | Y | 10 | |
| -oprc_vrss_prpr_rate | 시가2대비현재가비율 | String | Y | 84 | |
| -stck_hgpr | 주식최고가 | String | Y | 10 | |
| -stck_lwpr | 주식최저가 | String | Y | 10 | |
| -prd_rsfl_sign | 기간등락부호 | String | Y | 1 | |
| -prd_rsfl | 기간등락 | String | Y | 10 | |
| -prd_rsfl_rate | 기간등락비율 | String | Y | 84 | |
| -stck_cnvr_rate | 주식전환비율 | String | Y | 136 | |
| -hts_rmnn_dynu | HTS잔존일수 | String | Y | 5 | |
| -acpr | 행사가 | String | Y | 112 | |
| -unas_isnm | 기초자산명 | String | Y | 40 | |
| -unas_shrn_iscd | 기초자산코드 | String | Y | 12 | |
| -lp_hldn_rate | LP보유비율 | String | Y | 84 | |
| -prit | 패리티 | String | Y | 112 | |
| -prls_qryr_stpr_prc | 손익분기주가가격 | String | Y | 112 | |
| -delta_val | 델타값 | String | Y | 114 | |
| -theta | 세타 | String | Y | 84 | |
| -prls_qryr_rate | 손익분기비율 | String | Y | 84 | |
| -stck_lstn_date | 주식상장일자 | String | Y | 8 | |
| -stck_last_tr_date | 주식최종거래일자 | String | Y | 8 | |
| -hts_ints_vltl | HTS내재변동성 | String | Y | 114 | |
| -lvrg_val | 레버리지값 | String | Y | 114 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:20277
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_INPUT_DATE_1:1
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
FID_INPUT_DATE_2:
FID_COND_SCR_DIV_CODE:20277
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_INPUT_DATE_1:1
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
FID_INPUT_DATE_2:
Response
{
"output": [
{
"hts_kor_isnm": "한국JAKWLS일렉콜",
"elw_shrn_iscd": "57JAKW",
"elw_prpr": "460",
"prdy_vrss": "350",
"prdy_vrss_sign": "2",
"prdy_ctrt": "318.18",
"acml_vol": "3320",
"stck_sdpr": "110",
"sdpr_vrss_prpr_sign": "2",
"sdpr_vrss_prpr": "460",
"sdpr_vrss_prpr_rate": "0.00",
"stck_oprc": "470",
"oprc_vrss_prpr_sign": "5",
"oprc_vrss_prpr": "-10",
"oprc_vrss_prpr_rate": "-2.13",
"stck_hgpr": "605",
"stck_lwpr": "0",
"prd_rsfl_sign": "2",
"prd_rsfl": "0",
"prd_rsfl_rate": "34.44",
"stck_cnvr_rate": "0.010000",
"hts_rmnn_dynu": "63",
"acpr": "95600.00",
"unas_isnm": "LS ELECTRIC",
"unas_shrn_iscd": "010120",
"lp_hldn_rate": "99.96",
"prit": "146.12",
"prls_qryr_stpr_prc": "141600.00",
"delta_val": "0.930744",
"theta": "0.7829",
"prls_qryr_rate": "1.3600",
"stck_lstn_date": "20231116",
"stck_last_tr_date": "20240613",
"hts_ints_vltl": "71.91",
"lvrg_val": "2.820154"
},
{
"hts_kor_isnm": "KBJF27KOSPI200콜",
"elw_shrn_iscd": "58JF27",
"elw_prpr": "2395",
"prdy_vrss": "1745",
"prdy_vrss_sign": "2",
"prdy_ctrt": "268.46",
"acml_vol": "100",
"stck_sdpr": "650",
"sdpr_vrss_prpr_sign": "2",
"sdpr_vrss_prpr": "2395",
"sdpr_vrss_prpr_rate": "0.00",
"stck_oprc": "2395",
"oprc_vrss_prpr_sign": "3",
"oprc_vrss_prpr": "0",
"oprc_vrss_prpr_rate": "0.00",
"stck_hgpr": "2395",
"stck_lwpr": "0",
"prd_rsfl_sign": "3",
"prd_rsfl": "0",
"prd_rsfl_rate": "0.00",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"acpr": "345.00",
"unas_isnm": "KOSPI200",
"unas_shrn_iscd": "2001",
"lp_hldn_rate": "99.99",
"prit": "106.44",
"prls_qryr_stpr_prc": "368.95",
"delta_val": "0.900891",
"theta": "13.8535",
"prls_qryr_rate": "0.4600",
"stck_lstn_date": "20231228",
"stck_last_tr_date": "20240509",
"hts_ints_vltl": "19.71",
"lvrg_val": "13.810659"
},
...
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"hts_kor_isnm": "한국JAKWLS일렉콜",
"elw_shrn_iscd": "57JAKW",
"elw_prpr": "460",
"prdy_vrss": "350",
"prdy_vrss_sign": "2",
"prdy_ctrt": "318.18",
"acml_vol": "3320",
"stck_sdpr": "110",
"sdpr_vrss_prpr_sign": "2",
"sdpr_vrss_prpr": "460",
"sdpr_vrss_prpr_rate": "0.00",
"stck_oprc": "470",
"oprc_vrss_prpr_sign": "5",
"oprc_vrss_prpr": "-10",
"oprc_vrss_prpr_rate": "-2.13",
"stck_hgpr": "605",
"stck_lwpr": "0",
"prd_rsfl_sign": "2",
"prd_rsfl": "0",
"prd_rsfl_rate": "34.44",
"stck_cnvr_rate": "0.010000",
"hts_rmnn_dynu": "63",
"acpr": "95600.00",
"unas_isnm": "LS ELECTRIC",
"unas_shrn_iscd": "010120",
"lp_hldn_rate": "99.96",
"prit": "146.12",
"prls_qryr_stpr_prc": "141600.00",
"delta_val": "0.930744",
"theta": "0.7829",
"prls_qryr_rate": "1.3600",
"stck_lstn_date": "20231116",
"stck_last_tr_date": "20240613",
"hts_ints_vltl": "71.91",
"lvrg_val": "2.820154"
},
{
"hts_kor_isnm": "KBJF27KOSPI200콜",
"elw_shrn_iscd": "58JF27",
"elw_prpr": "2395",
"prdy_vrss": "1745",
"prdy_vrss_sign": "2",
"prdy_ctrt": "268.46",
"acml_vol": "100",
"stck_sdpr": "650",
"sdpr_vrss_prpr_sign": "2",
"sdpr_vrss_prpr": "2395",
"sdpr_vrss_prpr_rate": "0.00",
"stck_oprc": "2395",
"oprc_vrss_prpr_sign": "3",
"oprc_vrss_prpr": "0",
"oprc_vrss_prpr_rate": "0.00",
"stck_hgpr": "2395",
"stck_lwpr": "0",
"prd_rsfl_sign": "3",
"prd_rsfl": "0",
"prd_rsfl_rate": "0.00",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"acpr": "345.00",
"unas_isnm": "KOSPI200",
"unas_shrn_iscd": "2001",
"lp_hldn_rate": "99.99",
"prit": "106.44",
"prls_qryr_stpr_prc": "368.95",
"delta_val": "0.900891",
"theta": "13.8535",
"prls_qryr_rate": "0.4600",
"stck_lstn_date": "20231228",
"stck_last_tr_date": "20240509",
"hts_ints_vltl": "19.71",
"lvrg_val": "13.810659"
},
...
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 거래량순위[국내주식-168]
REST
ELW 거래량순위[국내주식-168]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/ranking/volume-rank
- Format
- Content-Type
개요
ELW 거래량순위 API입니다.
한국투자 HTS(eFriend Plus) > [0278] ELW 거래량순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0278] ELW 거래량순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02780000 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 공백 |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천 HSX : 호치민, HNX : 하노이 TSE : 도쿄 ' |
| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | String | Y | 12 | 신고(1) 신저(0) |
| FID_INPUT_ISCD | 발행사 | String | Y | 12 | 일시돌파(0) 돌파유지(1) |
| FID_INPUT_RMNN_DYNU_1 | 입력잔존일수 | String | Y | 5 | N일전 : 0(5일), 1(10일), 2(20일), 3(30일), 4(60일), 5(120일전), 6(52주), 7(1년) |
| FID_DIV_CLS_CODE | 콜풋구분코드 | String | Y | 2 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
| FID_INPUT_PRICE_1 | 가격(이상) | String | Y | 12 | 공백 |
| FID_INPUT_PRICE_2 | 가격(이하) | String | Y | 12 | 공백 |
| FID_INPUT_VOL_1 | 거래량(이상) | String | Y | 18 | 'NYS : 뉴욕, NAS : 나스닥, AMS : 아멕스
HKS : 홍콩, SHS : 상해 , SZS : 심천 HSX : 호치민, HNX : 하노이 TSE : 도쿄 ' |
| FID_INPUT_VOL_2 | 거래량(이하) | String | Y | 18 | 신고(1) 신저(0) |
| FID_INPUT_DATE_1 | 조회기준일 | String | Y | 10 | 일시돌파(0) 돌파유지(1) |
| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | String | Y | 2 | N일전 : 0(5일), 1(10일), 2(20일), 3(30일), 4(60일), 5(120일전), 6(52주), 7(1년) |
| FID_BLNG_CLS_CODE | 소속구분코드 | String | Y | 2 | 0(전체), 1(1백주이상), 2(1천주이상), 3(1만주이상), 4(10만주이상), 5(100만주이상), 6(1000만주이상) |
| FID_INPUT_ISCD_2 | LP발행사 | String | Y | 8 | 공백 |
| FID_INPUT_DATE_2 | 만기일-최종거래일조회 | String | Y | 10 | 공백 |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -elw_kor_isnm | ELW한글종목명 | String | Y | 40 | |
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -lstn_stcn | 상장주수 | String | Y | 18 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -n_prdy_vol | N전일거래량 | String | Y | 18 | |
| -n_prdy_vol_vrss | N전일거래량대비 | String | Y | 18 | |
| -vol_inrt | 거래량증가율 | String | Y | 84 | |
| -vol_tnrt | 거래량회전율 | String | Y | 82 | |
| -nday_vol_tnrt | N일거래량회전율 | String | Y | 8 | |
| -acml_tr_pbmn | 누적거래대금 | String | Y | 18 | |
| -n_prdy_tr_pbmn | N전일거래대금 | String | Y | 18 | |
| -n_prdy_tr_pbmn_vrss | N전일거래대금대비 | String | Y | 18 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 12 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 12 | |
| -ntsl_rsqn | 순매도잔량 | String | Y | 13 | |
| -ntby_rsqn | 순매수잔량 | String | Y | 12 | |
| -seln_rsqn_rate | 매도잔량비율 | String | Y | 84 | |
| -shnu_rsqn_rate | 매수2잔량비율 | String | Y | 84 | |
| -stck_cnvr_rate | 주식전환비율 | String | Y | 136 | |
| -hts_rmnn_dynu | HTS잔존일수 | String | Y | 5 | |
| -invl_val | 내재가치값 | String | Y | 132 | |
| -tmvl_val | 시간가치값 | String | Y | 132 | |
| -acpr | 행사가 | String | Y | 112 | |
| -lp_mbcr_name | LP회원사명 | String | Y | 50 | |
| -unas_isnm | 기초자산명 | String | Y | 40 | |
| -stck_last_tr_date | 최종거래일 | String | Y | 8 | |
| -unas_shrn_iscd | 기초자산코드 | String | Y | 12 | |
| -prdy_vol | 전일거래량 | String | Y | 18 | |
| -lp_hldn_rate | LP보유비율 | String | Y | 84 | |
| -prit | 패리티 | String | Y | 112 | |
| -prls_qryr_stpr_prc | 손익분기주가가격 | String | Y | 112 | |
| -delta_val | 델타값 | String | Y | 114 | |
| -theta | 세타 | String | Y | 84 | |
| -prls_qryr_rate | 손익분기비율 | String | Y | 84 | |
| -stck_lstn_date | 주식상장일자 | String | Y | 8 | |
| -hts_ints_vltl | HTS내재변동성 | String | Y | 114 | |
| -lvrg_val | 레버리지값 | String | Y | 114 | |
| -lp_ntby_qty | LP순매도량 | String | Y | 18 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:20278
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_INPUT_DATE_1:
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
FID_INPUT_ISCD_2:0000
FID_INPUT_DATE_2:
FID_COND_SCR_DIV_CODE:20278
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_INPUT_DATE_1:
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
FID_INPUT_ISCD_2:0000
FID_INPUT_DATE_2:
Response
{
"output": [
{
"elw_kor_isnm": "한국JS54KOSPI200콜",
"elw_shrn_iscd": "57JS54",
"elw_prpr": "135",
"prdy_vrss": "-100",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-42.55",
"lstn_stcn": "10000000",
"acml_vol": "44020240",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "44020240",
"vol_inrt": "0.00",
"vol_tnrt": "440.20",
"nday_vol_tnrt": "440.20",
"acml_tr_pbmn": "7881452400",
"n_prdy_tr_pbmn": "7881452400",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "1512690",
"total_bidp_rsqn": "337490",
"ntsl_rsqn": "-1175200",
"ntby_rsqn": "-1175200",
"seln_rsqn_rate": "81.76",
"shnu_rsqn_rate": "18.24",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "135.00",
"acpr": "385.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "9013220",
"lp_hldn_rate": "11.21",
"prit": "95.38",
"prls_qryr_stpr_prc": "386.35",
"delta_val": "0.160726",
"theta": "12.4577",
"prls_qryr_rate": "5.2000",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "16.98",
"lvrg_val": "43.722294",
"lp_ntby_qty": "5919560"
},
{
"elw_kor_isnm": "한국JS57KOSPI200풋",
"elw_shrn_iscd": "57JS57",
"elw_prpr": "250",
"prdy_vrss": "15",
"prdy_vrss_sign": "2",
"prdy_ctrt": "6.38",
"lstn_stcn": "10000000",
"acml_vol": "41360790",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "41360790",
"vol_inrt": "0.00",
"vol_tnrt": "413.61",
"nday_vol_tnrt": "413.61",
"acml_tr_pbmn": "9642006500",
"n_prdy_tr_pbmn": "9642006500",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "591950",
"total_bidp_rsqn": "320140",
"ntsl_rsqn": "-271810",
"ntby_rsqn": "-271810",
"seln_rsqn_rate": "64.90",
"shnu_rsqn_rate": "35.10",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "250.00",
"acpr": "355.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "3829210",
"lp_hldn_rate": "38.24",
"prit": "96.66",
"prls_qryr_stpr_prc": "352.50",
"delta_val": "-0.227848",
"theta": "15.2298",
"prls_qryr_rate": "-4.0100",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "19.27",
"lvrg_val": "-33.470867",
"lp_ntby_qty": "3929370"
},
{
"elw_kor_isnm": "한국JS59KOSPI200풋",
"elw_shrn_iscd": "57JS59",
"elw_prpr": "165",
"prdy_vrss": "5",
"prdy_vrss_sign": "2",
"prdy_ctrt": "3.12",
"lstn_stcn": "11000000",
"acml_vol": "34510630",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "34510630",
"vol_inrt": "0.00",
"vol_tnrt": "313.73",
"nday_vol_tnrt": "313.73",
"acml_tr_pbmn": "5293873100",
"n_prdy_tr_pbmn": "5293873100",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "348740",
"total_bidp_rsqn": "639850",
"ntsl_rsqn": "291110",
"ntby_rsqn": "291110",
"seln_rsqn_rate": "35.28",
"shnu_rsqn_rate": "64.72",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "165.00",
"acpr": "350.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "7133790",
"lp_hldn_rate": "37.29",
"prit": "95.30",
"prls_qryr_stpr_prc": "348.35",
"delta_val": "-0.160062",
"theta": "12.8688",
"prls_qryr_rate": "-5.1400",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "19.97",
"lvrg_val": "-35.625000",
"lp_ntby_qty": "3185360"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"elw_kor_isnm": "한국JS54KOSPI200콜",
"elw_shrn_iscd": "57JS54",
"elw_prpr": "135",
"prdy_vrss": "-100",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-42.55",
"lstn_stcn": "10000000",
"acml_vol": "44020240",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "44020240",
"vol_inrt": "0.00",
"vol_tnrt": "440.20",
"nday_vol_tnrt": "440.20",
"acml_tr_pbmn": "7881452400",
"n_prdy_tr_pbmn": "7881452400",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "1512690",
"total_bidp_rsqn": "337490",
"ntsl_rsqn": "-1175200",
"ntby_rsqn": "-1175200",
"seln_rsqn_rate": "81.76",
"shnu_rsqn_rate": "18.24",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "135.00",
"acpr": "385.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "9013220",
"lp_hldn_rate": "11.21",
"prit": "95.38",
"prls_qryr_stpr_prc": "386.35",
"delta_val": "0.160726",
"theta": "12.4577",
"prls_qryr_rate": "5.2000",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "16.98",
"lvrg_val": "43.722294",
"lp_ntby_qty": "5919560"
},
{
"elw_kor_isnm": "한국JS57KOSPI200풋",
"elw_shrn_iscd": "57JS57",
"elw_prpr": "250",
"prdy_vrss": "15",
"prdy_vrss_sign": "2",
"prdy_ctrt": "6.38",
"lstn_stcn": "10000000",
"acml_vol": "41360790",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "41360790",
"vol_inrt": "0.00",
"vol_tnrt": "413.61",
"nday_vol_tnrt": "413.61",
"acml_tr_pbmn": "9642006500",
"n_prdy_tr_pbmn": "9642006500",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "591950",
"total_bidp_rsqn": "320140",
"ntsl_rsqn": "-271810",
"ntby_rsqn": "-271810",
"seln_rsqn_rate": "64.90",
"shnu_rsqn_rate": "35.10",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "250.00",
"acpr": "355.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "3829210",
"lp_hldn_rate": "38.24",
"prit": "96.66",
"prls_qryr_stpr_prc": "352.50",
"delta_val": "-0.227848",
"theta": "15.2298",
"prls_qryr_rate": "-4.0100",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "19.27",
"lvrg_val": "-33.470867",
"lp_ntby_qty": "3929370"
},
{
"elw_kor_isnm": "한국JS59KOSPI200풋",
"elw_shrn_iscd": "57JS59",
"elw_prpr": "165",
"prdy_vrss": "5",
"prdy_vrss_sign": "2",
"prdy_ctrt": "3.12",
"lstn_stcn": "11000000",
"acml_vol": "34510630",
"n_prdy_vol": "0",
"n_prdy_vol_vrss": "34510630",
"vol_inrt": "0.00",
"vol_tnrt": "313.73",
"nday_vol_tnrt": "313.73",
"acml_tr_pbmn": "5293873100",
"n_prdy_tr_pbmn": "5293873100",
"n_prdy_tr_pbmn_vrss": "0",
"total_askp_rsqn": "348740",
"total_bidp_rsqn": "639850",
"ntsl_rsqn": "291110",
"ntby_rsqn": "291110",
"seln_rsqn_rate": "35.28",
"shnu_rsqn_rate": "64.72",
"stck_cnvr_rate": "100.000000",
"hts_rmnn_dynu": "28",
"invl_val": "0.00",
"tmvl_val": "165.00",
"acpr": "350.00",
"lp_mbcr_name": "한국증권",
"unas_isnm": "KOSPI200",
"stck_last_tr_date": "20240509",
"unas_shrn_iscd": "2001",
"prdy_vol": "7133790",
"lp_hldn_rate": "37.29",
"prit": "95.30",
"prls_qryr_stpr_prc": "348.35",
"delta_val": "-0.160062",
"theta": "12.8688",
"prls_qryr_rate": "-5.1400",
"stck_lstn_date": "20230817",
"hts_ints_vltl": "19.97",
"lvrg_val": "-35.625000",
"lp_ntby_qty": "3185360"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 지표순위[국내주식-169]
REST
ELW 지표순위[국내주식-169]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/ranking/indicator
- Format
- Content-Type
개요
ELW 지표순위 API입니다.
한국투자 HTS(eFriend Plus) > [0279] ELW 지표순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0279] ELW 지표순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02790000 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 시장구분코드 (W) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | Unique key(20279) |
| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | String | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
| FID_INPUT_ISCD | 발행사 | String | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
| FID_DIV_CLS_CODE | 콜풋구분코드 | String | Y | 2 | 0(전체), 1(콜), 2(풋) |
| FID_INPUT_PRICE_1 | 가격(이상) | String | Y | 12 | |
| FID_INPUT_PRICE_2 | 가격(이하) | String | Y | 12 | |
| FID_INPUT_VOL_1 | 거래량(이상) | String | Y | 18 | |
| FID_INPUT_VOL_2 | 거래량(이하) | String | Y | 18 | |
| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | String | Y | 2 | 0(전환비율), 1(레버리지), 2(행사가 ), 3(내재가치), 4(시간가치) |
| FID_BLNG_CLS_CODE | 결재방법 | String | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -elw_kor_isnm | ELW한글종목명 | String | Y | 40 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -stck_cnvr_rate | 주식전환비율 | String | Y | 136 | |
| -lvrg_val | 레버리지값 | String | Y | 114 | |
| -acpr | 행사가 | String | Y | 112 | |
| -tmvl_val | 시간가치값 | String | Y | 132 | |
| -invl_val | 내재가치값 | String | Y | 132 | |
| -elw_ko_barrier | 조기종료발생기준가격 | String | Y | 112 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:20279
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
FID_COND_SCR_DIV_CODE:20279
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_RANK_SORT_CLS_CODE:0
FID_BLNG_CLS_CODE:0
Response
{
"output": [
{
"elw_shrn_iscd": "52JW82",
"elw_kor_isnm": "미래JW82KOSPI200콜",
"elw_prpr": "360",
"prdy_vrss": "-170",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-32.08",
"acml_vol": "726070",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "35.047882",
"acpr": "375.00",
"tmvl_val": "360.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW83",
"elw_kor_isnm": "미래JW83KOSPI200콜",
"elw_prpr": "450",
"prdy_vrss": "180",
"prdy_vrss_sign": "2",
"prdy_ctrt": "66.67",
"acml_vol": "194290",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "32.774658",
"acpr": "372.50",
"tmvl_val": "450.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW84",
"elw_kor_isnm": "미래JW84KOSPI200콜",
"elw_prpr": "565",
"prdy_vrss": "215",
"prdy_vrss_sign": "2",
"prdy_ctrt": "61.43",
"acml_vol": "41160",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "30.090385",
"acpr": "370.00",
"tmvl_val": "565.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW85",
"elw_kor_isnm": "미래JW85KOSPI200콜",
"elw_prpr": "640",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "30.062588",
"acpr": "367.50",
"tmvl_val": "640.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW86",
"elw_kor_isnm": "미래JW86KOSPI200콜",
"elw_prpr": "450",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "55.580410",
"acpr": "365.00",
"tmvl_val": "228.00",
"invl_val": "222.00",
"elw_ko_barrier": "0.00"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"elw_shrn_iscd": "52JW82",
"elw_kor_isnm": "미래JW82KOSPI200콜",
"elw_prpr": "360",
"prdy_vrss": "-170",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-32.08",
"acml_vol": "726070",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "35.047882",
"acpr": "375.00",
"tmvl_val": "360.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW83",
"elw_kor_isnm": "미래JW83KOSPI200콜",
"elw_prpr": "450",
"prdy_vrss": "180",
"prdy_vrss_sign": "2",
"prdy_ctrt": "66.67",
"acml_vol": "194290",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "32.774658",
"acpr": "372.50",
"tmvl_val": "450.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW84",
"elw_kor_isnm": "미래JW84KOSPI200콜",
"elw_prpr": "565",
"prdy_vrss": "215",
"prdy_vrss_sign": "2",
"prdy_ctrt": "61.43",
"acml_vol": "41160",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "30.090385",
"acpr": "370.00",
"tmvl_val": "565.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW85",
"elw_kor_isnm": "미래JW85KOSPI200콜",
"elw_prpr": "640",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "30.062588",
"acpr": "367.50",
"tmvl_val": "640.00",
"invl_val": "0.00",
"elw_ko_barrier": "0.00"
},
{
"elw_shrn_iscd": "52JW86",
"elw_kor_isnm": "미래JW86KOSPI200콜",
"elw_prpr": "450",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"stck_cnvr_rate": "100.000000",
"lvrg_val": "55.580410",
"acpr": "365.00",
"tmvl_val": "228.00",
"invl_val": "222.00",
"elw_ko_barrier": "0.00"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 민감도 순위[국내주식-170]
REST
ELW 민감도 순위[국내주식-170]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/ranking/sensitivity
- Format
- Content-Type
개요
ELW 민감도 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0285] ELW 민감도 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0285] ELW 민감도 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02850000 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 시장구분코드 (W) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | Unique key(20285) |
| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | String | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
| FID_INPUT_ISCD | 입력종목코드 | String | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
| FID_DIV_CLS_CODE | 콜풋구분코드 | String | Y | 2 | 0(전체), 1(콜), 2(풋) |
| FID_INPUT_PRICE_1 | 가격(이상) | String | Y | 12 | |
| FID_INPUT_PRICE_2 | 가격(이하) | String | Y | 12 | |
| FID_INPUT_VOL_1 | 거래량(이상) | String | Y | 18 | |
| FID_INPUT_VOL_2 | 거래량(이하) | String | Y | 18 | |
| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | String | Y | 2 | '0(이론가), 1(델타), 2(감마), 3(로), 4(베가) , 5(로)
, 6(내재변동성), 7(90일변동성)' |
| FID_INPUT_RMNN_DYNU_1 | 잔존일수(이상) | String | Y | 5 | |
| FID_INPUT_DATE_1 | 조회기준일 | String | Y | 10 | |
| FID_BLNG_CLS_CODE | 결재방법 | String | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | ||
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -elw_kor_isnm | ELW한글종목명 | String | Y | 40 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -hts_thpr | HTS이론가 | String | Y | 112 | |
| -delta_val | 델타값 | String | Y | 114 | |
| -gama | 감마 | String | Y | 84 | |
| -theta | 세타 | String | Y | 84 | |
| -vega | 베가 | String | Y | 84 | |
| -rho | 로우 | String | Y | 84 | |
| -hts_ints_vltl | HTS내재변동성 | String | Y | 114 | |
| -d90_hist_vltl | 90일역사적변동성 | String | Y | 114 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:20285
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_RANK_SORT_CLS_CODE:0
FID_INPUT_RMNN_DYNU_1:
FID_INPUT_DATE_1:
FID_BLNG_CLS_CODE:0
FID_COND_SCR_DIV_CODE:20285
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_INPUT_RMNN_DYNU_1:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_RANK_SORT_CLS_CODE:0
FID_INPUT_RMNN_DYNU_1:
FID_INPUT_DATE_1:
FID_BLNG_CLS_CODE:0
Response
{
"output": [
{
"elw_shrn_iscd": "57K852",
"elw_kor_isnm": "한국K852KOSPI200콜",
"elw_prpr": "7770",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "8290.81",
"delta_val": "1.000000",
"gama": "0.0000",
"theta": "3.8670",
"vega": "0.0000",
"rho": "19.3352",
"hts_ints_vltl": "0.00",
"d90_hist_vltl": "16.793295"
},
{
"elw_shrn_iscd": "57JAVS",
"elw_kor_isnm": "한국JAVSKOSPI200콜",
"elw_prpr": "4690",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "7891.32",
"delta_val": "1.000000",
"gama": "0.0000",
"theta": "3.9449",
"vega": "0.0000",
"rho": "119.9611",
"hts_ints_vltl": "0.00",
"d90_hist_vltl": "16.793295"
},
{
"elw_shrn_iscd": "57JAVD",
"elw_kor_isnm": "한국JAVDKOSPI200콜",
"elw_prpr": "7800",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "7793.07",
"delta_val": "0.993055",
"gama": "0.0005",
"theta": "4.3385",
"vega": "4.0200",
"rho": "91.7439",
"hts_ints_vltl": "17.48",
"d90_hist_vltl": "16.793295"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"elw_shrn_iscd": "57K852",
"elw_kor_isnm": "한국K852KOSPI200콜",
"elw_prpr": "7770",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "8290.81",
"delta_val": "1.000000",
"gama": "0.0000",
"theta": "3.8670",
"vega": "0.0000",
"rho": "19.3352",
"hts_ints_vltl": "0.00",
"d90_hist_vltl": "16.793295"
},
{
"elw_shrn_iscd": "57JAVS",
"elw_kor_isnm": "한국JAVSKOSPI200콜",
"elw_prpr": "4690",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "7891.32",
"delta_val": "1.000000",
"gama": "0.0000",
"theta": "3.9449",
"vega": "0.0000",
"rho": "119.9611",
"hts_ints_vltl": "0.00",
"d90_hist_vltl": "16.793295"
},
{
"elw_shrn_iscd": "57JAVD",
"elw_kor_isnm": "한국JAVDKOSPI200콜",
"elw_prpr": "7800",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"acml_vol": "0",
"hts_thpr": "7793.07",
"delta_val": "0.993055",
"gama": "0.0005",
"theta": "4.3385",
"vega": "4.0200",
"rho": "91.7439",
"hts_ints_vltl": "17.48",
"d90_hist_vltl": "16.793295"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 당일급변종목[국내주식-171]
REST
ELW 당일급변종목[국내주식-171]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/ranking/quick-change
- Format
- Content-Type
개요
ELW 당일급변종목 API입니다.
한국투자 HTS(eFriend Plus) > [0287] ELW 당일급변종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0287] ELW 당일급변종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02870000 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 시장구분코드 (W) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | Unique key(20287) |
| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | String | Y | 12 | '000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
| FID_INPUT_ISCD | 발행사 | String | Y | 12 | '00000(전체), 00003(한국투자증권)
, 00017(KB증권), 00005(미래에셋주식회사)' |
| FID_MRKT_CLS_CODE | 시장구분코드 | String | Y | 2 | Unique key(A) |
| FID_INPUT_PRICE_1 | 가격(이상) | String | Y | 12 | |
| FID_INPUT_PRICE_2 | 가격(이하) | String | Y | 12 | |
| FID_INPUT_VOL_1 | 거래량(이상) | String | Y | 18 | |
| FID_INPUT_VOL_2 | 거래량(이하) | String | Y | 18 | |
| FID_HOUR_CLS_CODE | 시간구분코드 | String | Y | 5 | 1(분), 2(일) |
| FID_INPUT_HOUR_1 | 입력 일 또는 분 | String | Y | 10 | |
| FID_INPUT_HOUR_2 | 기준시간(분 선택 시) | String | Y | 10 | |
| FID_RANK_SORT_CLS_CODE | 순위정렬구분코드 | String | Y | 2 | '1(가격급등), 2(가격급락), 3(거래량급증)
, 4(매수잔량급증), 5(매도잔량급증)' |
| FID_BLNG_CLS_CODE | 결재방법 | String | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -elw_kor_isnm | ELW한글종목명 | String | Y | 40 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -askp | 매도호가 | String | Y | 10 | |
| -bidp | 매수호가 | String | Y | 10 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 12 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 12 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -stnd_val | 기준값 | String | Y | 10 | |
| -stnd_val_vrss | 기준값대비 | String | Y | 11 | |
| -stnd_val_ctrt | 기준값대비율 | String | Y | 162 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:20287
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_MRKT_CLS_CODE:A
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_HOUR_CLS_CODE:2
FID_INPUT_HOUR_1:1
FID_INPUT_HOUR_2:
FID_RANK_SORT_CLS_CODE:1
FID_BLNG_CLS_CODE:0
FID_COND_SCR_DIV_CODE:20287
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD:00000
FID_MRKT_CLS_CODE:A
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:
FID_INPUT_VOL_2:
FID_HOUR_CLS_CODE:2
FID_INPUT_HOUR_1:1
FID_INPUT_HOUR_2:
FID_RANK_SORT_CLS_CODE:1
FID_BLNG_CLS_CODE:0
Response
{
"output": [
{
"elw_shrn_iscd": "57JAKW",
"elw_kor_isnm": "한국JAKWLS일렉콜",
"elw_prpr": "460",
"prdy_vrss_sign": "2",
"prdy_vrss": "350",
"prdy_ctrt": "318.18",
"askp": "0",
"bidp": "145",
"total_askp_rsqn": "0",
"total_bidp_rsqn": "49060",
"acml_vol": "3320",
"stnd_val": "110",
"stnd_val_vrss": "350",
"stnd_val_ctrt": "318.18"
},
{
"elw_shrn_iscd": "58JF27",
"elw_kor_isnm": "KBJF27KOSPI200콜",
"elw_prpr": "2395",
"prdy_vrss_sign": "2",
"prdy_vrss": "1745",
"prdy_ctrt": "268.46",
"askp": "0",
"bidp": "15",
"total_askp_rsqn": "0",
"total_bidp_rsqn": "29000",
"acml_vol": "100",
"stnd_val": "650",
"stnd_val_vrss": "1745",
"stnd_val_ctrt": "268.46"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"elw_shrn_iscd": "57JAKW",
"elw_kor_isnm": "한국JAKWLS일렉콜",
"elw_prpr": "460",
"prdy_vrss_sign": "2",
"prdy_vrss": "350",
"prdy_ctrt": "318.18",
"askp": "0",
"bidp": "145",
"total_askp_rsqn": "0",
"total_bidp_rsqn": "49060",
"acml_vol": "3320",
"stnd_val": "110",
"stnd_val_vrss": "350",
"stnd_val_ctrt": "318.18"
},
{
"elw_shrn_iscd": "58JF27",
"elw_kor_isnm": "KBJF27KOSPI200콜",
"elw_prpr": "2395",
"prdy_vrss_sign": "2",
"prdy_vrss": "1745",
"prdy_ctrt": "268.46",
"askp": "0",
"bidp": "15",
"total_askp_rsqn": "0",
"total_bidp_rsqn": "29000",
"acml_vol": "100",
"stnd_val": "650",
"stnd_val_vrss": "1745",
"stnd_val_ctrt": "268.46"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 변동성추이(체결) [국내주식-177]
REST
ELW 변동성추이(체결) [국내주식-177]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/quotations/volatility-trend-ccnl
- Format
- Content-Type
개요
ELW 변동성 추이(체결) API입니다.
한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "시간별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "시간별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02840100 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | W(Unique key) |
| FID_INPUT_ISCD | 입력종목코드 | String | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | ||
| -stck_cntg_hour | 주식체결시간 | String | Y | 6 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 82 | |
| -bidp | 매수호가 | String | Y | 10 | |
| -askp | 매도호가 | String | Y | 10 | |
| -acml_vol | 누적거래량 | String | Y | 18 | |
| -hts_ints_vltl | HTS내재변동성 | String | Y | 114 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_INPUT_ISCD:58J540
FID_INPUT_ISCD:58J540
Response
{
"output": [
{
"stck_cntg_hour": "150121",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "52690",
"hts_ints_vltl": "33.05"
},
{
"stck_cntg_hour": "140354",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "0",
"acml_vol": "52680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140340",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "0",
"acml_vol": "47680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "47670",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "42690",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "42680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "37680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "114800",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "37670",
"hts_ints_vltl": "33.49"
},
{
"stck_cntg_hour": "114046",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "32670",
"hts_ints_vltl": "26.54"
},
{
"stck_cntg_hour": "104344",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "30170",
"hts_ints_vltl": "32.33"
},
{
"stck_cntg_hour": "104344",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "27670",
"hts_ints_vltl": "32.33"
},
{
"stck_cntg_hour": "102100",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "50",
"askp": "55",
"acml_vol": "17750",
"hts_ints_vltl": "31.27"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "17730",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "17720",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7810",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "091645",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7720",
"hts_ints_vltl": "25.08"
},
{
"stck_cntg_hour": "091645",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7630",
"hts_ints_vltl": "25.08"
},
{
"stck_cntg_hour": "091502",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7620",
"hts_ints_vltl": "27.27"
},
{
"stck_cntg_hour": "091222",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "120",
"hts_ints_vltl": "32.07"
},
{
"stck_cntg_hour": "091222",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "110",
"hts_ints_vltl": "32.07"
},
{
"stck_cntg_hour": "090223",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "55",
"askp": "0",
"acml_vol": "100",
"hts_ints_vltl": "22.69"
},
{
"stck_cntg_hour": "090223",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "50",
"askp": "55",
"acml_vol": "10",
"hts_ints_vltl": "22.69"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"stck_cntg_hour": "150121",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "52690",
"hts_ints_vltl": "33.05"
},
{
"stck_cntg_hour": "140354",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "0",
"acml_vol": "52680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140340",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "0",
"acml_vol": "47680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "47670",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "42690",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "42680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "140334",
"elw_prpr": "45",
"prdy_vrss": "-10",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-18.18",
"bidp": "45",
"askp": "50",
"acml_vol": "37680",
"hts_ints_vltl": "31.96"
},
{
"stck_cntg_hour": "114800",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "37670",
"hts_ints_vltl": "33.49"
},
{
"stck_cntg_hour": "114046",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "32670",
"hts_ints_vltl": "26.54"
},
{
"stck_cntg_hour": "104344",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "30170",
"hts_ints_vltl": "32.33"
},
{
"stck_cntg_hour": "104344",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "27670",
"hts_ints_vltl": "32.33"
},
{
"stck_cntg_hour": "102100",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "50",
"askp": "55",
"acml_vol": "17750",
"hts_ints_vltl": "31.27"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "17730",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "17720",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "095235",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7810",
"hts_ints_vltl": "27.36"
},
{
"stck_cntg_hour": "091645",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7720",
"hts_ints_vltl": "25.08"
},
{
"stck_cntg_hour": "091645",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7630",
"hts_ints_vltl": "25.08"
},
{
"stck_cntg_hour": "091502",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "45",
"askp": "50",
"acml_vol": "7620",
"hts_ints_vltl": "27.27"
},
{
"stck_cntg_hour": "091222",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "120",
"hts_ints_vltl": "32.07"
},
{
"stck_cntg_hour": "091222",
"elw_prpr": "50",
"prdy_vrss": "-5",
"prdy_vrss_sign": "5",
"prdy_ctrt": "-9.09",
"bidp": "50",
"askp": "55",
"acml_vol": "110",
"hts_ints_vltl": "32.07"
},
{
"stck_cntg_hour": "090223",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "55",
"askp": "0",
"acml_vol": "100",
"hts_ints_vltl": "22.69"
},
{
"stck_cntg_hour": "090223",
"elw_prpr": "55",
"prdy_vrss": "0",
"prdy_vrss_sign": "3",
"prdy_ctrt": "0.00",
"bidp": "50",
"askp": "55",
"acml_vol": "10",
"hts_ints_vltl": "22.69"
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 신규상장종목 [국내주식-181]
REST
ELW 신규상장종목 [국내주식-181]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/quotations/newly-listed
- Format
- Content-Type
개요
ELW 신규상장종목 API입니다.
한국투자 HTS(eFriend Plus) > [0297] ELW 신규상장종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0297] ELW 신규상장종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHKEW154800C0 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 시장구분코드 (W) |
| FID_COND_SCR_DIV_CODE | 조건화면분류코드 | String | Y | 5 | Unique key(11548) |
| FID_DIV_CLS_CODE | 분류구분코드 | String | Y | 2 | 전체(02), 콜(00), 풋(01) |
| FID_UNAS_INPUT_ISCD | 기초자산입력종목코드 | String | Y | 12 | 'ex) 000000(전체), 2001(코스피200)
, 3003(코스닥150), 005930(삼성전자) ' |
| FID_INPUT_ISCD_2 | 입력종목코드2 | String | Y | 8 | '00003(한국투자증권), 00017(KB증권),
00005(미래에셋증권)' |
| FID_INPUT_DATE_1 | 입력날짜1 | String | Y | 10 | 날짜 (ex) 20240402) |
| FID_BLNC_CLS_CODE | 결재방법 | String | Y | 2 | 0(전체), 1(일반), 2(조기종료) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -stck_lstn_date | 주식상장일자 | String | Y | 8 | |
| -elw_kor_isnm | ELW한글종목명 | String | Y | 40 | |
| -elw_shrn_iscd | ELW단축종목코드 | String | Y | 9 | |
| -unas_isnm | 기초자산종목명 | String | Y | 40 | |
| -pblc_co_name | 발행회사명 | String | Y | 40 | |
| -lstn_stcn | 상장주수 | String | Y | 18 | |
| -acpr | 행사가 | String | Y | 112 | |
| -stck_last_tr_date | 주식최종거래일자 | String | Y | 8 | |
| -elw_ko_barrier | 조기종료발생기준가격 | String | Y | 112 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_COND_SCR_DIV_CODE:11548
FID_DIV_CLS_CODE:02
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD_2:00003
FID_INPUT_DATE_1:20240410
FID_BLNG_CLS_CODE:0
FID_COND_SCR_DIV_CODE:11548
FID_DIV_CLS_CODE:02
FID_UNAS_INPUT_ISCD:000000
FID_INPUT_ISCD_2:00003
FID_INPUT_DATE_1:20240410
FID_BLNG_CLS_CODE:0
Response
{
"output": [
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K924HLB콜",
"elw_shrn_iscd": "57K924",
"unas_isnm": "HLB",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7100000",
"acpr": "78000.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K925HMM콜",
"elw_shrn_iscd": "57K925",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "6700000",
"acpr": "20000.00",
"stck_last_tr_date": "20240912",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K926HMM콜",
"elw_shrn_iscd": "57K926",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "5600000",
"acpr": "20000.00",
"stck_last_tr_date": "20241212",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB45HMM풋",
"elw_shrn_iscd": "57KB45",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "6900000",
"acpr": "17700.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K927KB금융콜",
"elw_shrn_iscd": "57K927",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "24400000",
"acpr": "73600.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K928KB금융콜",
"elw_shrn_iscd": "57K928",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "22300000",
"acpr": "73600.00",
"stck_last_tr_date": "20240912",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K929KB금융콜",
"elw_shrn_iscd": "57K929",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "18200000",
"acpr": "72000.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K930KB금융콜",
"elw_shrn_iscd": "57K930",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "20000000",
"acpr": "70500.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K931KB금융콜",
"elw_shrn_iscd": "57K931",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "15700000",
"acpr": "69000.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB46KB금융풋",
"elw_shrn_iscd": "57KB46",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "11200000",
"acpr": "65000.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB47KB금융풋",
"elw_shrn_iscd": "57KB47",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "12000000",
"acpr": "63700.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB98KOSPI200풋",
"elw_shrn_iscd": "57KB98",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "400.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB99KOSPI200풋",
"elw_shrn_iscd": "57KB99",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "395.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC00KOSPI200풋",
"elw_shrn_iscd": "57KC00",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "390.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC01KOSPI200풋",
"elw_shrn_iscd": "57KC01",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "9000000",
"acpr": "387.50",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC02KOSPI200풋",
"elw_shrn_iscd": "57KC02",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "10000000",
"acpr": "385.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC03KOSPI200풋",
"elw_shrn_iscd": "57KC03",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "9000000",
"acpr": "382.50",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K924HLB콜",
"elw_shrn_iscd": "57K924",
"unas_isnm": "HLB",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7100000",
"acpr": "78000.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K925HMM콜",
"elw_shrn_iscd": "57K925",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "6700000",
"acpr": "20000.00",
"stck_last_tr_date": "20240912",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K926HMM콜",
"elw_shrn_iscd": "57K926",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "5600000",
"acpr": "20000.00",
"stck_last_tr_date": "20241212",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB45HMM풋",
"elw_shrn_iscd": "57KB45",
"unas_isnm": "HMM",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "6900000",
"acpr": "17700.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K927KB금융콜",
"elw_shrn_iscd": "57K927",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "24400000",
"acpr": "73600.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K928KB금융콜",
"elw_shrn_iscd": "57K928",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "22300000",
"acpr": "73600.00",
"stck_last_tr_date": "20240912",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K929KB금융콜",
"elw_shrn_iscd": "57K929",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "18200000",
"acpr": "72000.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K930KB금융콜",
"elw_shrn_iscd": "57K930",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "20000000",
"acpr": "70500.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국K931KB금융콜",
"elw_shrn_iscd": "57K931",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "15700000",
"acpr": "69000.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB46KB금융풋",
"elw_shrn_iscd": "57KB46",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "11200000",
"acpr": "65000.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB47KB금융풋",
"elw_shrn_iscd": "57KB47",
"unas_isnm": "KB금융",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "12000000",
"acpr": "63700.00",
"stck_last_tr_date": "20240711",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB98KOSPI200풋",
"elw_shrn_iscd": "57KB98",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "400.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KB99KOSPI200풋",
"elw_shrn_iscd": "57KB99",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "395.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC00KOSPI200풋",
"elw_shrn_iscd": "57KC00",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "7000000",
"acpr": "390.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC01KOSPI200풋",
"elw_shrn_iscd": "57KC01",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "9000000",
"acpr": "387.50",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC02KOSPI200풋",
"elw_shrn_iscd": "57KC02",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "10000000",
"acpr": "385.00",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},
{
"stck_lstn_date": "20240320",
"elw_kor_isnm": "한국KC03KOSPI200풋",
"elw_shrn_iscd": "57KC03",
"unas_isnm": "KOSPI200",
"pblc_co_name": "한국투자증권(주)",
"lstn_stcn": "9000000",
"acpr": "382.50",
"stck_last_tr_date": "20240613",
"elw_ko_barrier": "0.00"
},...
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 변동성 추이(분별) [국내주식-179]
REST
ELW 변동성 추이(분별) [국내주식-179]
기본정보
- MethodGET
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/uapi/elw/v1/quotations/volatility-trend-minute
- Format
- Content-Type
개요
ELW 변동성 추이(분별) API입니다.
한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "분별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한국투자 HTS(eFriend Plus) > [0284] ELW 변동성 추이 화면의 "분별" 변동성 추이 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02840300 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인
P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Query Parameter
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | W(Unique key) |
| FID_INPUT_ISCD | 입력종목코드 | String | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
| FID_HOUR_CLS_CODE | 시간구분코드 | String | Y | 5 | '60(1분), 180(3분), 300(5분), 600(10분), 1800(30분), 3600(60분)
' |
| FID_PW_DATA_INCU_YN | 과거데이터 포함 여부 | String | Y | 2 | N(과거데이터포함X),Y(과거데이터포함O) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output | 응답상세 | Object Array | Y | array | |
| -stck_bsop_date | 주식 영업 일자 | String | Y | 6 | |
| -stck_cntg_hour | 주식 체결 시간 | String | Y | 10 | |
| -stck_prpr | 주식 현재가 | String | Y | 10 | |
| -elw_oprc | ELW 시가2 | String | Y | 1 | |
| -elw_hgpr | ELW 최고가 | String | Y | 82 | |
| -elw_lwpr | ELW 최저가 | String | Y | 10 | |
| -hts_ints_vltl | HTS 내재 변동성 | String | Y | 10 | |
| -hist_vltl | 역사적 변동성 | String | Y | 18 |
Example
Request
FID_COND_MRKT_DIV_CODE:W
FID_INPUT_ISCD:57JS61
FID_HOUR_CLS_CODE:60
FID_PW_DATA_INCU_YN:N
FID_INPUT_ISCD:57JS61
FID_HOUR_CLS_CODE:60
FID_PW_DATA_INCU_YN:N
Response
{
"output": [
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142800",
"stck_prpr": "265",
"elw_oprc": "265",
"elw_hgpr": "265",
"elw_lwpr": "265",
"hts_ints_vltl": "21.90",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142700",
"stck_prpr": "265",
"elw_oprc": "270",
"elw_hgpr": "270",
"elw_lwpr": "260",
"hts_ints_vltl": "21.90",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142600",
"stck_prpr": "275",
"elw_oprc": "275",
"elw_hgpr": "275",
"elw_lwpr": "275",
"hts_ints_vltl": "22.06",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142500",
"stck_prpr": "270",
"elw_oprc": "275",
"elw_hgpr": "275",
"elw_lwpr": "270",
"hts_ints_vltl": "22.06",
"hist_vltl": ""
},
...
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "124900",
"stck_prpr": "275",
"elw_oprc": "280",
"elw_hgpr": "280",
"elw_lwpr": "275",
"hts_ints_vltl": "22.24",
"hist_vltl": ""
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
"output": [
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142800",
"stck_prpr": "265",
"elw_oprc": "265",
"elw_hgpr": "265",
"elw_lwpr": "265",
"hts_ints_vltl": "21.90",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142700",
"stck_prpr": "265",
"elw_oprc": "270",
"elw_hgpr": "270",
"elw_lwpr": "260",
"hts_ints_vltl": "21.90",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142600",
"stck_prpr": "275",
"elw_oprc": "275",
"elw_hgpr": "275",
"elw_lwpr": "275",
"hts_ints_vltl": "22.06",
"hist_vltl": ""
},
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "142500",
"stck_prpr": "270",
"elw_oprc": "275",
"elw_hgpr": "275",
"elw_lwpr": "270",
"hts_ints_vltl": "22.06",
"hist_vltl": ""
},
...
{
"stck_bsop_date": "20240422",
"stck_cntg_hour": "124900",
"stck_prpr": "275",
"elw_oprc": "280",
"elw_hgpr": "280",
"elw_lwpr": "275",
"hts_ints_vltl": "22.24",
"hist_vltl": ""
}
],
"rt_cd": "0",
"msg_cd": "MCA00000",
"msg1": "정상처리 되었습니다."
}
ELW 민감도 추이(체결) [국내주식-175]
REST
ELW 민감도 추이(체결) [국내주식-175]
기본정보
- Method
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain미지원
- URL/uapi/elw/v1/quotations/sensitivity-trend-ccnl
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| authorization | 접근토큰 | String | Y | 40 | OAuth 토큰이 필요한 API 경우 발급한 Access token 일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용) 법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용) |
| appkey | 앱키 | String | Y | 36 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| appsecret | 앱시크릿키 | String | Y | 180 | 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.) |
| personalseckey | 고객식별키 | String | N | 180 | [법인 필수] 제휴사 회원 관리를 위한 고객식별키 |
| tr_id | 거래ID | String | Y | 13 | FHPEW02830100 |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회 N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 P : 개인 |
| seq_no | 일련번호 | String | N | 2 | [법인 필수] 001 |
| mac_address | 맥주소 | String | N | 12 | 법인고객 혹은 개인고객의 Mac address 값 |
| phone_number | 핸드폰번호 | String | N | 12 | [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호 ex) 01011112222 (하이픈 등 구분값 제거) |
| ip_addr | 접속 단말 공인 IP | String | N | 12 | [법인 필수] 사용자(회원)의 IP Address |
| hashkey | 해쉬키 | String | N | 256 | [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값 * API문서 > hashkey 참조 |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| FID_COND_MRKT_DIV_CODE | 조건시장분류코드 | String | Y | 2 | 시장구분코드 (W) |
| FID_INPUT_ISCD | 입력종목코드 | String | Y | 12 | ex) 58J297(KBJ297삼성전자콜) |
Response
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| content-type | 컨텐츠타입 | String | Y | 40 | application/json; charset=utf-8 |
| tr_id | 거래ID | String | Y | 13 | 요청한 tr_id |
| tr_cont | 연속 거래 여부 | String | N | 1 | 공백 : 초기 조회 N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우) |
| gt_uid | Global UID | String | N | 32 | [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| rt_cd | 성공 실패 여부 | String | Y | 1 | |
| msg_cd | 응답코드 | String | Y | 8 | |
| msg1 | 응답메세지 | String | Y | 80 | |
| output1 | 응답상세 | Object Array | Y | array | |
| -stck_cntg_hour | 주식체결시간 | String | Y | 6 | |
| -elw_prpr | ELW현재가 | String | Y | 10 | |
| -prdy_vrss | 전일대비 | String | Y | 10 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 8.2 | |
| -hts_thpr | hts 이론가 | String | Y | 11.2 | |
| -delta_val | 델타 값 | String | Y | 11.4 | |
| -gama | 감마 | String | Y | 8.4 | |
| -theta | 세타 | String | Y | 8.4 | |
| -vega | 베가 | String | Y | 8.4 | |
| -rho | 로우 | String | Y | 8.4 |