API 문서 HOME API 문서 [국내선물옵션] 실시간시세
[국내선물옵션] 실시간시세
지수선물 실시간체결가[실시간-010]
WEBSOCKET
지수선물 실시간체결가[실시간-010]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0IFCNT0
- Format
- Content-Type
개요
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
종목코드 마스터파일 파이썬 정제코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/tree/main/stocks_info
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0IFCNT0 |
| tr_key | 코드 | String | Y | 6 | 예:101S12 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물 단축 종목코드 | Object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 16 | |
| -futs_prdy_vrss | 선물 전일 대비 | String | Y | 1 | |
| -prdy_vrss_sign | 전일 대비 부호 | String | Y | 8 | |
| -futs_prdy_ctrt | 선물 전일 대비율 | String | Y | 8 | |
| -futs_prpr | 선물 현재가 | String | Y | 8 | |
| -futs_oprc | 선물 시가2 | String | Y | 8 | |
| -futs_hgpr | 선물 최고가 | String | Y | 8 | |
| -futs_lwpr | 선물 최저가 | String | Y | 8 | |
| -last_cnqn | 최종 거래량 | String | Y | 8 | |
| -acml_vol | 누적 거래량 | String | Y | 8 | |
| -acml_tr_pbmn | 누적 거래 대금 | String | Y | 8 | |
| -hts_thpr | HTS 이론가 | String | Y | 8 | |
| -mrkt_basis | 시장 베이시스 | String | Y | 8 | |
| -dprt | 괴리율 | String | Y | 8 | |
| -nmsc_fctn_stpl_prc | 근월물 약정가 | String | Y | 8 | |
| -fmsc_fctn_stpl_prc | 원월물 약정가 | String | Y | 8 | |
| -spead_prc | 스프레드1 | String | Y | 8 | |
| -hts_otst_stpl_qty | HTS 미결제 약정 수량 | String | Y | 8 | |
| -otst_stpl_qty_icdc | 미결제 약정 수량 증감 | String | Y | 8 | |
| -oprc_hour | 시가 시간 | String | Y | 8 | |
| -oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | String | Y | 8 | |
| -oprc_vrss_nmix_prpr | 시가 대비 지수 현재가 | String | Y | 8 | |
| -hgpr_hour | 최고가 시간 | String | Y | 8 | |
| -hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | String | Y | 8 | |
| -hgpr_vrss_nmix_prpr | 최고가 대비 지수 현재가 | String | Y | 8 | |
| -lwpr_hour | 최저가 시간 | String | Y | 8 | |
| -lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | String | Y | 8 | |
| -lwpr_vrss_nmix_prpr | 최저가 대비 지수 현재가 | String | Y | 8 | |
| -shnu_rate | 매수2 비율 | String | Y | 8 | |
| -cttr | 체결강도 | String | Y | 8 | |
| -esdg | 괴리도 | String | Y | 8 | |
| -otst_stpl_rgbf_qty_icdc | 미결제 약정 직전 수량 증감 | String | Y | 8 | |
| -thpr_basis | 이론 베이시스 | String | Y | 8 | |
| -futs_askp1 | 선물 매도호가1 | String | Y | 8 | |
| -futs_bidp1 | 선물 매수호가1 | String | Y | 8 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 8 | |
| -seln_cntg_csnu | 매도 체결 건수 | String | Y | 6 | |
| -shnu_cntg_csnu | 매수 체결 건수 | String | Y | 6 | |
| -ntby_cntg_csnu | 순매수 체결 건수 | String | Y | 6 | |
| -seln_cntg_smtn | 총 매도 수량 | String | Y | 6 | |
| -shnu_cntg_smtn | 총 매수 수량 | String | Y | 6 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 6 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 6 | |
| -prdy_vol_vrss_acml_vol_rate | 전일 거래량 대비 등락율 | String | Y | 6 | |
| -dscs_bltr_acml_qty | 협의 대량 거래량 | String | Y | 6 | |
| -dynm_mxpr | 실시간상한가 | String | Y | 8 | |
| -dynm_llam | 실시간하한가 | String | Y | 6 | |
| -dynm_prc_limt_yn | 실시간가격제한구분 | String | Y | 10 |
지수선물 실시간호가[실시간-011]
WEBSOCKET
지수선물 실시간호가[실시간-011]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0IFASP0
- Format
- Content-Type
개요
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0IFASP0 |
| tr_key | 코드 | String | Y | 6 | 예:101S12 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물 단축 종목코드 | Object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 16 | |
| -futs_askp1 | 선물 매도호가1 | String | Y | 1 | |
| -futs_askp2 | 선물 매도호가2 | String | Y | 8 | |
| -futs_askp3 | 선물 매도호가3 | String | Y | 8 | |
| -futs_askp4 | 선물 매도호가4 | String | Y | 8 | |
| -futs_askp5 | 선물 매도호가5 | String | Y | 8 | |
| -futs_bidp1 | 선물 매수호가1 | String | Y | 8 | |
| -futs_bidp2 | 선물 매수호가2 | String | Y | 8 | |
| -futs_bidp3 | 선물 매수호가3 | String | Y | 8 | |
| -futs_bidp4 | 선물 매수호가4 | String | Y | 8 | |
| -futs_bidp5 | 선물 매수호가5 | String | Y | 8 | |
| -askp_csnu1 | 매도호가 건수1 | String | Y | 8 | |
| -askp_csnu2 | 매도호가 건수2 | String | Y | 8 | |
| -askp_csnu3 | 매도호가 건수3 | String | Y | 8 | |
| -askp_csnu4 | 매도호가 건수4 | String | Y | 8 | |
| -askp_csnu5 | 매도호가 건수5 | String | Y | 8 | |
| -bidp_csnu1 | 매수호가 건수1 | String | Y | 8 | |
| -bidp_csnu2 | 매수호가 건수2 | String | Y | 8 | |
| -bidp_csnu3 | 매수호가 건수3 | String | Y | 8 | |
| -bidp_csnu4 | 매수호가 건수4 | String | Y | 8 | |
| -bidp_csnu5 | 매수호가 건수5 | String | Y | 8 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 8 | |
| -askp_rsqn2 | 매도호가 잔량2 | String | Y | 8 | |
| -askp_rsqn3 | 매도호가 잔량3 | String | Y | 8 | |
| -askp_rsqn4 | 매도호가 잔량4 | String | Y | 8 | |
| -askp_rsqn5 | 매도호가 잔량5 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 8 | |
| -bidp_rsqn2 | 매수호가 잔량2 | String | Y | 8 | |
| -bidp_rsqn3 | 매수호가 잔량3 | String | Y | 8 | |
| -bidp_rsqn4 | 매수호가 잔량4 | String | Y | 8 | |
| -bidp_rsqn5 | 매수호가 잔량5 | String | Y | 8 | |
| -total_askp_csnu | 총 매도호가 건수 | String | Y | 8 | |
| -total_bidp_csnu | 총 매수호가 건수 | String | Y | 8 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 8 | |
| -total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | String | Y | 8 | |
| -total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | String | Y | 8 |
선물옵션 실시간체결통보[실시간-012]
WEBSOCKET
선물옵션 실시간체결통보[실시간-012]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0IFCNI0
- Format
- Content-Type
개요
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| tr_type | 등록/해제 | String | Y | 1 | 1: 등록, 2:해제 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0IFCNI0 |
| tr_key | 코드 | String | Y | 6 | 예:101S12 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| cust_id | 고객 ID | Array | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -acnt_no | 계좌번호 | String | Y | 16 | |
| -oder_no | 주문번호 | String | Y | 1 | |
| -ooder_no | 원주문번호 | String | Y | 8 | |
| -seln_byov_cls | 매도매수구분 | String | Y | 8 | 01:매도, 02매수 |
| -rctf_cls | 정정구분 | String | Y | 8 | |
| -oder_kind2 | 주문종류2 | String | Y | 8 | L: 주문접수통보, 0: 체결통보 |
| -stck_shrn_iscd | 주식 단축 종목코드 | String | Y | 8 | |
| -cntg_qty | 체결 수량 | String | Y | 8 | |
| -cntg_unpr | 체결단가 | String | Y | 8 | |
| -stck_cntg_hour | 주식 체결 시간 | String | Y | 8 | |
| -rfus_yn | 거부여부 | String | Y | 8 | |
| -cntg_yn | 체결여부 | String | Y | 8 | 1: 주문,정정,취소,거부 통보, 2 체결 |
| -acpt_yn | 접수여부 | String | Y | 8 | 1:주문접수, 2:확인, 3, 취소 |
| -brnc_no | 지점번호 | String | Y | 8 | |
| -oder_qty | 주문수량 | String | Y | 8 | |
| -acnt_name | 계좌명 | String | Y | 8 | |
| -cntg_isnm | 체결종목명 | String | Y | 8 | |
| -oder_cond | 주문조건 | String | Y | 8 | |
| -ord_grp | 주문그룹ID | String | Y | 8 | |
| -ord_grpseq | 주문그룹SEQ | String | Y | 8 | |
| -order_prc | 주문가격 | String | Y | 8 |
지수옵션 실시간체결가[실시간-014]
WEBSOCKET
지수옵션 실시간체결가[실시간-014]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0IOCNT0
- Format
- Content-Type
개요
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0IOCNT0 |
| tr_key | 코드 | String | Y | 6 | 예:201S11305 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| optn_shrn_iscd | 옵션 단축 종목코드 | Object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 16 | |
| -optn_prpr | 옵션 현재가 | String | Y | 1 | |
| -prdy_vrss_sign | 전일 대비 부호 | String | Y | 8 | |
| -optn_prdy_vrss | 옵션 전일 대비 | String | Y | 8 | |
| -prdy_ctrt | 전일 대비율 | String | Y | 8 | |
| -optn_oprc | 옵션 시가2 | String | Y | 8 | |
| -optn_hgpr | 옵션 최고가 | String | Y | 8 | |
| -optn_lwpr | 옵션 최저가 | String | Y | 8 | |
| -last_cnqn | 최종 거래량 | String | Y | 8 | |
| -acml_vol | 누적 거래량 | String | Y | 8 | |
| -acml_tr_pbmn | 누적 거래 대금 | String | Y | 8 | |
| -hts_thpr | HTS 이론가 | String | Y | 8 | |
| -hts_otst_stpl_qty | HTS 미결제 약정 수량 | String | Y | 8 | |
| -otst_stpl_qty_icdc | 미결제 약정 수량 증감 | String | Y | 8 | |
| -oprc_hour | 시가 시간 | String | Y | 8 | |
| -oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | String | Y | 8 | |
| -oprc_vrss_nmix_prpr | 시가 대비 지수 현재가 | String | Y | 8 | |
| -hgpr_hour | 최고가 시간 | String | Y | 8 | |
| -hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | String | Y | 8 | |
| -hgpr_vrss_nmix_prpr | 최고가 대비 지수 현재가 | String | Y | 8 | |
| -lwpr_hour | 최저가 시간 | String | Y | 8 | |
| -lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | String | Y | 8 | |
| -lwpr_vrss_nmix_prpr | 최저가 대비 지수 현재가 | String | Y | 8 | |
| -shnu_rate | 매수2 비율 | String | Y | 8 | |
| -prmm_val | 프리미엄 값 | String | Y | 8 | |
| -invl_val | 내재가치 값 | String | Y | 8 | |
| -tmvl_val | 시간가치 값 | String | Y | 8 | |
| -delta | 델타 | String | Y | 8 | |
| -gama | 감마 | String | Y | 8 | |
| -vega | 베가 | String | Y | 8 | |
| -theta | 세타 | String | Y | 8 | |
| -rho | 로우 | String | Y | 8 | |
| -hts_ints_vltl | HTS 내재 변동성 | String | Y | 8 | |
| -esdg | 괴리도 | String | Y | 8 | |
| -otst_stpl_rgbf_qty_icdc | 미결제 약정 직전 수량 증감 | String | Y | 8 | |
| -thpr_basis | 이론 베이시스 | String | Y | 8 | |
| -unas_hist_vltl | 역사적변동성 | String | Y | 8 | |
| -cttr | 체결강도 | String | Y | 8 | |
| -dprt | 괴리율 | String | Y | 8 | |
| -mrkt_basis | 시장 베이시스 | String | Y | 8 | |
| -optn_askp1 | 옵션 매도호가1 | String | Y | 8 | |
| -optn_bidp1 | 옵션 매수호가1 | String | Y | 8 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 8 | |
| -seln_cntg_csnu | 매도 체결 건수 | String | Y | 8 | |
| -shnu_cntg_csnu | 매수 체결 건수 | String | Y | 8 | |
| -ntby_cntg_csnu | 순매수 체결 건수 | String | Y | 8 | |
| -seln_cntg_smtn | 총 매도 수량 | String | Y | 8 | |
| -shnu_cntg_smtn | 총 매수 수량 | String | Y | 6 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 6 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 6 | |
| -prdy_vol_vrss_acml_vol_rate | 전일 거래량 대비 등락율 | String | Y | 6 | |
| -avrg_vltl | 평균 변동성 | String | Y | 6 | |
| -dscs_lrqn_vol | 협의대량누적 거래량 | String | Y | 6 | |
| -dynm_mxpr | 실시간상한가 | String | Y | 6 | |
| -dynm_llam | 실시간하한가 | String | Y | 6 | |
| -dynm_prc_limt_yn | 실시간가격제한구분 | String | Y | 6 |
지수옵션 실시간호가[실시간-015]
WEBSOCKET
지수옵션 실시간호가[실시간-015]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0IOASP0
- Format
- Content-Type
개요
[참고자료]
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
실시간시세(웹소켓) 파이썬 샘플코드는 한국투자증권 Github 참고 부탁드립니다.
https://github.com/koreainvestment/open-trading-api/blob/main/websocket/python/ws_domestic_overseas_all.py
실시간시세(웹소켓) API 사용방법에 대한 자세한 설명은 한국투자증권 Wikidocs 참고 부탁드립니다.
https://wikidocs.net/book/7847 (국내주식 업데이트 완료, 추후 해외주식·국내선물옵션 업데이트 예정)
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0IOASP0 |
| tr_key | 코드 | String | Y | 6 | 예:201S11305 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| optn_shrn_iscd | 옵션 단축 종목코드 | Object | Y | 16 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 16 | |
| -optn_askp1 | 옵션 매도호가1 | String | Y | 1 | |
| -optn_askp2 | 옵션 매도호가2 | String | Y | 8 | |
| -optn_askp3 | 옵션 매도호가3 | String | Y | 8 | |
| -optn_askp4 | 옵션 매도호가4 | String | Y | 8 | |
| -optn_askp5 | 옵션 매도호가5 | String | Y | 8 | |
| -optn_bidp1 | 옵션 매수호가1 | String | Y | 8 | |
| -optn_bidp2 | 옵션 매수호가2 | String | Y | 8 | |
| -optn_bidp3 | 옵션 매수호가3 | String | Y | 8 | |
| -optn_bidp4 | 옵션 매수호가4 | String | Y | 8 | |
| -optn_bidp5 | 옵션 매수호가5 | String | Y | 8 | |
| -askp_csnu1 | 매도호가 건수1 | String | Y | 8 | |
| -askp_csnu2 | 매도호가 건수2 | String | Y | 8 | |
| -askp_csnu3 | 매도호가 건수3 | String | Y | 8 | |
| -askp_csnu4 | 매도호가 건수4 | String | Y | 8 | |
| -askp_csnu5 | 매도호가 건수5 | String | Y | 8 | |
| -bidp_csnu1 | 매수호가 건수1 | String | Y | 8 | |
| -bidp_csnu2 | 매수호가 건수2 | String | Y | 8 | |
| -bidp_csnu3 | 매수호가 건수3 | String | Y | 8 | |
| -bidp_csnu4 | 매수호가 건수4 | String | Y | 8 | |
| -bidp_csnu5 | 매수호가 건수5 | String | Y | 8 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 8 | |
| -askp_rsqn2 | 매도호가 잔량2 | String | Y | 8 | |
| -askp_rsqn3 | 매도호가 잔량3 | String | Y | 8 | |
| -askp_rsqn4 | 매도호가 잔량4 | String | Y | 8 | |
| -askp_rsqn5 | 매도호가 잔량5 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 8 | |
| -bidp_rsqn2 | 매수호가 잔량2 | String | Y | 8 | |
| -bidp_rsqn3 | 매수호가 잔량3 | String | Y | 8 | |
| -bidp_rsqn4 | 매수호가 잔량4 | String | Y | 8 | |
| -bidp_rsqn5 | 매수호가 잔량5 | String | Y | 8 | |
| -total_askp_csnu | 총 매도호가 건수 | String | Y | 8 | |
| -total_bidp_csnu | 총 매수호가 건수 | String | Y | 8 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 8 | |
| -total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | String | Y | 8 | |
| -total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | String | Y | 8 |
상품선물 실시간체결가[실시간-022]
WEBSOCKET
상품선물 실시간체결가[실시간-022]
기본정보
- Method
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/tryitout/H0CFCNT0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0CFCNT0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물 단축 종목코드 | Object | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 9 | |
| -futs_prdy_vrss | 선물 전일 대비 | String | Y | 6 | |
| -prdy_vrss_sign | 전일 대비 부호 | String | Y | 8 | |
| -futs_prdy_ctrt | 선물 전일 대비율 | String | Y | 1 | |
| -futs_prpr | 선물 현재가 | String | Y | 8 | |
| -futs_oprc | 선물 시가2 | String | Y | 8 | |
| -futs_hgpr | 선물 최고가 | String | Y | 8 | |
| -futs_lwpr | 선물 최저가 | String | Y | 8 | |
| -last_cnqn | 최종 거래량 | String | Y | 8 | |
| -acml_vol | 누적 거래량 | String | Y | 8 | |
| -acml_tr_pbmn | 누적 거래 대금 | String | Y | 8 | |
| -hts_thpr | HTS 이론가 | String | Y | 8 | |
| -mrkt_basis | 시장 베이시스 | String | Y | 8 | |
| -dprt | 괴리율 | String | Y | 8 | |
| -nmsc_fctn_stpl_prc | 근월물 약정가 | String | Y | 8 | |
| -fmsc_fctn_stpl_prc | 원월물 약정가 | String | Y | 8 | |
| -spead_prc | 스프레드1 | String | Y | 8 | |
| -hts_otst_stpl_qty | HTS 미결제 약정 수량 | String | Y | 8 | |
| -otst_stpl_qty_icdc | 미결제 약정 수량 증감 | String | Y | 8 | |
| -oprc_hour | 시가 시간 | String | Y | 4 | |
| -oprc_vrss_prpr_sign | 시가2 대비 현재가 부호 | String | Y | 6 | |
| -oprc_vrss_nmix_prpr | 시가 대비 지수 현재가 | String | Y | 1 | |
| -hgpr_hour | 최고가 시간 | String | Y | 8 | |
| -hgpr_vrss_prpr_sign | 최고가 대비 현재가 부호 | String | Y | 6 | |
| -hgpr_vrss_nmix_prpr | 최고가 대비 지수 현재가 | String | Y | 1 | |
| -lwpr_hour | 최저가 시간 | String | Y | 8 | |
| -lwpr_vrss_prpr_sign | 최저가 대비 현재가 부호 | String | Y | 6 | |
| -lwpr_vrss_nmix_prpr | 최저가 대비 지수 현재가 | String | Y | 1 | |
| -shnu_rate | 매수2 비율 | String | Y | 8 | |
| -cttr | 체결강도 | String | Y | 8 | |
| -esdg | 괴리도 | String | Y | 8 | |
| -otst_stpl_rgbf_qty_icdc | 미결제 약정 직전 수량 증감 | String | Y | 8 | |
| -thpr_basis | 이론 베이시스 | String | Y | 4 | |
| -futs_askp1 | 선물 매도호가1 | String | Y | 8 | |
| -futs_bidp1 | 선물 매수호가1 | String | Y | 8 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 8 | |
| -seln_cntg_csnu | 매도 체결 건수 | String | Y | 8 | |
| -shnu_cntg_csnu | 매수 체결 건수 | String | Y | 4 | |
| -ntby_cntg_csnu | 순매수 체결 건수 | String | Y | 4 | |
| -seln_cntg_smtn | 총 매도 수량 | String | Y | 4 | |
| -shnu_cntg_smtn | 총 매수 수량 | String | Y | 8 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 8 | |
| -prdy_vol_vrss_acml_vol_rate | 전일 거래량 대비 등락율 | String | Y | 8 | |
| -dscs_bltr_acml_qty | 협의 대량 거래량 | String | Y | 8 | |
| -dynm_mxpr | 실시간상한가 | String | Y | 8 | |
| -dynm_llam | 실시간하한가 | String | Y | 8 | |
| -dynm_prc_limt_yn | 실시간가격제한구분 | String | Y | 8 |
상품선물 실시간호가[실시간-023]
WEBSOCKET
상품선물 실시간호가[실시간-023]
기본정보
- Method
- 실전 Domainhttps://openapi.koreainvestment.com:9443
- 모의 Domain모의투자 미지원
- URL/tryitout/H0CFASP0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0CFASP0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물 단축 종목코드 | Object | Y | 32 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업 시간 | String | Y | 9 | |
| -futs_askp1 | 선물 매도호가1 | String | Y | 6 | |
| -futs_askp2 | 선물 매도호가2 | String | Y | 8 | |
| -futs_askp3 | 선물 매도호가3 | String | Y | 1 | |
| -futs_askp4 | 선물 매도호가4 | String | Y | 8 | |
| -futs_askp5 | 선물 매도호가5 | String | Y | 8 | |
| -futs_bidp1 | 선물 매수호가1 | String | Y | 8 | |
| -futs_bidp2 | 선물 매수호가2 | String | Y | 8 | |
| -futs_bidp3 | 선물 매수호가3 | String | Y | 8 | |
| -futs_bidp4 | 선물 매수호가4 | String | Y | 8 | |
| -futs_bidp5 | 선물 매수호가5 | String | Y | 8 | |
| -askp_csnu1 | 매도호가 건수1 | String | Y | 8 | |
| -askp_csnu2 | 매도호가 건수2 | String | Y | 8 | |
| -askp_csnu3 | 매도호가 건수3 | String | Y | 8 | |
| -askp_csnu4 | 매도호가 건수4 | String | Y | 8 | |
| -askp_csnu5 | 매도호가 건수5 | String | Y | 8 | |
| -bidp_csnu1 | 매수호가 건수1 | String | Y | 8 | |
| -bidp_csnu2 | 매수호가 건수2 | String | Y | 8 | |
| -bidp_csnu3 | 매수호가 건수3 | String | Y | 8 | |
| -bidp_csnu4 | 매수호가 건수4 | String | Y | 4 | |
| -bidp_csnu5 | 매수호가 건수5 | String | Y | 6 | |
| -askp_rsqn1 | 매도호가 잔량1 | String | Y | 1 | |
| -askp_rsqn2 | 매도호가 잔량2 | String | Y | 8 | |
| -askp_rsqn3 | 매도호가 잔량3 | String | Y | 6 | |
| -askp_rsqn4 | 매도호가 잔량4 | String | Y | 1 | |
| -askp_rsqn5 | 매도호가 잔량5 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가 잔량1 | String | Y | 6 | |
| -bidp_rsqn2 | 매수호가 잔량2 | String | Y | 1 | |
| -bidp_rsqn3 | 매수호가 잔량3 | String | Y | 8 | |
| -bidp_rsqn4 | 매수호가 잔량4 | String | Y | 8 | |
| -bidp_rsqn5 | 매수호가 잔량5 | String | Y | 8 | |
| -total_askp_csnu | 총 매도호가 건수 | String | Y | 8 | |
| -total_bidp_csnu | 총 매수호가 건수 | String | Y | 4 | |
| -total_askp_rsqn | 총 매도호가 잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총 매수호가 잔량 | String | Y | 8 | |
| -total_askp_rsqn_icdc | 총 매도호가 잔량 증감 | String | Y | 8 | |
| -total_bidp_rsqn_icdc | 총 매수호가 잔량 증감 | String | Y | 8 |
주식선물 실시간체결가 [실시간-029]
WEBSOCKET
주식선물 실시간체결가 [실시간-029]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0ZFCNT0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0ZFCNT0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물단축종목코드 | Object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업시간 | String | Y | 6 | |
| -stck_prpr | 주식현재가 | String | Y | 4 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -prdy_vrss | 전일대비 | String | Y | 4 | |
| -futs_prdy_ctrt | 선물전일대비율 | String | Y | 8 | |
| -stck_oprc | 주식시가2 | String | Y | 4 | |
| -stck_hgpr | 주식최고가 | String | Y | 4 | |
| -stck_lwpr | 주식최저가 | String | Y | 4 | |
| -last_cnqn | 최종거래량 | String | Y | 8 | |
| -acml_vol | 누적거래량 | String | Y | 8 | |
| -acml_tr_pbmn | 누적거래대금 | String | Y | 8 | |
| -hts_thpr | HTS이론가 | String | Y | 8 | |
| -mrkt_basis | 시장베이시스 | String | Y | 8 | |
| -dprt | 괴리율 | String | Y | 8 | |
| -nmsc_fctn_stpl_prc | 근월물약정가 | String | Y | 8 | |
| -fmsc_fctn_stpl_prc | 원월물약정가 | String | Y | 8 | |
| -spead_prc | 스프레드1 | String | Y | 8 | |
| -hts_otst_stpl_qty | HTS미결제약정수량 | String | Y | 8 | |
| -otst_stpl_qty_icdc | 미결제약정수량증감 | String | Y | 4 | |
| -oprc_hour | 시가시간 | String | Y | 6 | |
| -oprc_vrss_prpr_sign | 시가2대비현재가부호 | String | Y | 1 | |
| -oprc_vrss_prpr | 시가2대비현재가 | String | Y | 4 | |
| -hgpr_hour | 최고가시간 | String | Y | 6 | |
| -hgpr_vrss_prpr_sign | 최고가대비현재가부호 | String | Y | 1 | |
| -hgpr_vrss_prpr | 최고가대비현재가 | String | Y | 4 | |
| -lwpr_hour | 최저가시간 | String | Y | 6 | |
| -lwpr_vrss_prpr_sign | 최저가대비현재가부호 | String | Y | 1 | |
| -lwpr_vrss_prpr | 최저가대비현재가 | String | Y | 4 | |
| -shnu_rate | 매수2비율 | String | Y | 8 | |
| -cttr | 체결강도 | String | Y | 8 | |
| -esdg | 괴리도 | String | Y | 8 | |
| -otst_stpl_rgbf_qty_icdc | 미결제약정직전수량증감 | String | Y | 4 | |
| -thpr_basis | 이론베이시스 | String | Y | 8 | |
| -askp1 | 매도호가1 | String | Y | 4 | |
| -bidp1 | 매수호가1 | String | Y | 4 | |
| -askp_rsqn1 | 매도호가잔량1 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가잔량1 | String | Y | 8 | |
| -seln_cntg_csnu | 매도체결건수 | String | Y | 4 | |
| -shnu_cntg_csnu | 매수체결건수 | String | Y | 4 | |
| -ntby_cntg_csnu | 순매수체결건수 | String | Y | 4 | |
| -seln_cntg_smtn | 총매도수량 | String | Y | 8 | |
| -shnu_cntg_smtn | 총매수수량 | String | Y | 8 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 8 | |
| -prdy_vol_vrss_acml_vol_rate | 전일거래량대비등락율 | String | Y | 8 | |
| -dynm_mxpr | 실시간상한가 | String | Y | 4 | |
| -dynm_llam | 실시간하한가 | String | Y | 4 | |
| -dynm_prc_limt_yn | 실시간가격제한구분 | String | Y | 1 |
Example
Request
{
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZFCNT0",
"tr_key": "111V06"
}
}
}
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZFCNT0",
"tr_key": "111V06"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0ZFCNT0",
"tr_key": "111V06",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZFCNT0|001|111V06^091639^77900^5^-100^-0.13^77900^77900^77300^5^1724^13
37128000^77899.50^400.00^0.00^0.00^0.00^-500.00^32053^219^000000^3^0^000000^3^0^000000^2^600^
0.36^58.23^0.50^-1^399.50^77900^77800^0^0^105^36^-69^1075^626^0^0^6.23^0^0^0
{
"header": {
"tr_id": "H0ZFCNT0",
"tr_key": "111V06",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZFCNT0|001|111V06^091639^77900^5^-100^-0.13^77900^77900^77300^5^1724^13
37128000^77899.50^400.00^0.00^0.00^0.00^-500.00^32053^219^000000^3^0^000000^3^0^000000^2^600^
0.36^58.23^0.50^-1^399.50^77900^77800^0^0^105^36^-69^1075^626^0^0^6.23^0^0^0
주식선물 실시간호가 [실시간-030]
WEBSOCKET
주식선물 실시간호가 [실시간-030]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0ZFASP0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0ZFASP0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| futs_shrn_iscd | 선물단축종목코드 | Object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업시간 | String | Y | 6 | |
| -askp1 | 매도호가1 | String | Y | 1 | |
| -askp2 | 매도호가2 | String | Y | 1 | |
| -askp3 | 매도호가3 | String | Y | 1 | |
| -askp4 | 매도호가4 | String | Y | 1 | |
| -askp5 | 매도호가5 | String | Y | 1 | |
| -askp6 | 매도호가6 | String | Y | 1 | |
| -askp7 | 매도호가7 | String | Y | 1 | |
| -askp8 | 매도호가8 | String | Y | 1 | |
| -askp9 | 매도호가9 | String | Y | 1 | |
| -askp10 | 매도호가10 | String | Y | 1 | |
| -bidp1 | 매수호가1 | String | Y | 1 | |
| -bidp2 | 매수호가2 | String | Y | 1 | |
| -bidp3 | 매수호가3 | String | Y | 1 | |
| -bidp4 | 매수호가4 | String | Y | 1 | |
| -bidp5 | 매수호가5 | String | Y | 1 | |
| -bidp6 | 매수호가6 | String | Y | 1 | |
| -bidp7 | 매수호가7 | String | Y | 1 | |
| -bidp8 | 매수호가8 | String | Y | 1 | |
| -bidp9 | 매수호가9 | String | Y | 1 | |
| -bidp10 | 매수호가10 | String | Y | 1 | |
| -askp_csnu1 | 매도호가건수1 | String | Y | 1 | |
| -askp_csnu2 | 매도호가건수2 | String | Y | 1 | |
| -askp_csnu3 | 매도호가건수3 | String | Y | 1 | |
| -askp_csnu4 | 매도호가건수4 | String | Y | 1 | |
| -askp_csnu5 | 매도호가건수5 | String | Y | 1 | |
| -askp_csnu6 | 매도호가건수6 | String | Y | 1 | |
| -askp_csnu7 | 매도호가건수7 | String | Y | 1 | |
| -askp_csnu8 | 매도호가건수8 | String | Y | 1 | |
| -askp_csnu9 | 매도호가건수9 | String | Y | 1 | |
| -askp_csnu10 | 매도호가건수10 | String | Y | 1 | |
| -bidp_csnu1 | 매수호가건수1 | String | Y | 1 | |
| -bidp_csnu2 | 매수호가건수2 | String | Y | 1 | |
| -bidp_csnu3 | 매수호가건수3 | String | Y | 1 | |
| -bidp_csnu4 | 매수호가건수4 | String | Y | 1 | |
| -bidp_csnu5 | 매수호가건수5 | String | Y | 1 | |
| -bidp_csnu6 | 매수호가건수6 | String | Y | 1 | |
| -bidp_csnu7 | 매수호가건수7 | String | Y | 1 | |
| -bidp_csnu8 | 매수호가건수8 | String | Y | 1 | |
| -bidp_csnu9 | 매수호가건수9 | String | Y | 1 | |
| -bidp_csnu10 | 매수호가건수10 | String | Y | 1 | |
| -askp_rsqn1 | 매도호가잔량1 | String | Y | 1 | |
| -askp_rsqn2 | 매도호가잔량2 | String | Y | 1 | |
| -askp_rsqn3 | 매도호가잔량3 | String | Y | 1 | |
| -askp_rsqn4 | 매도호가잔량4 | String | Y | 1 | |
| -askp_rsqn5 | 매도호가잔량5 | String | Y | 1 | |
| -askp_rsqn6 | 매도호가잔량6 | String | Y | 1 | |
| -askp_rsqn7 | 매도호가잔량7 | String | Y | 1 | |
| -askp_rsqn8 | 매도호가잔량8 | String | Y | 1 | |
| -askp_rsqn9 | 매도호가잔량9 | String | Y | 1 | |
| -askp_rsqn10 | 매도호가잔량10 | String | Y | 1 | |
| -bidp_rsqn1 | 매수호가잔량1 | String | Y | 1 | |
| -bidp_rsqn2 | 매수호가잔량2 | String | Y | 1 | |
| -bidp_rsqn3 | 매수호가잔량3 | String | Y | 1 | |
| -bidp_rsqn4 | 매수호가잔량4 | String | Y | 1 | |
| -bidp_rsqn5 | 매수호가잔량5 | String | Y | 1 | |
| -bidp_rsqn6 | 매수호가잔량6 | String | Y | 1 | |
| -bidp_rsqn7 | 매수호가잔량7 | String | Y | 1 | |
| -bidp_rsqn8 | 매수호가잔량8 | String | Y | 1 | |
| -bidp_rsqn9 | 매수호가잔량9 | String | Y | 1 | |
| -bidp_rsqn10 | 매수호가잔량10 | String | Y | 1 | |
| -total_askp_csnu | 총매도호가건수 | String | Y | 1 | |
| -total_bidp_csnu | 총매수호가건수 | String | Y | 1 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 1 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 1 | |
| -total_askp_rsqn_icdc | 총매도호가잔량증감 | String | Y | 1 | |
| -total_bidp_rsqn_icdc | 총매수호가잔량증감 | String | Y | 1 |
Example
Request
{
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZFASP0",
"tr_key": "111V06"
}
}
}
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZFASP0",
"tr_key": "111V06"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0ZFASP0",
"tr_key": "111V06",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZFASP0|001|111V06^092304^79700^79800^79900^80000^80200^80300^80500^81100^8490
0^85900^79500^79400^79300^79200^79100^79000^78900^78800^78700^78600^1^18^6^2^2^1^3^1^1^1^8^6^4^8^4^
8^7^11^11^3^950^4148^988^6^9^1^3^15^5^10^4404^2277^1321^3440^330^2237^1835^362^83^15^36^97^6135^165
09^950^0
{
"header": {
"tr_id": "H0ZFASP0",
"tr_key": "111V06",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZFASP0|001|111V06^092304^79700^79800^79900^80000^80200^80300^80500^81100^8490
0^85900^79500^79400^79300^79200^79100^79000^78900^78800^78700^78600^1^18^6^2^2^1^3^1^1^1^8^6^4^8^4^
8^7^11^11^3^950^4148^988^6^9^1^3^15^5^10^4404^2277^1321^3440^330^2237^1835^362^83^15^36^97^6135^165
09^950^0
주식옵션 실시간체결가 [실시간-044]
WEBSOCKET
주식옵션 실시간체결가 [실시간-044]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0ZOCNT0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0ZOCNT0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| optn_shrn_iscd | 옵션단축종목코드 | Object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업시간 | String | Y | 6 | |
| -optn_prpr | 옵션현재가 | String | Y | 1 | |
| -prdy_vrss_sign | 전일대비부호 | String | Y | 1 | |
| -optn_prdy_vrss | 옵션전일대비 | String | Y | 1 | |
| -prdy_ctrt | 전일대비율 | String | Y | 1 | |
| -optn_oprc | 옵션시가2 | String | Y | 1 | |
| -optn_hgpr | 옵션최고가 | String | Y | 1 | |
| -optn_lwpr | 옵션최저가 | String | Y | 1 | |
| -last_cnqn | 최종거래량 | String | Y | 1 | |
| -acml_vol | 누적거래량 | String | Y | 1 | |
| -acml_tr_pbmn | 누적거래대금 | String | Y | 1 | |
| -hts_thpr | HTS이론가 | String | Y | 1 | |
| -hts_otst_stpl_qty | HTS미결제약정수량 | String | Y | 1 | |
| -otst_stpl_qty_icdc | 미결제약정수량증감 | String | Y | 1 | |
| -oprc_hour | 시가시간 | String | Y | 6 | |
| -oprc_vrss_prpr_sign | 시가2대비현재가부호 | String | Y | 1 | |
| -oprc_vrss_nmix_prpr | 시가대비지수현재가 | String | Y | 1 | |
| -hgpr_hour | 최고가시간 | String | Y | 6 | |
| -hgpr_vrss_prpr_sign | 최고가대비현재가부호 | String | Y | 1 | |
| -hgpr_vrss_nmix_prpr | 최고가대비지수현재가 | String | Y | 1 | |
| -lwpr_hour | 최저가시간 | String | Y | 6 | |
| -lwpr_vrss_prpr_sign | 최저가대비현재가부호 | String | Y | 1 | |
| -lwpr_vrss_nmix_prpr | 최저가대비지수현재가 | String | Y | 1 | |
| -shnu_rate | 매수2비율 | String | Y | 1 | |
| -prmm_val | 프리미엄값 | String | Y | 1 | |
| -invl_val | 내재가치값 | String | Y | 1 | |
| -tmvl_val | 시간가치값 | String | Y | 1 | |
| -delta | 델타 | String | Y | 1 | |
| -gama | 감마 | String | Y | 1 | |
| -vega | 베가 | String | Y | 1 | |
| -theta | 세타 | String | Y | 1 | |
| -rho | 로우 | String | Y | 1 | |
| -hts_ints_vltl | HTS내재변동성 | String | Y | 1 | |
| -esdg | 괴리도 | String | Y | 1 | |
| -otst_stpl_rgbf_qty_icdc | 미결제약정직전수량증감 | String | Y | 1 | |
| -thpr_basis | 이론베이시스 | String | Y | 1 | |
| -unas_hist_vltl | 역사적변동성 | String | Y | 1 | |
| -cttr | 체결강도 | String | Y | 1 | |
| -dprt | 괴리율 | String | Y | 1 | |
| -mrkt_basis | 시장베이시스 | String | Y | 1 | |
| -optn_askp1 | 옵션매도호가1 | String | Y | 1 | |
| -optn_bidp1 | 옵션매수호가1 | String | Y | 1 | |
| -askp_rsqn1 | 매도호가잔량1 | String | Y | 1 | |
| -bidp_rsqn1 | 매수호가잔량1 | String | Y | 1 | |
| -seln_cntg_csnu | 매도체결건수 | String | Y | 1 | |
| -shnu_cntg_csnu | 매수체결건수 | String | Y | 1 | |
| -ntby_cntg_csnu | 순매수체결건수 | String | Y | 1 | |
| -seln_cntg_smtn | 총매도수량 | String | Y | 1 | |
| -shnu_cntg_smtn | 총매수수량 | String | Y | 1 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 1 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 1 | |
| -prdy_vol_vrss_acml_vol_rate | 전일거래량대비등락율 | String | Y | 1 |
Example
Request
{
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZOCNT0",
"tr_key": "211V05059"
}
}
}
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZOCNT0",
"tr_key": "211V05059"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0ZOCNT0",
"tr_key": "211V05059",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZOCNT0|001|211V05059^091940^1060.00^5^-120.00^-10.17^970.00^1140.00^970
.00^6^563^5933200^35464.07^1134^-2^000000^2^90.00^000000^5^-80.00^000000^2^90.00^0.43^0.00^0.
00^1060.00^1.00^0.00^0.00^-4.06^20.58^0.31^-34404.07^0^-41735.93^0.26^74.84^-97.01^-76140.00^
1100.00^1040.00^6^175^13^16^3^322^241^241^184^12.33
{
"header": {
"tr_id": "H0ZOCNT0",
"tr_key": "211V05059",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZOCNT0|001|211V05059^091940^1060.00^5^-120.00^-10.17^970.00^1140.00^970
.00^6^563^5933200^35464.07^1134^-2^000000^2^90.00^000000^5^-80.00^000000^2^90.00^0.43^0.00^0.
00^1060.00^1.00^0.00^0.00^-4.06^20.58^0.31^-34404.07^0^-41735.93^0.26^74.84^-97.01^-76140.00^
1100.00^1040.00^6^175^13^16^3^322^241^241^184^12.33
주식옵션 실시간호가 [실시간-045]
WEBSOCKET
주식옵션 실시간호가 [실시간-045]
기본정보
- MethodPOST
- 실전 Domainws://ops.koreainvestment.com:21000
- 모의 Domain모의투자 미지원
- URL/tryitout/H0ZOASP0
- Format
- Content-Type
개요
LAYOUT
Request
Header
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| approval_key | 웹소켓 접속키 | String | Y | 36 | 실시간 (웹소켓) 접속키 발급 API(/oauth2/Approval)를 사용하여 발급받은 웹소켓 접속키 |
| custtype | 고객 타입 | String | Y | 1 | B : 법인 / P : 개인 |
| tr_type | 등록/해제 | String | Y | 1 | "1: 등록, 2:해제" |
| content-type | 컨텐츠타입 | String | Y | 20 | utf-8 |
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| tr_id | 거래ID | String | Y | 7 | H0ZOASP0 |
| tr_key | 종목코드 | String | Y | 6 | 종목코드 |
Response
Body
| Element | 한글명 | Type | Required | Length | Description |
|---|---|---|---|---|---|
| optn_shrn_iscd | 옵션단축종목코드 | Object | Y | 9 | '각 항목사이에는 구분자로 ^ 사용,
모든 데이터타입은 String으로 변환되어 push 처리됨' |
| -bsop_hour | 영업시간 | String | Y | 6 | |
| -optn_askp1 | 옵션매도호가1 | String | Y | 8 | |
| -optn_askp2 | 옵션매도호가2 | String | Y | 8 | |
| -optn_askp3 | 옵션매도호가3 | String | Y | 8 | |
| -optn_askp4 | 옵션매도호가4 | String | Y | 8 | |
| -optn_askp5 | 옵션매도호가5 | String | Y | 8 | |
| -optn_bidp1 | 옵션매수호가1 | String | Y | 8 | |
| -optn_bidp2 | 옵션매수호가2 | String | Y | 8 | |
| -optn_bidp3 | 옵션매수호가3 | String | Y | 8 | |
| -optn_bidp4 | 옵션매수호가4 | String | Y | 8 | |
| -optn_bidp5 | 옵션매수호가5 | String | Y | 8 | |
| -askp_csnu1 | 매도호가건수1 | String | Y | 4 | |
| -askp_csnu2 | 매도호가건수2 | String | Y | 4 | |
| -askp_csnu3 | 매도호가건수3 | String | Y | 4 | |
| -askp_csnu4 | 매도호가건수4 | String | Y | 4 | |
| -askp_csnu5 | 매도호가건수5 | String | Y | 4 | |
| -bidp_csnu1 | 매수호가건수1 | String | Y | 4 | |
| -bidp_csnu2 | 매수호가건수2 | String | Y | 4 | |
| -bidp_csnu3 | 매수호가건수3 | String | Y | 4 | |
| -bidp_csnu4 | 매수호가건수4 | String | Y | 4 | |
| -bidp_csnu5 | 매수호가건수5 | String | Y | 4 | |
| -askp_rsqn1 | 매도호가잔량1 | String | Y | 8 | |
| -askp_rsqn2 | 매도호가잔량2 | String | Y | 8 | |
| -askp_rsqn3 | 매도호가잔량3 | String | Y | 8 | |
| -askp_rsqn4 | 매도호가잔량4 | String | Y | 8 | |
| -askp_rsqn5 | 매도호가잔량5 | String | Y | 8 | |
| -bidp_rsqn1 | 매수호가잔량1 | String | Y | 8 | |
| -bidp_rsqn2 | 매수호가잔량2 | String | Y | 8 | |
| -bidp_rsqn3 | 매수호가잔량3 | String | Y | 8 | |
| -bidp_rsqn4 | 매수호가잔량4 | String | Y | 8 | |
| -bidp_rsqn5 | 매수호가잔량5 | String | Y | 8 | |
| -total_askp_csnu | 총매도호가건수 | String | Y | 4 | |
| -total_bidp_csnu | 총매수호가건수 | String | Y | 4 | |
| -total_askp_rsqn | 총매도호가잔량 | String | Y | 8 | |
| -total_bidp_rsqn | 총매수호가잔량 | String | Y | 8 | |
| -total_askp_rsqn_icdc | 총매도호가잔량증감 | String | Y | 4 | |
| -total_bidp_rsqn_icdc | 총매수호가잔량증감 | String | Y | 4 | |
| -optn_askp6 | 옵션매도호가6 | String | Y | 8 | |
| -optn_askp7 | 옵션매도호가7 | String | Y | 8 | |
| -optn_askp8 | 옵션매도호가8 | String | Y | 8 | |
| -optn_askp9 | 옵션매도호가9 | String | Y | 8 | |
| -optn_askp10 | 옵션매도호가10 | String | Y | 8 | |
| -optn_bidp6 | 옵션매수호가6 | String | Y | 8 | |
| -optn_bidp7 | 옵션매수호가7 | String | Y | 8 | |
| -optn_bidp8 | 옵션매수호가8 | String | Y | 8 | |
| -optn_bidp9 | 옵션매수호가9 | String | Y | 8 | |
| -optn_bidp10 | 옵션매수호가10 | String | Y | 8 | |
| -askp_csnu6 | 매도호가건수6 | String | Y | 4 | |
| -askp_csnu7 | 매도호가건수7 | String | Y | 4 | |
| -askp_csnu8 | 매도호가건수8 | String | Y | 4 | |
| -askp_csnu9 | 매도호가건수9 | String | Y | 4 | |
| -askp_csnu10 | 매도호가건수10 | String | Y | 4 | |
| -bidp_csnu6 | 매수호가건수6 | String | Y | 4 | |
| -bidp_csnu7 | 매수호가건수7 | String | Y | 4 | |
| -bidp_csnu8 | 매수호가건수8 | String | Y | 4 | |
| -bidp_csnu9 | 매수호가건수9 | String | Y | 4 | |
| -bidp_csnu10 | 매수호가건수10 | String | Y | 4 | |
| -askp_rsqn6 | 매도호가잔량6 | String | Y | 8 | |
| -askp_rsqn7 | 매도호가잔량7 | String | Y | 8 | |
| -askp_rsqn8 | 매도호가잔량8 | String | Y | 8 | |
| -askp_rsqn9 | 매도호가잔량9 | String | Y | 8 | |
| -askp_rsqn10 | 매도호가잔량10 | String | Y | 8 | |
| -bidp_rsqn6 | 매수호가잔량6 | String | Y | 8 | |
| -bidp_rsqn7 | 매수호가잔량7 | String | Y | 8 | |
| -bidp_rsqn8 | 매수호가잔량8 | String | Y | 8 | |
| -bidp_rsqn9 | 매수호가잔량9 | String | Y | 8 | |
| -bidp_rsqn10 | 매수호가잔량10 | String | Y | 8 |
Example
Request
{
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZOASP0",
"tr_key": "211V05059"
}
}
}
"header": {
"approval_key": "35xxxxxa-bxxa-4xxb-87xxx-f56xxxxxxxxxx",
"custtype": "P",
"tr_type": "1",
"content-type": "utf-8"
},
"body": {
"input": {
"tr_id": "H0ZOASP0",
"tr_key": "211V05059"
}
}
}
Response
# 연결 확인
{
"header": {
"tr_id": "H0ZOASP0",
"tr_key": "211V05059",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZOASP0|001|211V05059^091509^1140.00^1160.00^1200.00^1300.00^1400.00^1120
.00^1080.00^620.00^580.00^530.00^2^1^1^1^1^1^2^1^1^1^187^12^10^10^10^12^187^3^3^3^9^6^241^208^
0^0^1500.00^1520.00^1700.00^0.00^0.00^0.00^0.00^0.00^0.00^0.00^1^1^1^0^0^0^0^0^0^0^10^1^1^0^0^
0^0^0^0^0
{
"header": {
"tr_id": "H0ZOASP0",
"tr_key": "211V05059",
"encrypt": "N"
},
"body": {
"rt_cd": "0",
"msg_cd": "OPSP0000",
"msg1": "SUBSCRIBE SUCCESS",
"output": {
"iv": "0123456789abcdef",
"key": "abcdefghijklmnopabcdefghijklmnop"}
}
}
# output
0|H0ZOASP0|001|211V05059^091509^1140.00^1160.00^1200.00^1300.00^1400.00^1120
.00^1080.00^620.00^580.00^530.00^2^1^1^1^1^1^2^1^1^1^187^12^10^10^10^12^187^3^3^3^9^6^241^208^
0^0^1500.00^1520.00^1700.00^0.00^0.00^0.00^0.00^0.00^0.00^0.00^1^1^1^0^0^0^0^0^0^0^10^1^1^0^0^
0^0^0^0^0