KIS Developers menu

API 문서 HOME API 문서 [국내주식] 순위분석


[국내주식] 순위분석

거래량순위[v1_국내주식-047]

REST

거래량순위[v1_국내주식-047]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/quotations/volume-rank
  • Format
    JSON
  • Content-Type
    application/json; charset=utf-8

개요

국내주식 거래량순위 API입니다.

한국투자 HTS(eFriend Plus) > [0171] 거래량 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

최대 30건 확인 가능하며, 다음 조회가 불가합니다.
+
30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
HTS [0110]에서 여러가지 조건을 설정할 수 있는데, 그 중 거래량 순위(ex. 0봉전 거래량 상위순 100종목) 에 대해서도 설정해서 종목을 검색할 수 있습니다.
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01710000
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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 J
FID_COND_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 20171
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000(전체) 기타(업종코드)
FID_DIV_CLS_CODE 분류 구분 코드 String Y 2 0(전체) 1(보통주) 2(우선주)
FID_BLNG_CLS_CODE 소속 구분 코드 String Y 2 0 : 평균거래량 1:거래증가율 2:평균거래회전율 3:거래금액순 4:평균거래금액회전율
FID_TRGT_CLS_CODE 대상 구분 코드 String Y 32 1 or 0 9자리 (차례대로 증거금 30% 40% 50% 60% 100% 신용보증금 30% 40% 50% 60%)
ex) "111111111"
FID_TRGT_EXLS_CLS_CODE 대상 제외 구분 코드 String Y 32 1 or 0 10자리 (차례대로 투자위험/경고/주의 관리종목 정리매매 불성실공시 우선주 거래정지 ETF ETN 신용주문불가 SPAC)
ex) "0000000000"
FID_INPUT_PRICE_1 입력 가격1 String Y 12 가격 ~
ex) "0"

전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 ""(공란) 입력
FID_INPUT_PRICE_2 입력 가격2 String Y 12 ~ 가격
ex) "1000000"

전체 가격 대상 조회 시 FID_INPUT_PRICE_1, FID_INPUT_PRICE_2 모두 ""(공란) 입력
FID_VOL_CNT 거래량 수 String Y 12 거래량 ~
ex) "100000"

전체 거래량 대상 조회 시 FID_VOL_CNT ""(공란) 입력
FID_INPUT_DATE_1 입력 날짜1 String Y 10 ""(공란) 입력

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-hts_kor_isnm HTS 한글 종목명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-prdy_vol 전일 거래량 String Y 18
-lstn_stcn 상장 주수 String Y 18
-avrg_vol 평균 거래량 String Y 18
-n_befr_clpr_vrss_prpr_rate N일전종가대비현재가대비율 String Y 82
-vol_inrt 거래량증가율 String Y 84
-vol_tnrt 거래량 회전율 String Y 82
-nday_vol_tnrt N일 거래량 회전율 String Y 8
-avrg_tr_pbmn 평균 거래 대금 String Y 18
-tr_pbmn_tnrt 거래대금회전율 String Y 82
-nday_tr_pbmn_tnrt N일 거래대금 회전율 String Y 8
-acml_tr_pbmn 누적 거래 대금 String Y 18

Example

Request

{
"FID_COND_MRKT_DIV_CODE":"J",
"FID_COND_SCR_DIV_CODE":"20171",
"FID_INPUT_ISCD":"0000",
"FID_DIV_CLS_CODE":"0",
"FID_BLNG_CLS_CODE":"0",
"FID_TRGT_CLS_CODE":"111111111",
"FID_TRGT_EXLS_CLS_CODE":"000000",
"FID_INPUT_PRICE_1":"0",
"FID_INPUT_PRICE_2":"0",
"FID_VOL_CNT":"0",
"FID_INPUT_DATE_1":"0"
}

Response

{
    "output": [
        {
            "hts_kor_isnm": "삼성전자",
            "mksc_shrn_iscd": "005930",
            "data_rank": "1",
            "stck_prpr": "65100",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-300",
            "prdy_ctrt": "-0.46",
            "acml_vol": "8958147",
            "prdy_vol": "12334657",
            "lstn_stcn": "5969782550",
            "avrg_vol": "8958147",
            "n_befr_clpr_vrss_prpr_rate": "-0.46",
            "vol_inrt": "72.63",
            "vol_tnrt": "0.15",
            "nday_vol_tnrt": "0.15",
            "avrg_tr_pbmn": "584861890300",
            "tr_pbmn_tnrt": "0.15",
            "nday_tr_pbmn_tnrt": "0.15",
            "acml_tr_pbmn": "584861890300"
        },
        {
            "hts_kor_isnm": "두산에너빌리티",
            "mksc_shrn_iscd": "034020",
            "data_rank": "2",
            "stck_prpr": "15730",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-90",
            "prdy_ctrt": "-0.57",
            "acml_vol": "3285533",
            "prdy_vol": "6090991",
            "lstn_stcn": "640561146",
            "avrg_vol": "3285533",
            "n_befr_clpr_vrss_prpr_rate": "-0.57",
            "vol_inrt": "53.94",
            "vol_tnrt": "0.51",
            "nday_vol_tnrt": "0.51",
            "avrg_tr_pbmn": "52081429080",
            "tr_pbmn_tnrt": "0.52",
            "nday_tr_pbmn_tnrt": "0.52",
            "acml_tr_pbmn": "52081429080"
        },
        {
            "hts_kor_isnm": "LG디스플레이",
            "mksc_shrn_iscd": "034220",
            "data_rank": "3",
            "stck_prpr": "15670",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "470",
            "prdy_ctrt": "3.09",
            "acml_vol": "3171164",
            "prdy_vol": "1476096",
            "lstn_stcn": "357815700",
            "avrg_vol": "3171164",
            "n_befr_clpr_vrss_prpr_rate": "3.09",
            "vol_inrt": "214.83",
            "vol_tnrt": "0.89",
            "nday_vol_tnrt": "0.89",
            "avrg_tr_pbmn": "50045759170",
            "tr_pbmn_tnrt": "0.89",
            "nday_tr_pbmn_tnrt": "0.89",
            "acml_tr_pbmn": "50045759170"
        },
        {
            "hts_kor_isnm": "SK하이닉스",
            "mksc_shrn_iscd": "000660",
            "data_rank": "4",
            "stck_prpr": "91700",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1300",
            "prdy_ctrt": "1.44",
            "acml_vol": "2833739",
            "prdy_vol": "5121364",
            "lstn_stcn": "728002365",
            "avrg_vol": "2833739",
            "n_befr_clpr_vrss_prpr_rate": "1.44",
            "vol_inrt": "55.33",
            "vol_tnrt": "0.39",
            "nday_vol_tnrt": "0.39",
            "avrg_tr_pbmn": "258969317100",
            "tr_pbmn_tnrt": "0.39",
            "nday_tr_pbmn_tnrt": "0.39",
            "acml_tr_pbmn": "258969317100"
        },
        {
            "hts_kor_isnm": "현대로템",
            "mksc_shrn_iscd": "064350",
            "data_rank": "5",
            "stck_prpr": "31450",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-1500",
            "prdy_ctrt": "-4.55",
            "acml_vol": "2709946",
            "prdy_vol": "1161286",
            "lstn_stcn": "109142293",
            "avrg_vol": "2709946",
            "n_befr_clpr_vrss_prpr_rate": "-4.55",
            "vol_inrt": "233.36",
            "vol_tnrt": "2.48",
            "nday_vol_tnrt": "2.48",
            "avrg_tr_pbmn": "85496575550",
            "tr_pbmn_tnrt": "2.49",
            "nday_tr_pbmn_tnrt": "2.49",
            "acml_tr_pbmn": "85496575550"
        },
        {
            "hts_kor_isnm": "HMM",
            "mksc_shrn_iscd": "011200",
            "data_rank": "6",
            "stck_prpr": "18250",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-550",
            "prdy_ctrt": "-2.93",
            "acml_vol": "2286426",
            "prdy_vol": "1530846",
            "lstn_stcn": "489039496",
            "avrg_vol": "2286426",
            "n_befr_clpr_vrss_prpr_rate": "-2.93",
            "vol_inrt": "149.36",
            "vol_tnrt": "0.47",
            "nday_vol_tnrt": "0.47",
            "avrg_tr_pbmn": "42083654470",
            "tr_pbmn_tnrt": "0.47",
            "nday_tr_pbmn_tnrt": "0.47",
            "acml_tr_pbmn": "42083654470"
        },
        {
            "hts_kor_isnm": "카카오",
            "mksc_shrn_iscd": "035720",
            "data_rank": "7",
            "stck_prpr": "57700",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1600",
            "prdy_ctrt": "2.85",
            "acml_vol": "1873007",
            "prdy_vol": "922948",
            "lstn_stcn": "445841128",
            "avrg_vol": "1873007",
            "n_befr_clpr_vrss_prpr_rate": "2.85",
            "vol_inrt": "202.94",
            "vol_tnrt": "0.42",
            "nday_vol_tnrt": "0.42",
            "avrg_tr_pbmn": "107707977500",
            "tr_pbmn_tnrt": "0.42",
            "nday_tr_pbmn_tnrt": "0.42",
            "acml_tr_pbmn": "107707977500"
        },
        {
            "hts_kor_isnm": "삼성중공업",
            "mksc_shrn_iscd": "010140",
            "data_rank": "8",
            "stck_prpr": "5510",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "30",
            "prdy_ctrt": "0.55",
            "acml_vol": "1711650",
            "prdy_vol": "1979941",
            "lstn_stcn": "880000000",
            "avrg_vol": "1711650",
            "n_befr_clpr_vrss_prpr_rate": "0.55",
            "vol_inrt": "86.45",
            "vol_tnrt": "0.19",
            "nday_vol_tnrt": "0.19",
            "avrg_tr_pbmn": "9363354660",
            "tr_pbmn_tnrt": "0.19",
            "nday_tr_pbmn_tnrt": "0.19",
            "acml_tr_pbmn": "9363354660"
        },
        {
            "hts_kor_isnm": "한화솔루션",
            "mksc_shrn_iscd": "009830",
            "data_rank": "9",
            "stck_prpr": "48000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1150",
            "prdy_ctrt": "2.45",
            "acml_vol": "1582296",
            "prdy_vol": "910120",
            "lstn_stcn": "171892536",
            "avrg_vol": "1582296",
            "n_befr_clpr_vrss_prpr_rate": "2.45",
            "vol_inrt": "173.86",
            "vol_tnrt": "0.92",
            "nday_vol_tnrt": "0.92",
            "avrg_tr_pbmn": "75841144250",
            "tr_pbmn_tnrt": "0.92",
            "nday_tr_pbmn_tnrt": "0.92",
            "acml_tr_pbmn": "75841144250"
        },
        {
            "hts_kor_isnm": "포스코인터내셔널",
            "mksc_shrn_iscd": "047050",
            "data_rank": "10",
            "stck_prpr": "28550",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "200",
            "prdy_ctrt": "0.71",
            "acml_vol": "1390133",
            "prdy_vol": "2369179",
            "lstn_stcn": "175922788",
            "avrg_vol": "1390133",
            "n_befr_clpr_vrss_prpr_rate": "0.71",
            "vol_inrt": "58.68",
            "vol_tnrt": "0.79",
            "nday_vol_tnrt": "0.79",
            "avrg_tr_pbmn": "39675793900",
            "tr_pbmn_tnrt": "0.79",
            "nday_tr_pbmn_tnrt": "0.79",
            "acml_tr_pbmn": "39675793900"
        },
        {
            "hts_kor_isnm": "한국전력",
            "mksc_shrn_iscd": "015760",
            "data_rank": "11",
            "stck_prpr": "18450",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-230",
            "prdy_ctrt": "-1.23",
            "acml_vol": "1312142",
            "prdy_vol": "1844472",
            "lstn_stcn": "641964077",
            "avrg_vol": "1312142",
            "n_befr_clpr_vrss_prpr_rate": "-1.23",
            "vol_inrt": "71.14",
            "vol_tnrt": "0.20",
            "nday_vol_tnrt": "0.20",
            "avrg_tr_pbmn": "24308085110",
            "tr_pbmn_tnrt": "0.21",
            "nday_tr_pbmn_tnrt": "0.21",
            "acml_tr_pbmn": "24308085110"
        },
        {
            "hts_kor_isnm": "우리금융지주",
            "mksc_shrn_iscd": "316140",
            "data_rank": "12",
            "stck_prpr": "11720",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-80",
            "prdy_ctrt": "-0.68",
            "acml_vol": "1270105",
            "prdy_vol": "1455657",
            "lstn_stcn": "728060549",
            "avrg_vol": "1270105",
            "n_befr_clpr_vrss_prpr_rate": "-0.68",
            "vol_inrt": "87.25",
            "vol_tnrt": "0.17",
            "nday_vol_tnrt": "0.17",
            "avrg_tr_pbmn": "14886199950",
            "tr_pbmn_tnrt": "0.17",
            "nday_tr_pbmn_tnrt": "0.17",
            "acml_tr_pbmn": "14886199950"
        },
        {
            "hts_kor_isnm": "팬오션",
            "mksc_shrn_iscd": "028670",
            "data_rank": "13",
            "stck_prpr": "5100",
            "prdy_vrss_sign": "3",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "1156091",
            "prdy_vol": "1296967",
            "lstn_stcn": "534569512",
            "avrg_vol": "1156091",
            "n_befr_clpr_vrss_prpr_rate": "0.00",
            "vol_inrt": "89.14",
            "vol_tnrt": "0.22",
            "nday_vol_tnrt": "0.22",
            "avrg_tr_pbmn": "5900434210",
            "tr_pbmn_tnrt": "0.22",
            "nday_tr_pbmn_tnrt": "0.22",
            "acml_tr_pbmn": "5900434210"
        },
        {
            "hts_kor_isnm": "기아",
            "mksc_shrn_iscd": "000270",
            "data_rank": "14",
            "stck_prpr": "88000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "700",
            "prdy_ctrt": "0.80",
            "acml_vol": "935222",
            "prdy_vol": "1866373",
            "lstn_stcn": "405363347",
            "avrg_vol": "935222",
            "n_befr_clpr_vrss_prpr_rate": "0.80",
            "vol_inrt": "50.11",
            "vol_tnrt": "0.23",
            "nday_vol_tnrt": "0.23",
            "avrg_tr_pbmn": "82381989600",
            "tr_pbmn_tnrt": "0.23",
            "nday_tr_pbmn_tnrt": "0.23",
            "acml_tr_pbmn": "82381989600"
        },
        {
            "hts_kor_isnm": "신한지주",
            "mksc_shrn_iscd": "055550",
            "data_rank": "15",
            "stck_prpr": "34600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "50",
            "prdy_ctrt": "0.14",
            "acml_vol": "930868",
            "prdy_vol": "1351786",
            "lstn_stcn": "505108399",
            "avrg_vol": "930868",
            "n_befr_clpr_vrss_prpr_rate": "0.14",
            "vol_inrt": "68.86",
            "vol_tnrt": "0.18",
            "nday_vol_tnrt": "0.18",
            "avrg_tr_pbmn": "32273778800",
            "tr_pbmn_tnrt": "0.18",
            "nday_tr_pbmn_tnrt": "0.18",
            "acml_tr_pbmn": "32273778800"
        },
        {
            "hts_kor_isnm": "메리츠금융지주",
            "mksc_shrn_iscd": "138040",
            "data_rank": "16",
            "stck_prpr": "45300",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-400",
            "prdy_ctrt": "-0.88",
            "acml_vol": "627094",
            "prdy_vol": "817468",
            "lstn_stcn": "208217858",
            "avrg_vol": "627094",
            "n_befr_clpr_vrss_prpr_rate": "-0.88",
            "vol_inrt": "76.71",
            "vol_tnrt": "0.30",
            "nday_vol_tnrt": "0.30",
            "avrg_tr_pbmn": "28375338250",
            "tr_pbmn_tnrt": "0.30",
            "nday_tr_pbmn_tnrt": "0.30",
            "acml_tr_pbmn": "28375338250"
        },
        {
            "hts_kor_isnm": "카카오뱅크",
            "mksc_shrn_iscd": "323410",
            "data_rank": "17",
            "stck_prpr": "24850",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-300",
            "prdy_ctrt": "-1.19",
            "acml_vol": "625836",
            "prdy_vol": "1527116",
            "lstn_stcn": "476767137",
            "avrg_vol": "625836",
            "n_befr_clpr_vrss_prpr_rate": "-1.19",
            "vol_inrt": "40.98",
            "vol_tnrt": "0.13",
            "nday_vol_tnrt": "0.13",
            "avrg_tr_pbmn": "15712615750",
            "tr_pbmn_tnrt": "0.13",
            "nday_tr_pbmn_tnrt": "0.13",
            "acml_tr_pbmn": "15712615750"
        },
        {
            "hts_kor_isnm": "KT",
            "mksc_shrn_iscd": "030200",
            "data_rank": "18",
            "stck_prpr": "31300",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "100",
            "prdy_ctrt": "0.32",
            "acml_vol": "569371",
            "prdy_vol": "1294632",
            "lstn_stcn": "261111808",
            "avrg_vol": "569371",
            "n_befr_clpr_vrss_prpr_rate": "0.32",
            "vol_inrt": "43.98",
            "vol_tnrt": "0.22",
            "nday_vol_tnrt": "0.22",
            "avrg_tr_pbmn": "17771655950",
            "tr_pbmn_tnrt": "0.22",
            "nday_tr_pbmn_tnrt": "0.22",
            "acml_tr_pbmn": "17771655950"
        },
        {
            "hts_kor_isnm": "에스디바이오센서",
            "mksc_shrn_iscd": "137310",
            "data_rank": "19",
            "stck_prpr": "17860",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-540",
            "prdy_ctrt": "-2.93",
            "acml_vol": "520565",
            "prdy_vol": "487837",
            "lstn_stcn": "104452353",
            "avrg_vol": "520565",
            "n_befr_clpr_vrss_prpr_rate": "-2.93",
            "vol_inrt": "106.71",
            "vol_tnrt": "0.50",
            "nday_vol_tnrt": "0.50",
            "avrg_tr_pbmn": "9342427100",
            "tr_pbmn_tnrt": "0.50",
            "nday_tr_pbmn_tnrt": "0.50",
            "acml_tr_pbmn": "9342427100"
        },
        {
            "hts_kor_isnm": "NAVER",
            "mksc_shrn_iscd": "035420",
            "data_rank": "20",
            "stck_prpr": "213000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "5500",
            "prdy_ctrt": "2.65",
            "acml_vol": "484026",
            "prdy_vol": "528940",
            "lstn_stcn": "164049085",
            "avrg_vol": "484026",
            "n_befr_clpr_vrss_prpr_rate": "2.65",
            "vol_inrt": "91.51",
            "vol_tnrt": "0.30",
            "nday_vol_tnrt": "0.30",
            "avrg_tr_pbmn": "102530676000",
            "tr_pbmn_tnrt": "0.29",
            "nday_tr_pbmn_tnrt": "0.29",
            "acml_tr_pbmn": "102530676000"
        },
        {
            "hts_kor_isnm": "기업은행",
            "mksc_shrn_iscd": "024110",
            "data_rank": "21",
            "stck_prpr": "10070",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-30",
            "prdy_ctrt": "-0.30",
            "acml_vol": "469367",
            "prdy_vol": "707261",
            "lstn_stcn": "797425869",
            "avrg_vol": "469367",
            "n_befr_clpr_vrss_prpr_rate": "-0.30",
            "vol_inrt": "66.36",
            "vol_tnrt": "0.06",
            "nday_vol_tnrt": "0.06",
            "avrg_tr_pbmn": "4736559470",
            "tr_pbmn_tnrt": "0.06",
            "nday_tr_pbmn_tnrt": "0.06",
            "acml_tr_pbmn": "4736559470"
        },
        {
            "hts_kor_isnm": "포스코퓨처엠",
            "mksc_shrn_iscd": "003670",
            "data_rank": "22",
            "stck_prpr": "312500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "2500",
            "prdy_ctrt": "0.81",
            "acml_vol": "468389",
            "prdy_vol": "856091",
            "lstn_stcn": "77463220",
            "avrg_vol": "468389",
            "n_befr_clpr_vrss_prpr_rate": "0.81",
            "vol_inrt": "54.71",
            "vol_tnrt": "0.60",
            "nday_vol_tnrt": "0.60",
            "avrg_tr_pbmn": "145466512000",
            "tr_pbmn_tnrt": "0.60",
            "nday_tr_pbmn_tnrt": "0.60",
            "acml_tr_pbmn": "145466512000"
        },
        {
            "hts_kor_isnm": "KB금융",
            "mksc_shrn_iscd": "105560",
            "data_rank": "23",
            "stck_prpr": "49000",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-300",
            "prdy_ctrt": "-0.61",
            "acml_vol": "459214",
            "prdy_vol": "1293549",
            "lstn_stcn": "403511072",
            "avrg_vol": "459214",
            "n_befr_clpr_vrss_prpr_rate": "-0.61",
            "vol_inrt": "35.50",
            "vol_tnrt": "0.11",
            "nday_vol_tnrt": "0.11",
            "avrg_tr_pbmn": "22593198000",
            "tr_pbmn_tnrt": "0.11",
            "nday_tr_pbmn_tnrt": "0.11",
            "acml_tr_pbmn": "22593198000"
        },
        {
            "hts_kor_isnm": "한화에어로스페이스",
            "mksc_shrn_iscd": "012450",
            "data_rank": "24",
            "stck_prpr": "103900",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "400",
            "prdy_ctrt": "0.39",
            "acml_vol": "458706",
            "prdy_vol": "345873",
            "lstn_stcn": "50630000",
            "avrg_vol": "458706",
            "n_befr_clpr_vrss_prpr_rate": "0.39",
            "vol_inrt": "132.62",
            "vol_tnrt": "0.91",
            "nday_vol_tnrt": "0.91",
            "avrg_tr_pbmn": "47298434100",
            "tr_pbmn_tnrt": "0.90",
            "nday_tr_pbmn_tnrt": "0.90",
            "acml_tr_pbmn": "47298434100"
        },
        {
            "hts_kor_isnm": "LG유플러스",
            "mksc_shrn_iscd": "032640",
            "data_rank": "25",
            "stck_prpr": "11090",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "60",
            "prdy_ctrt": "0.54",
            "acml_vol": "451459",
            "prdy_vol": "971303",
            "lstn_stcn": "436611361",
            "avrg_vol": "451459",
            "n_befr_clpr_vrss_prpr_rate": "0.54",
            "vol_inrt": "46.48",
            "vol_tnrt": "0.10",
            "nday_vol_tnrt": "0.10",
            "avrg_tr_pbmn": "5009396470",
            "tr_pbmn_tnrt": "0.10",
            "nday_tr_pbmn_tnrt": "0.10",
            "acml_tr_pbmn": "5009396470"
        },
        {
            "hts_kor_isnm": "삼성엔지니어링",
            "mksc_shrn_iscd": "028050",
            "data_rank": "26",
            "stck_prpr": "28950",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-250",
            "prdy_ctrt": "-0.86",
            "acml_vol": "446635",
            "prdy_vol": "512916",
            "lstn_stcn": "196000000",
            "avrg_vol": "446635",
            "n_befr_clpr_vrss_prpr_rate": "-0.86",
            "vol_inrt": "87.08",
            "vol_tnrt": "0.23",
            "nday_vol_tnrt": "0.23",
            "avrg_tr_pbmn": "12942967050",
            "tr_pbmn_tnrt": "0.23",
            "nday_tr_pbmn_tnrt": "0.23",
            "acml_tr_pbmn": "12942967050"
        },
        {
            "hts_kor_isnm": "현대차",
            "mksc_shrn_iscd": "005380",
            "data_rank": "27",
            "stck_prpr": "204500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "2000",
            "prdy_ctrt": "0.99",
            "acml_vol": "432033",
            "prdy_vol": "874247",
            "lstn_stcn": "211531506",
            "avrg_vol": "432033",
            "n_befr_clpr_vrss_prpr_rate": "0.99",
            "vol_inrt": "49.42",
            "vol_tnrt": "0.20",
            "nday_vol_tnrt": "0.20",
            "avrg_tr_pbmn": "88091018500",
            "tr_pbmn_tnrt": "0.20",
            "nday_tr_pbmn_tnrt": "0.20",
            "acml_tr_pbmn": "88091018500"
        },
        {
            "hts_kor_isnm": "한국항공우주",
            "mksc_shrn_iscd": "047810",
            "data_rank": "28",
            "stck_prpr": "51700",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.58",
            "acml_vol": "418249",
            "prdy_vol": "431203",
            "lstn_stcn": "97475107",
            "avrg_vol": "418249",
            "n_befr_clpr_vrss_prpr_rate": "0.58",
            "vol_inrt": "97.00",
            "vol_tnrt": "0.43",
            "nday_vol_tnrt": "0.43",
            "avrg_tr_pbmn": "21574340000",
            "tr_pbmn_tnrt": "0.43",
            "nday_tr_pbmn_tnrt": "0.43",
            "acml_tr_pbmn": "21574340000"
        },
        {
            "hts_kor_isnm": "대한항공",
            "mksc_shrn_iscd": "003490",
            "data_rank": "29",
            "stck_prpr": "22500",
            "prdy_vrss_sign": "3",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "400822",
            "prdy_vol": "578620",
            "lstn_stcn": "368220661",
            "avrg_vol": "400822",
            "n_befr_clpr_vrss_prpr_rate": "0.00",
            "vol_inrt": "69.27",
            "vol_tnrt": "0.11",
            "nday_vol_tnrt": "0.11",
            "avrg_tr_pbmn": "9020223200",
            "tr_pbmn_tnrt": "0.11",
            "nday_tr_pbmn_tnrt": "0.11",
            "acml_tr_pbmn": "9020223200"
        },
        {
            "hts_kor_isnm": "한국가스공사",
            "mksc_shrn_iscd": "036460",
            "data_rank": "30",
            "stck_prpr": "25350",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-500",
            "prdy_ctrt": "-1.93",
            "acml_vol": "369094",
            "prdy_vol": "340512",
            "lstn_stcn": "92313000",
            "avrg_vol": "369094",
            "n_befr_clpr_vrss_prpr_rate": "-1.93",
            "vol_inrt": "108.39",
            "vol_tnrt": "0.40",
            "nday_vol_tnrt": "0.40",
            "avrg_tr_pbmn": "9408072150",
            "tr_pbmn_tnrt": "0.40",
            "nday_tr_pbmn_tnrt": "0.40",
            "acml_tr_pbmn": "9408072150"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 등락률 순위[v1_국내주식-088]

REST

국내주식 등락률 순위[v1_국내주식-088]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/fluctuation
  • Format
     
  • Content-Type
     

개요

국내주식 등락률 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0170] 등락률 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01700000
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_rsfl_rate2 등락 비율2 String Y 132 입력값 없을때 전체 (~ 비율
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20170 )
fid_input_iscd 입력 종목코드 String Y 12 0000(전체) 코스피(0001), 코스닥(1001), 코스피200(2001)
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0:상승율순 1:하락율순 2:시가대비상승율 3:시가대비하락율 4:변동율
fid_input_cnt_1 입력 수1 String Y 12 0:전체 , 누적일수 입력
fid_prc_cls_code 가격 구분 코드 String Y 2 'fid_rank_sort_cls_code :0 상승율 순일때 (0:저가대비, 1:종가대비)
fid_rank_sort_cls_code :1 하락율 순일때 (0:고가대비, 1:종가대비)
fid_rank_sort_cls_code : 기타 (0:전체)'
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_trgt_cls_code 대상 구분 코드 String Y 32 0:전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0:전체
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체
fid_rsfl_rate1 등락 비율1 String Y 132 입력값 없을때 전체 (비율 ~)

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_shrn_iscd 주식 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-stck_hgpr 주식 최고가 String Y 10
-hgpr_hour 최고가 시간 String Y 6
-acml_hgpr_date 누적 최고가 일자 String Y 8
-stck_lwpr 주식 최저가 String Y 10
-lwpr_hour 최저가 시간 String Y 6
-acml_lwpr_date 누적 최저가 일자 String Y 8
-lwpr_vrss_prpr_rate 최저가 대비 현재가 비율 String Y 84
-dsgt_date_clpr_vrss_prpr_rate 지정 일자 종가 대비 현재가 비 String Y 84
-cnnt_ascn_dynu 연속 상승 일수 String Y 5
-hgpr_vrss_prpr_rate 최고가 대비 현재가 비율 String Y 84
-cnnt_down_dynu 연속 하락 일수 String Y 5
-oprc_vrss_prpr_sign 시가2 대비 현재가 부호 String Y 1
-oprc_vrss_prpr 시가2 대비 현재가 String Y 10
-oprc_vrss_prpr_rate 시가2 대비 현재가 비율 String Y 84
-prd_rsfl 기간 등락 String Y 10
-prd_rsfl_rate 기간 등락 비율 String Y 84

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20170",
"fid_input_iscd":"0000",
"fid_rank_sort_cls_code":"0",
"fid_input_cnt_1":"0",
"fid_prc_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_trgt_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_div_cls_code":"0",
"fid_rsfl_rate1":"",
"fid_rsfl_rate2":""
}

Response

{
    "output": [
        {
            "stck_shrn_iscd": "000040",
            "data_rank": "1",
            "hts_kor_isnm": "KR모터스",
            "stck_prpr": "1821",
            "prdy_vrss": "197",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "12.13",
            "acml_vol": "2267183",
            "stck_hgpr": "1861",
            "hgpr_hour": "100214",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1301",
            "lwpr_hour": "090239",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "39.97",
            "dsgt_date_clpr_vrss_prpr_rate": "12.13",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-2.15",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "032800",
            "data_rank": "2",
            "hts_kor_isnm": "판타지오",
            "stck_prpr": "406",
            "prdy_vrss": "75",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "22.66",
            "acml_vol": "36313396",
            "stck_hgpr": "419",
            "hgpr_hour": "095020",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "332",
            "lwpr_hour": "090015",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "22.29",
            "dsgt_date_clpr_vrss_prpr_rate": "22.66",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-3.10",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "018000",
            "data_rank": "3",
            "hts_kor_isnm": "유니슨",
            "stck_prpr": "1233",
            "prdy_vrss": "215",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "21.12",
            "acml_vol": "2436474",
            "stck_hgpr": "1233",
            "hgpr_hour": "100301",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1014",
            "lwpr_hour": "090026",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "21.60",
            "dsgt_date_clpr_vrss_prpr_rate": "21.12",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "0.00",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "083790",
            "data_rank": "4",
            "hts_kor_isnm": "CG인바이츠",
            "stck_prpr": "4025",
            "prdy_vrss": "645",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "19.08",
            "acml_vol": "1666447",
            "stck_hgpr": "4075",
            "hgpr_hour": "092027",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "3460",
            "lwpr_hour": "090005",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "16.33",
            "dsgt_date_clpr_vrss_prpr_rate": "19.08",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-1.23",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "237690",
            "data_rank": "5",
            "hts_kor_isnm": "에스티팜",
            "stck_prpr": "93400",
            "prdy_vrss": "15800",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "20.36",
            "acml_vol": "1368523",
            "stck_hgpr": "95000",
            "hgpr_hour": "092731",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "80400",
            "lwpr_hour": "090025",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "16.17",
            "dsgt_date_clpr_vrss_prpr_rate": "20.36",
            "cnnt_ascn_dynu": "3",
            "hgpr_vrss_prpr_rate": "-1.68",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "065150",
            "data_rank": "6",
            "hts_kor_isnm": "대산F&B",
            "stck_prpr": "239",
            "prdy_vrss": "33",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "16.02",
            "acml_vol": "5046848",
            "stck_hgpr": "267",
            "hgpr_hour": "094747",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "206",
            "lwpr_hour": "090024",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "16.02",
            "dsgt_date_clpr_vrss_prpr_rate": "16.02",
            "cnnt_ascn_dynu": "3",
            "hgpr_vrss_prpr_rate": "-10.49",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "008600",
            "data_rank": "7",
            "hts_kor_isnm": "윌비스",
            "stck_prpr": "596",
            "prdy_vrss": "66",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "12.45",
            "acml_vol": "3819993",
            "stck_hgpr": "620",
            "hgpr_hour": "094852",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "516",
            "lwpr_hour": "090106",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "15.50",
            "dsgt_date_clpr_vrss_prpr_rate": "12.45",
            "cnnt_ascn_dynu": "3",
            "hgpr_vrss_prpr_rate": "-3.87",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "219130",
            "data_rank": "8",
            "hts_kor_isnm": "타이거일렉",
            "stck_prpr": "37700",
            "prdy_vrss": "4700",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "14.24",
            "acml_vol": "188206",
            "stck_hgpr": "38350",
            "hgpr_hour": "095838",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "32650",
            "lwpr_hour": "090031",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "15.47",
            "dsgt_date_clpr_vrss_prpr_rate": "14.24",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-1.69",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "004380",
            "data_rank": "9",
            "hts_kor_isnm": "삼익THK",
            "stck_prpr": "17290",
            "prdy_vrss": "2100",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "13.82",
            "acml_vol": "2290984",
            "stck_hgpr": "17720",
            "hgpr_hour": "095642",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "15050",
            "lwpr_hour": "090319",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "14.88",
            "dsgt_date_clpr_vrss_prpr_rate": "13.82",
            "cnnt_ascn_dynu": "5",
            "hgpr_vrss_prpr_rate": "-2.43",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "321370",
            "data_rank": "10",
            "hts_kor_isnm": "센서뷰",
            "stck_prpr": "5020",
            "prdy_vrss": "920",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "22.44",
            "acml_vol": "4923442",
            "stck_hgpr": "5300",
            "hgpr_hour": "092639",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "4400",
            "lwpr_hour": "090004",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "14.09",
            "dsgt_date_clpr_vrss_prpr_rate": "22.44",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-5.28",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "010660",
            "data_rank": "11",
            "hts_kor_isnm": "화천기계",
            "stck_prpr": "7470",
            "prdy_vrss": "1210",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "19.33",
            "acml_vol": "9426161",
            "stck_hgpr": "7740",
            "hgpr_hour": "091704",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "6610",
            "lwpr_hour": "090030",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "13.01",
            "dsgt_date_clpr_vrss_prpr_rate": "19.33",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-3.49",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "062970",
            "data_rank": "12",
            "hts_kor_isnm": "피피아이",
            "stck_prpr": "1989",
            "prdy_vrss": "232",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "13.20",
            "acml_vol": "2246815",
            "stck_hgpr": "2150",
            "hgpr_hour": "093356",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1776",
            "lwpr_hour": "090028",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.99",
            "dsgt_date_clpr_vrss_prpr_rate": "13.20",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-7.49",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "060230",
            "data_rank": "13",
            "hts_kor_isnm": "소니드",
            "stck_prpr": "2440",
            "prdy_vrss": "345",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "16.47",
            "acml_vol": "1266350",
            "stck_hgpr": "2500",
            "hgpr_hour": "090948",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "2180",
            "lwpr_hour": "090032",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.93",
            "dsgt_date_clpr_vrss_prpr_rate": "16.47",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-2.40",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "073570",
            "data_rank": "14",
            "hts_kor_isnm": "리튬포어스",
            "stck_prpr": "6240",
            "prdy_vrss": "840",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "15.56",
            "acml_vol": "2650262",
            "stck_hgpr": "6390",
            "hgpr_hour": "094423",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "5580",
            "lwpr_hour": "090050",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.83",
            "dsgt_date_clpr_vrss_prpr_rate": "15.56",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-2.35",
            "cnnt_down_dynu": "3",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "066910",
            "data_rank": "15",
            "hts_kor_isnm": "손오공",
            "stck_prpr": "3745",
            "prdy_vrss": "415",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "12.46",
            "acml_vol": "1612034",
            "stck_hgpr": "3850",
            "hgpr_hour": "094324",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "3355",
            "lwpr_hour": "090035",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.62",
            "dsgt_date_clpr_vrss_prpr_rate": "12.46",
            "cnnt_ascn_dynu": "5",
            "hgpr_vrss_prpr_rate": "-2.73",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "217620",
            "data_rank": "16",
            "hts_kor_isnm": "디딤이앤에프",
            "stck_prpr": "415",
            "prdy_vrss": "-26",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-5.90",
            "acml_vol": "3239066",
            "stck_hgpr": "419",
            "hgpr_hour": "093956",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "372",
            "lwpr_hour": "091151",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.56",
            "dsgt_date_clpr_vrss_prpr_rate": "-5.90",
            "cnnt_ascn_dynu": "0",
            "hgpr_vrss_prpr_rate": "-0.95",
            "cnnt_down_dynu": "3",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "103590",
            "data_rank": "17",
            "hts_kor_isnm": "일진전기",
            "stck_prpr": "17340",
            "prdy_vrss": "2660",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "18.12",
            "acml_vol": "9389511",
            "stck_hgpr": "18500",
            "hgpr_hour": "092900",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "15570",
            "lwpr_hour": "090345",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.37",
            "dsgt_date_clpr_vrss_prpr_rate": "18.12",
            "cnnt_ascn_dynu": "4",
            "hgpr_vrss_prpr_rate": "-6.27",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "224060",
            "data_rank": "18",
            "hts_kor_isnm": "더코디",
            "stck_prpr": "6230",
            "prdy_vrss": "760",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "13.89",
            "acml_vol": "646297",
            "stck_hgpr": "7110",
            "hgpr_hour": "091332",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "5600",
            "lwpr_hour": "090030",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.25",
            "dsgt_date_clpr_vrss_prpr_rate": "13.89",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-12.38",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "064800",
            "data_rank": "19",
            "hts_kor_isnm": "젬백스링크",
            "stck_prpr": "3275",
            "prdy_vrss": "195",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.33",
            "acml_vol": "723313",
            "stck_hgpr": "3310",
            "hgpr_hour": "100240",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "2945",
            "lwpr_hour": "090021",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.21",
            "dsgt_date_clpr_vrss_prpr_rate": "6.33",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-1.06",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "383310",
            "data_rank": "20",
            "hts_kor_isnm": "에코프로에이치엔",
            "stck_prpr": "80400",
            "prdy_vrss": "8700",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "12.13",
            "acml_vol": "629737",
            "stck_hgpr": "82900",
            "hgpr_hour": "094050",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "72300",
            "lwpr_hour": "090018",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.20",
            "dsgt_date_clpr_vrss_prpr_rate": "12.13",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-3.02",
            "cnnt_down_dynu": "2",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "101390",
            "data_rank": "21",
            "hts_kor_isnm": "아이엠",
            "stck_prpr": "8570",
            "prdy_vrss": "-480",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-5.30",
            "acml_vol": "389587",
            "stck_hgpr": "9500",
            "hgpr_hour": "090436",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "7710",
            "lwpr_hour": "094503",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "11.15",
            "dsgt_date_clpr_vrss_prpr_rate": "-5.30",
            "cnnt_ascn_dynu": "3",
            "hgpr_vrss_prpr_rate": "-9.79",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "196170",
            "data_rank": "22",
            "hts_kor_isnm": "알테오젠",
            "stck_prpr": "221000",
            "prdy_vrss": "16500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.07",
            "acml_vol": "1045024",
            "stck_hgpr": "224000",
            "hgpr_hour": "093639",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "199500",
            "lwpr_hour": "090416",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "10.78",
            "dsgt_date_clpr_vrss_prpr_rate": "8.07",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-1.34",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "388790",
            "data_rank": "23",
            "hts_kor_isnm": "라이콤",
            "stck_prpr": "2105",
            "prdy_vrss": "200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "10.50",
            "acml_vol": "770420",
            "stck_hgpr": "2175",
            "hgpr_hour": "092044",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1908",
            "lwpr_hour": "090040",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "10.32",
            "dsgt_date_clpr_vrss_prpr_rate": "10.50",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-3.22",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "452300",
            "data_rank": "24",
            "hts_kor_isnm": "캡스톤파트너스",
            "stck_prpr": "4805",
            "prdy_vrss": "435",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.95",
            "acml_vol": "804742",
            "stck_hgpr": "4990",
            "hgpr_hour": "094904",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "4360",
            "lwpr_hour": "090206",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "10.21",
            "dsgt_date_clpr_vrss_prpr_rate": "9.95",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-3.71",
            "cnnt_down_dynu": "2",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "214430",
            "data_rank": "25",
            "hts_kor_isnm": "아이쓰리시스템",
            "stck_prpr": "36900",
            "prdy_vrss": "4500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "13.89",
            "acml_vol": "417441",
            "stck_hgpr": "39000",
            "hgpr_hour": "091455",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "33500",
            "lwpr_hour": "090026",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "10.15",
            "dsgt_date_clpr_vrss_prpr_rate": "13.89",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-5.38",
            "cnnt_down_dynu": "4",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "276730",
            "data_rank": "26",
            "hts_kor_isnm": "제주맥주",
            "stck_prpr": "1500",
            "prdy_vrss": "156",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "11.61",
            "acml_vol": "3075893",
            "stck_hgpr": "1550",
            "hgpr_hour": "090617",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1365",
            "lwpr_hour": "090109",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "9.89",
            "dsgt_date_clpr_vrss_prpr_rate": "11.61",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-3.23",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "009620",
            "data_rank": "27",
            "hts_kor_isnm": "삼보산업",
            "stck_prpr": "1103",
            "prdy_vrss": "102",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "10.19",
            "acml_vol": "2834656",
            "stck_hgpr": "1149",
            "hgpr_hour": "091655",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1005",
            "lwpr_hour": "090018",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "9.75",
            "dsgt_date_clpr_vrss_prpr_rate": "10.19",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "-4.00",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "457190",
            "data_rank": "28",
            "hts_kor_isnm": "이수스페셜티케미컬",
            "stck_prpr": "389000",
            "prdy_vrss": "46500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "13.58",
            "acml_vol": "335026",
            "stck_hgpr": "389000",
            "hgpr_hour": "100301",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "356000",
            "lwpr_hour": "090551",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "9.27",
            "dsgt_date_clpr_vrss_prpr_rate": "13.58",
            "cnnt_ascn_dynu": "2",
            "hgpr_vrss_prpr_rate": "0.00",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "005110",
            "data_rank": "29",
            "hts_kor_isnm": "한창",
            "stck_prpr": "1270",
            "prdy_vrss": "104",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.92",
            "acml_vol": "1155830",
            "stck_hgpr": "1388",
            "hgpr_hour": "091801",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "1164",
            "lwpr_hour": "090107",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "9.11",
            "dsgt_date_clpr_vrss_prpr_rate": "8.92",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-8.50",
            "cnnt_down_dynu": "1",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        },
        {
            "stck_shrn_iscd": "288330",
            "data_rank": "30",
            "hts_kor_isnm": "브릿지바이오테라퓨틱스",
            "stck_prpr": "3455",
            "prdy_vrss": "250",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "7.80",
            "acml_vol": "111007",
            "stck_hgpr": "3595",
            "hgpr_hour": "092107",
            "acml_hgpr_date": "20240318",
            "stck_lwpr": "3175",
            "lwpr_hour": "090157",
            "acml_lwpr_date": "20240318",
            "lwpr_vrss_prpr_rate": "8.82",
            "dsgt_date_clpr_vrss_prpr_rate": "7.80",
            "cnnt_ascn_dynu": "1",
            "hgpr_vrss_prpr_rate": "-3.89",
            "cnnt_down_dynu": "0",
            "oprc_vrss_prpr_sign": "2",
            "oprc_vrss_prpr": "0",
            "oprc_vrss_prpr_rate": "0.00",
            "prd_rsfl": "0",
            "prd_rsfl_rate": "0.00"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 수익자산지표 순위[v1_국내주식-090]

REST

국내주식 수익자산지표 순위[v1_국내주식-090]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/profit-asset-index
  • Format
     
  • Content-Type
     

개요

국내주식 수익자산지표 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0173] 수익자산지표 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01730000
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 시장구분코드 (주식 J)
fid_trgt_cls_code 대상 구분 코드 String Y 32 0:전체
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20173 )
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_input_option_1 입력 옵션1 String Y 10 회계연도 (2023)
fid_input_option_2 입력 옵션2 String Y 10 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0:매출이익 1:영업이익 2:경상이익 3:당기순이익 4:자산총계 5:부채총계 6:자본총계
fid_blng_cls_code 소속 구분 코드 String Y 2 0:전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0:전체

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
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-prdy_vrss_sign 전일 대비 부호 String Y 1
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-sale_totl_prfi 매출 총 이익 String Y 182
-bsop_prti 영업 이익 String Y 182
-op_prfi 경상 이익 String Y 182
-thtr_ntin 당기순이익 String Y 102
-total_aset 자산총계 String Y 102
-total_lblt 부채총계 String Y 102
-total_cptl 자본총계 String Y 102
-stac_month 결산 월 String Y 2
-stac_month_cls_code 결산 월 구분 코드 String Y 2
-iqry_csnu 조회 건수 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20173",
"fid_input_iscd":"0000",
"fid_div_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_input_option_1":"2023",
"fid_input_option_2":"0",
"fid_rank_sort_cls_code":"0",
"fid_blng_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_trgt_cls_code":"0",
}

Response

{
    "output": [
        {
            "data_rank": "1",
            "hts_kor_isnm": "삼성전자",
            "mksc_shrn_iscd": "005930",
            "stck_prpr": "72800",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.69",
            "acml_vol": "3682788",
            "sale_totl_prfi": "177383.00",
            "bsop_prti": "6402.00",
            "op_prfi": "18264.00",
            "thtr_ntin": "15746.00",
            "total_aset": "4540918.00",
            "total_lblt": "942924.00",
            "total_cptl": "3597994.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "2",
            "hts_kor_isnm": "현대차",
            "mksc_shrn_iscd": "005380",
            "stck_prpr": "246500",
            "prdy_vrss": "3000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.23",
            "acml_vol": "264085",
            "sale_totl_prfi": "77220.00",
            "bsop_prti": "35927.00",
            "op_prfi": "45909.00",
            "thtr_ntin": "34194.00",
            "total_aset": "2643636.00",
            "total_lblt": "1704440.00",
            "total_cptl": "939195.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "3",
            "hts_kor_isnm": "KT",
            "mksc_shrn_iscd": "030200",
            "stck_prpr": "38100",
            "prdy_vrss": "-150",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.39",
            "acml_vol": "98431",
            "sale_totl_prfi": "64437.00",
            "bsop_prti": "4861.00",
            "op_prfi": "4376.00",
            "thtr_ntin": "3096.00",
            "total_aset": "402144.00",
            "total_lblt": "220625.00",
            "total_cptl": "181520.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "4",
            "hts_kor_isnm": "기아",
            "mksc_shrn_iscd": "000270",
            "stck_prpr": "127400",
            "prdy_vrss": "2400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.92",
            "acml_vol": "505419",
            "sale_totl_prfi": "53734.00",
            "bsop_prti": "28740.00",
            "op_prfi": "31421.00",
            "thtr_ntin": "21198.00",
            "total_aset": "776127.00",
            "total_lblt": "375811.00",
            "total_cptl": "400316.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "5",
            "hts_kor_isnm": "LG전자",
            "mksc_shrn_iscd": "066570",
            "stck_prpr": "97900",
            "prdy_vrss": "-1000",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.01",
            "acml_vol": "123952",
            "sale_totl_prfi": "51699.00",
            "bsop_prti": "14974.00",
            "op_prfi": "9337.00",
            "thtr_ntin": "5465.00",
            "total_aset": "574906.00",
            "total_lblt": "341309.00",
            "total_cptl": "233598.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "6",
            "hts_kor_isnm": "SK텔레콤",
            "mksc_shrn_iscd": "017670",
            "stck_prpr": "52900",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.38",
            "acml_vol": "145002",
            "sale_totl_prfi": "43722.00",
            "bsop_prti": "4948.00",
            "op_prfi": "4209.00",
            "thtr_ntin": "3025.00",
            "total_aset": "305397.00",
            "total_lblt": "182230.00",
            "total_cptl": "123167.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "7",
            "hts_kor_isnm": "삼성화재",
            "mksc_shrn_iscd": "000810",
            "stck_prpr": "307500",
            "prdy_vrss": "-2000",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.65",
            "acml_vol": "38892",
            "sale_totl_prfi": "40846.00",
            "bsop_prti": "8333.00",
            "op_prfi": "8593.00",
            "thtr_ntin": "6133.00",
            "total_aset": "814661.00",
            "total_lblt": "682398.00",
            "total_cptl": "132264.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "8",
            "hts_kor_isnm": "DB손해보험",
            "mksc_shrn_iscd": "005830",
            "stck_prpr": "99700",
            "prdy_vrss": "-2200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.16",
            "acml_vol": "60493",
            "sale_totl_prfi": "35945.00",
            "bsop_prti": "6782.00",
            "op_prfi": "6873.00",
            "thtr_ntin": "5274.00",
            "total_aset": "550956.00",
            "total_lblt": "457981.00",
            "total_cptl": "92975.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "9",
            "hts_kor_isnm": "LG유플러스",
            "mksc_shrn_iscd": "032640",
            "stck_prpr": "9990",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.70",
            "acml_vol": "242577",
            "sale_totl_prfi": "35413.00",
            "bsop_prti": "2602.00",
            "op_prfi": "2110.00",
            "thtr_ntin": "1551.00",
            "total_aset": "200178.00",
            "total_lblt": "115891.00",
            "total_cptl": "84287.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "10",
            "hts_kor_isnm": "현대해상",
            "mksc_shrn_iscd": "001450",
            "stck_prpr": "33850",
            "prdy_vrss": "-650",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.88",
            "acml_vol": "157602",
            "sale_totl_prfi": "32220.00",
            "bsop_prti": "2861.00",
            "op_prfi": "2769.00",
            "thtr_ntin": "2136.00",
            "total_aset": "430393.00",
            "total_lblt": "364840.00",
            "total_cptl": "65552.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "11",
            "hts_kor_isnm": "SK",
            "mksc_shrn_iscd": "034730",
            "stck_prpr": "185100",
            "prdy_vrss": "-2200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.17",
            "acml_vol": "31227",
            "sale_totl_prfi": "30209.00",
            "bsop_prti": "11304.00",
            "op_prfi": "148.00",
            "thtr_ntin": "-66.00",
            "total_aset": "1977927.00",
            "total_lblt": "1239833.00",
            "total_cptl": "738094.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "12",
            "hts_kor_isnm": "흥국화재",
            "mksc_shrn_iscd": "000540",
            "stck_prpr": "4500",
            "prdy_vrss": "-125",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.70",
            "acml_vol": "92773",
            "sale_totl_prfi": "29739.00",
            "bsop_prti": "1860.00",
            "op_prfi": "1868.00",
            "thtr_ntin": "1475.00",
            "total_aset": "139661.00",
            "total_lblt": "132461.00",
            "total_cptl": "7200.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "13",
            "hts_kor_isnm": "KB금융",
            "mksc_shrn_iscd": "105560",
            "stck_prpr": "73000",
            "prdy_vrss": "-3200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-4.20",
            "acml_vol": "999009",
            "sale_totl_prfi": "27856.00",
            "bsop_prti": "21250.00",
            "op_prfi": "20289.00",
            "thtr_ntin": "14992.00",
            "total_aset": "6914356.00",
            "total_lblt": "6351955.00",
            "total_cptl": "562402.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "14",
            "hts_kor_isnm": "CJ",
            "mksc_shrn_iscd": "001040",
            "stck_prpr": "109700",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.46",
            "acml_vol": "216421",
            "sale_totl_prfi": "26296.00",
            "bsop_prti": "3293.00",
            "op_prfi": "1272.00",
            "thtr_ntin": "117.00",
            "total_aset": "489176.00",
            "total_lblt": "310436.00",
            "total_cptl": "178740.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "15",
            "hts_kor_isnm": "신한지주",
            "mksc_shrn_iscd": "055550",
            "stck_prpr": "48700",
            "prdy_vrss": "-900",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.81",
            "acml_vol": "907017",
            "sale_totl_prfi": "25738.00",
            "bsop_prti": "17562.00",
            "op_prfi": "18568.00",
            "thtr_ntin": "14143.00",
            "total_aset": "6761756.00",
            "total_lblt": "6203801.00",
            "total_cptl": "557955.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "16",
            "hts_kor_isnm": "삼성생명",
            "mksc_shrn_iscd": "032830",
            "stck_prpr": "96000",
            "prdy_vrss": "-3100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.13",
            "acml_vol": "233938",
            "sale_totl_prfi": "23550.00",
            "bsop_prti": "8818.00",
            "op_prfi": "9564.00",
            "thtr_ntin": "7391.00",
            "total_aset": "2997953.00",
            "total_lblt": "2599820.00",
            "total_cptl": "398133.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "17",
            "hts_kor_isnm": "LG화학",
            "mksc_shrn_iscd": "051910",
            "stck_prpr": "439000",
            "prdy_vrss": "8000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.86",
            "acml_vol": "66448",
            "sale_totl_prfi": "23251.00",
            "bsop_prti": "6907.00",
            "op_prfi": "9160.00",
            "thtr_ntin": "6691.00",
            "total_aset": "708960.00",
            "total_lblt": "324919.00",
            "total_cptl": "384041.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "18",
            "hts_kor_isnm": "롯데손해보험",
            "mksc_shrn_iscd": "000400",
            "stck_prpr": "2920",
            "prdy_vrss": "55",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.92",
            "acml_vol": "365380",
            "sale_totl_prfi": "23071.00",
            "bsop_prti": "-765.00",
            "op_prfi": "-845.00",
            "thtr_ntin": "-631.00",
            "total_aset": "179258.00",
            "total_lblt": "174772.00",
            "total_cptl": "4486.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "19",
            "hts_kor_isnm": "한화",
            "mksc_shrn_iscd": "000880",
            "stck_prpr": "28600",
            "prdy_vrss": "650",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.33",
            "acml_vol": "123355",
            "sale_totl_prfi": "22992.00",
            "bsop_prti": "13738.00",
            "op_prfi": "16434.00",
            "thtr_ntin": "11553.00",
            "total_aset": "2018543.00",
            "total_lblt": "1675732.00",
            "total_cptl": "342811.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "20",
            "hts_kor_isnm": "한화생명",
            "mksc_shrn_iscd": "088350",
            "stck_prpr": "3170",
            "prdy_vrss": "-80",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.46",
            "acml_vol": "926965",
            "sale_totl_prfi": "22965.00",
            "bsop_prti": "7619.00",
            "op_prfi": "6103.00",
            "thtr_ntin": "4635.00",
            "total_aset": "1469270.00",
            "total_lblt": "1305749.00",
            "total_cptl": "163521.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "21",
            "hts_kor_isnm": "NAVER",
            "mksc_shrn_iscd": "035420",
            "stck_prpr": "184600",
            "prdy_vrss": "-1500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.81",
            "acml_vol": "338155",
            "sale_totl_prfi": "22804.00",
            "bsop_prti": "3305.00",
            "op_prfi": "1166.00",
            "thtr_ntin": "437.00",
            "total_aset": "357733.00",
            "total_lblt": "116494.00",
            "total_cptl": "241239.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "22",
            "hts_kor_isnm": "우리금융지주",
            "mksc_shrn_iscd": "316140",
            "stck_prpr": "14740",
            "prdy_vrss": "-490",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.22",
            "acml_vol": "1903659",
            "sale_totl_prfi": "22188.00",
            "bsop_prti": "12520.00",
            "op_prfi": "12703.00",
            "thtr_ntin": "9466.00",
            "total_aset": "4780793.00",
            "total_lblt": "4454756.00",
            "total_cptl": "326036.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "23",
            "hts_kor_isnm": "하나금융지주",
            "mksc_shrn_iscd": "086790",
            "stck_prpr": "61700",
            "prdy_vrss": "-400",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.64",
            "acml_vol": "731232",
            "sale_totl_prfi": "21750.00",
            "bsop_prti": "15188.00",
            "op_prfi": "14958.00",
            "thtr_ntin": "11095.00",
            "total_aset": "5877306.00",
            "total_lblt": "5491426.00",
            "total_cptl": "385880.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "24",
            "hts_kor_isnm": "이마트",
            "mksc_shrn_iscd": "139480",
            "stck_prpr": "69800",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.71",
            "acml_vol": "38727",
            "sale_totl_prfi": "19974.00",
            "bsop_prti": "137.00",
            "op_prfi": "53.00",
            "thtr_ntin": "27.00",
            "total_aset": "329952.00",
            "total_lblt": "196451.00",
            "total_cptl": "133500.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "25",
            "hts_kor_isnm": "기업은행",
            "mksc_shrn_iscd": "024110",
            "stck_prpr": "15150",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.66",
            "acml_vol": "937861",
            "sale_totl_prfi": "19482.00",
            "bsop_prti": "9156.00",
            "op_prfi": "9371.00",
            "thtr_ntin": "7233.00",
            "total_aset": "4378441.00",
            "total_lblt": "4079864.00",
            "total_cptl": "298577.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "26",
            "hts_kor_isnm": "GS",
            "mksc_shrn_iscd": "078930",
            "stck_prpr": "49150",
            "prdy_vrss": "-250",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.51",
            "acml_vol": "19800",
            "sale_totl_prfi": "17946.00",
            "bsop_prti": "10625.00",
            "op_prfi": "10055.00",
            "thtr_ntin": "5211.00",
            "total_aset": "345250.00",
            "total_lblt": "178336.00",
            "total_cptl": "166914.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "27",
            "hts_kor_isnm": "카카오",
            "mksc_shrn_iscd": "035720",
            "stck_prpr": "53500",
            "prdy_vrss": "-600",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.11",
            "acml_vol": "370033",
            "sale_totl_prfi": "17403.00",
            "bsop_prti": "711.00",
            "op_prfi": "733.00",
            "thtr_ntin": "638.00",
            "total_aset": "255864.00",
            "total_lblt": "102841.00",
            "total_cptl": "153023.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "28",
            "hts_kor_isnm": "롯데쇼핑",
            "mksc_shrn_iscd": "023530",
            "stck_prpr": "73300",
            "prdy_vrss": "-300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.41",
            "acml_vol": "11381",
            "sale_totl_prfi": "16117.00",
            "bsop_prti": "1125.00",
            "op_prfi": "1051.00",
            "thtr_ntin": "578.00",
            "total_aset": "318847.00",
            "total_lblt": "208468.00",
            "total_cptl": "110379.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "29",
            "hts_kor_isnm": "삼성물산",
            "mksc_shrn_iscd": "028260",
            "stck_prpr": "151000",
            "prdy_vrss": "-3100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.01",
            "acml_vol": "281396",
            "sale_totl_prfi": "15087.00",
            "bsop_prti": "6405.00",
            "op_prfi": "9179.00",
            "thtr_ntin": "7519.00",
            "total_aset": "618621.00",
            "total_lblt": "275928.00",
            "total_cptl": "342693.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        },
        {
            "data_rank": "30",
            "hts_kor_isnm": "CJ제일제당",
            "mksc_shrn_iscd": "097950",
            "stck_prpr": "291000",
            "prdy_vrss": "3500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.22",
            "acml_vol": "5733",
            "sale_totl_prfi": "14572.00",
            "bsop_prti": "2528.00",
            "op_prfi": "993.00",
            "thtr_ntin": "493.00",
            "total_aset": "305950.00",
            "total_lblt": "188033.00",
            "total_cptl": "117916.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "2468"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시가총액 상위[v1_국내주식-091]

REST

국내주식 시가총액 상위[v1_국내주식-091]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/market-cap
  • Format
     
  • Content-Type
     

개요

국내주식 시가총액 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0174] 시가총액 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01740000
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_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20174 )
fid_div_cls_code 분류 구분 코드 String Y 2 0: 전체, 1:보통주, 2:우선주
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-lstn_stcn 상장 주수 String Y 18
-stck_avls 시가 총액 String Y 18
-mrkt_whol_avls_rlim 시장 전체 시가총액 비중 String Y 52

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20174",
"fid_div_cls_code":"0",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0"
"fid_trgt_exls_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
}

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "005930",
            "data_rank": "1",
            "hts_kor_isnm": "삼성전자",
            "stck_prpr": "72700",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.55",
            "acml_vol": "3686661",
            "lstn_stcn": "5969782550",
            "stck_avls": "4340032",
            "mrkt_whol_avls_rlim": "15.77"
        },
        {
            "mksc_shrn_iscd": "000660",
            "data_rank": "2",
            "hts_kor_isnm": "SK하이닉스",
            "stck_prpr": "162300",
            "prdy_vrss": "1100",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.68",
            "acml_vol": "807093",
            "lstn_stcn": "728002365",
            "stck_avls": "1181548",
            "mrkt_whol_avls_rlim": "4.29"
        },
        {
            "mksc_shrn_iscd": "373220",
            "data_rank": "3",
            "hts_kor_isnm": "LG에너지솔루션",
            "stck_prpr": "404000",
            "prdy_vrss": "5500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.38",
            "acml_vol": "43109",
            "lstn_stcn": "234000000",
            "stck_avls": "945360",
            "mrkt_whol_avls_rlim": "3.43"
        },
        {
            "mksc_shrn_iscd": "207940",
            "data_rank": "4",
            "hts_kor_isnm": "삼성바이오로직스",
            "stck_prpr": "863000",
            "prdy_vrss": "37000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.48",
            "acml_vol": "95134",
            "lstn_stcn": "71174000",
            "stck_avls": "614232",
            "mrkt_whol_avls_rlim": "2.23"
        },
        {
            "mksc_shrn_iscd": "005380",
            "data_rank": "5",
            "hts_kor_isnm": "현대차",
            "stck_prpr": "246500",
            "prdy_vrss": "3000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.23",
            "acml_vol": "264371",
            "lstn_stcn": "211531506",
            "stck_avls": "521425",
            "mrkt_whol_avls_rlim": "1.89"
        },
        {
            "mksc_shrn_iscd": "005935",
            "data_rank": "6",
            "hts_kor_isnm": "삼성전자우",
            "stck_prpr": "62500",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.81",
            "acml_vol": "198907",
            "lstn_stcn": "822886700",
            "stck_avls": "514304",
            "mrkt_whol_avls_rlim": "1.87"
        },
        {
            "mksc_shrn_iscd": "000270",
            "data_rank": "7",
            "hts_kor_isnm": "기아",
            "stck_prpr": "127400",
            "prdy_vrss": "2400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.92",
            "acml_vol": "505817",
            "lstn_stcn": "402044203",
            "stck_avls": "512204",
            "mrkt_whol_avls_rlim": "1.86"
        },
        {
            "mksc_shrn_iscd": "068270",
            "data_rank": "8",
            "hts_kor_isnm": "셀트리온",
            "stck_prpr": "182000",
            "prdy_vrss": "1200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.66",
            "acml_vol": "247817",
            "lstn_stcn": "218049762",
            "stck_avls": "396851",
            "mrkt_whol_avls_rlim": "1.44"
        },
        {
            "mksc_shrn_iscd": "005490",
            "data_rank": "9",
            "hts_kor_isnm": "POSCO홀딩스",
            "stck_prpr": "437000",
            "prdy_vrss": "2000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.46",
            "acml_vol": "154280",
            "lstn_stcn": "84571230",
            "stck_avls": "369576",
            "mrkt_whol_avls_rlim": "1.34"
        },
        {
            "mksc_shrn_iscd": "051910",
            "data_rank": "10",
            "hts_kor_isnm": "LG화학",
            "stck_prpr": "438500",
            "prdy_vrss": "7500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.74",
            "acml_vol": "66555",
            "lstn_stcn": "70592343",
            "stck_avls": "309547",
            "mrkt_whol_avls_rlim": "1.12"
        },
        {
            "mksc_shrn_iscd": "006400",
            "data_rank": "11",
            "hts_kor_isnm": "삼성SDI",
            "stck_prpr": "438000",
            "prdy_vrss": "13000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.06",
            "acml_vol": "227802",
            "lstn_stcn": "68764530",
            "stck_avls": "301189",
            "mrkt_whol_avls_rlim": "1.09"
        },
        {
            "mksc_shrn_iscd": "035420",
            "data_rank": "12",
            "hts_kor_isnm": "NAVER",
            "stck_prpr": "184500",
            "prdy_vrss": "-1600",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.86",
            "acml_vol": "338579",
            "lstn_stcn": "162408594",
            "stck_avls": "299644",
            "mrkt_whol_avls_rlim": "1.09"
        },
        {
            "mksc_shrn_iscd": "105560",
            "data_rank": "13",
            "hts_kor_isnm": "KB금융",
            "stck_prpr": "73000",
            "prdy_vrss": "-3200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-4.20",
            "acml_vol": "999671",
            "lstn_stcn": "403511072",
            "stck_avls": "294563",
            "mrkt_whol_avls_rlim": "1.07"
        },
        {
            "mksc_shrn_iscd": "028260",
            "data_rank": "14",
            "hts_kor_isnm": "삼성물산",
            "stck_prpr": "150900",
            "prdy_vrss": "-3200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.08",
            "acml_vol": "281612",
            "lstn_stcn": "185591670",
            "stck_avls": "280058",
            "mrkt_whol_avls_rlim": "1.02"
        },
        {
            "mksc_shrn_iscd": "247540",
            "data_rank": "15",
            "hts_kor_isnm": "에코프로비엠",
            "stck_prpr": "265500",
            "prdy_vrss": "9000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.51",
            "acml_vol": "305799",
            "lstn_stcn": "97801344",
            "stck_avls": "259663",
            "mrkt_whol_avls_rlim": "0.94"
        },
        {
            "mksc_shrn_iscd": "012330",
            "data_rank": "16",
            "hts_kor_isnm": "현대모비스",
            "stck_prpr": "269500",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.19",
            "acml_vol": "78633",
            "lstn_stcn": "93655094",
            "stck_avls": "252400",
            "mrkt_whol_avls_rlim": "0.92"
        },
        {
            "mksc_shrn_iscd": "055550",
            "data_rank": "17",
            "hts_kor_isnm": "신한지주",
            "stck_prpr": "48650",
            "prdy_vrss": "-950",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.92",
            "acml_vol": "910139",
            "lstn_stcn": "512759471",
            "stck_avls": "249457",
            "mrkt_whol_avls_rlim": "0.91"
        },
        {
            "mksc_shrn_iscd": "003670",
            "data_rank": "18",
            "hts_kor_isnm": "포스코퓨처엠",
            "stck_prpr": "319500",
            "prdy_vrss": "3000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.95",
            "acml_vol": "105628",
            "lstn_stcn": "77463220",
            "stck_avls": "247495",
            "mrkt_whol_avls_rlim": "0.90"
        },
        {
            "mksc_shrn_iscd": "035720",
            "data_rank": "19",
            "hts_kor_isnm": "카카오",
            "stck_prpr": "53400",
            "prdy_vrss": "-700",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.29",
            "acml_vol": "370679",
            "lstn_stcn": "445153350",
            "stck_avls": "237712",
            "mrkt_whol_avls_rlim": "0.86"
        },
        {
            "mksc_shrn_iscd": "032830",
            "data_rank": "20",
            "hts_kor_isnm": "삼성생명",
            "stck_prpr": "95900",
            "prdy_vrss": "-3200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.23",
            "acml_vol": "234134",
            "lstn_stcn": "200000000",
            "stck_avls": "191800",
            "mrkt_whol_avls_rlim": "0.70"
        },
        {
            "mksc_shrn_iscd": "086790",
            "data_rank": "21",
            "hts_kor_isnm": "하나금융지주",
            "stck_prpr": "61600",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.81",
            "acml_vol": "731438",
            "lstn_stcn": "292356598",
            "stck_avls": "180092",
            "mrkt_whol_avls_rlim": "0.65"
        },
        {
            "mksc_shrn_iscd": "138040",
            "data_rank": "22",
            "hts_kor_isnm": "메리츠금융지주",
            "stck_prpr": "83100",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.12",
            "acml_vol": "182179",
            "lstn_stcn": "203372114",
            "stck_avls": "169002",
            "mrkt_whol_avls_rlim": "0.61"
        },
        {
            "mksc_shrn_iscd": "086520",
            "data_rank": "23",
            "hts_kor_isnm": "에코프로",
            "stck_prpr": "609000",
            "prdy_vrss": "8000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.33",
            "acml_vol": "64629",
            "lstn_stcn": "26627668",
            "stck_avls": "162162",
            "mrkt_whol_avls_rlim": "0.59"
        },
        {
            "mksc_shrn_iscd": "066570",
            "data_rank": "24",
            "hts_kor_isnm": "LG전자",
            "stck_prpr": "97900",
            "prdy_vrss": "-1000",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.01",
            "acml_vol": "123965",
            "lstn_stcn": "163647814",
            "stck_avls": "160211",
            "mrkt_whol_avls_rlim": "0.58"
        },
        {
            "mksc_shrn_iscd": "015760",
            "data_rank": "25",
            "hts_kor_isnm": "한국전력",
            "stck_prpr": "24500",
            "prdy_vrss": "-350",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.41",
            "acml_vol": "736259",
            "lstn_stcn": "641964077",
            "stck_avls": "157281",
            "mrkt_whol_avls_rlim": "0.57"
        },
        {
            "mksc_shrn_iscd": "000810",
            "data_rank": "26",
            "hts_kor_isnm": "삼성화재",
            "stck_prpr": "307000",
            "prdy_vrss": "-2500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.81",
            "acml_vol": "38909",
            "lstn_stcn": "47374837",
            "stck_avls": "145441",
            "mrkt_whol_avls_rlim": "0.53"
        },
        {
            "mksc_shrn_iscd": "003550",
            "data_rank": "27",
            "hts_kor_isnm": "LG",
            "stck_prpr": "90100",
            "prdy_vrss": "-4800",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-5.06",
            "acml_vol": "232801",
            "lstn_stcn": "157300993",
            "stck_avls": "141728",
            "mrkt_whol_avls_rlim": "0.51"
        },
        {
            "mksc_shrn_iscd": "034730",
            "data_rank": "28",
            "hts_kor_isnm": "SK",
            "stck_prpr": "185000",
            "prdy_vrss": "-2300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.23",
            "acml_vol": "31241",
            "lstn_stcn": "73198329",
            "stck_avls": "135417",
            "mrkt_whol_avls_rlim": "0.49"
        },
        {
            "mksc_shrn_iscd": "323410",
            "data_rank": "29",
            "hts_kor_isnm": "카카오뱅크",
            "stck_prpr": "28100",
            "prdy_vrss": "-300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.06",
            "acml_vol": "289825",
            "lstn_stcn": "476916137",
            "stck_avls": "134013",
            "mrkt_whol_avls_rlim": "0.49"
        },
        {
            "mksc_shrn_iscd": "028300",
            "data_rank": "30",
            "hts_kor_isnm": "HLB",
            "stck_prpr": "101900",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.49",
            "acml_vol": "595180",
            "lstn_stcn": "130812041",
            "stck_avls": "133297",
            "mrkt_whol_avls_rlim": "0.48"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 재무비율 순위[v1_국내주식-092]

REST

국내주식 재무비율 순위[v1_국내주식-092]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/finance-ratio
  • Format
     
  • Content-Type
     

개요

국내주식 재무비율 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0175] 재무비율순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01750000
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_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20175 )
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_div_cls_code 분류 구분 코드 String Y 2 0 : 전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_input_option_1 입력 옵션1 String Y 10 회계년도 입력 (ex 2023)
fid_input_option_2 입력 옵션2 String Y 10 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 7: 수익성 분석, 11 : 안정성 분석, 15: 성장성 분석, 20: 활동성 분석
fid_blng_cls_code 소속 구분 코드 String Y 2 0
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체

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
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-cptl_op_prfi 총자본경상이익율 String Y 92
-cptl_ntin_rate 총자본 순이익율 String Y 92
-sale_totl_rate 매출액 총이익율 String Y 92
-sale_ntin_rate 매출액 순이익율 String Y 92
-bis 자기자본비율 String Y 92
-lblt_rate 부채 비율 String Y 84
-bram_depn 차입금 의존도 String Y 92
-rsrv_rate 유보 비율 String Y 124
-grs 매출액 증가율 String Y 124
-op_prfi_inrt 경상 이익 증가율 String Y 124
-bsop_prfi_inrt 영업 이익 증가율 String Y 124
-ntin_inrt 순이익 증가율 String Y 124
-equt_inrt 자기자본 증가율 String Y 92
-cptl_tnrt 총자본회전율 String Y 92
-sale_bond_tnrt 매출 채권 회전율 String Y 92
-totl_aset_inrt 총자산 증가율 String Y 92
-stac_month 결산 월 String Y 2
-stac_month_cls_code 결산 월 구분 코드 String Y 2
-iqry_csnu 조회 건수 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20175",
"fid_input_iscd":"0000",
"fid_div_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_input_option_1":"2023",
"fid_input_option_2":"3",
"fid_rank_sort_cls_code":"7",
"fid_blng_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_trgt_cls_code":"0"
}

Response

{
    "output": [
        {
            "data_rank": "1",
            "hts_kor_isnm": "한진칼",
            "mksc_shrn_iscd": "180640",
            "stck_prpr": "59500",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.68",
            "acml_vol": "46057",
            "cptl_op_prfi": "177.14",
            "cptl_ntin_rate": "12.41",
            "sale_totl_rate": "51.17",
            "sale_ntin_rate": "177.14",
            "bis": "75.41",
            "lblt_rate": "32.61",
            "bram_depn": "16.29",
            "rsrv_rate": "1583.70",
            "grs": "43.44",
            "op_prfi_inrt": "13.31",
            "bsop_prfi_inrt": "259.13",
            "ntin_inrt": "-52.67",
            "equt_inrt": "17.84",
            "cptl_tnrt": "0.10",
            "sale_bond_tnrt": "10.18",
            "totl_aset_inrt": "1.39",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "2",
            "hts_kor_isnm": "한미반도체",
            "mksc_shrn_iscd": "042700",
            "stck_prpr": "97500",
            "prdy_vrss": "1300",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.35",
            "acml_vol": "319052",
            "cptl_op_prfi": "170.24",
            "cptl_ntin_rate": "44.40",
            "sale_totl_rate": "45.81",
            "sale_ntin_rate": "170.24",
            "bis": "87.56",
            "lblt_rate": "14.20",
            "bram_depn": "0.22",
            "rsrv_rate": "4282.44",
            "grs": "-59.96",
            "op_prfi_inrt": "85.51",
            "bsop_prfi_inrt": "-83.40",
            "ntin_inrt": "91.05",
            "equt_inrt": "41.88",
            "cptl_tnrt": "0.30",
            "sale_bond_tnrt": "2.32",
            "totl_aset_inrt": "34.34",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "3",
            "hts_kor_isnm": "한라IMS",
            "mksc_shrn_iscd": "092460",
            "stck_prpr": "6000",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.84",
            "acml_vol": "6707",
            "cptl_op_prfi": "115.30",
            "cptl_ntin_rate": "45.59",
            "sale_totl_rate": "35.14",
            "sale_ntin_rate": "115.30",
            "bis": "73.41",
            "lblt_rate": "36.21",
            "bram_depn": "11.43",
            "rsrv_rate": "1769.56",
            "grs": "-15.09",
            "op_prfi_inrt": "799.56",
            "bsop_prfi_inrt": "-56.41",
            "ntin_inrt": "722.02",
            "equt_inrt": "66.58",
            "cptl_tnrt": "0.61",
            "sale_bond_tnrt": "15.19",
            "totl_aset_inrt": "20.84",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "4",
            "hts_kor_isnm": "엘앤씨바이오",
            "mksc_shrn_iscd": "290650",
            "stck_prpr": "23600",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.72",
            "acml_vol": "23299",
            "cptl_op_prfi": "99.18",
            "cptl_ntin_rate": "29.41",
            "sale_totl_rate": "52.81",
            "sale_ntin_rate": "99.18",
            "bis": "59.42",
            "lblt_rate": "68.28",
            "bram_depn": "30.27",
            "rsrv_rate": "1254.06",
            "grs": "40.39",
            "op_prfi_inrt": "1621.06",
            "bsop_prfi_inrt": "32.30",
            "ntin_inrt": "1616.82",
            "equt_inrt": "51.74",
            "cptl_tnrt": "0.52",
            "sale_bond_tnrt": "4.22",
            "totl_aset_inrt": "36.35",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "5",
            "hts_kor_isnm": "LX홀딩스",
            "mksc_shrn_iscd": "383800",
            "stck_prpr": "6960",
            "prdy_vrss": "-40",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.57",
            "acml_vol": "43462",
            "cptl_op_prfi": "71.39",
            "cptl_ntin_rate": "6.68",
            "sale_totl_rate": "94.96",
            "sale_ntin_rate": "71.39",
            "bis": "97.97",
            "lblt_rate": "2.07",
            "bram_depn": "0.04",
            "rsrv_rate": "2078.39",
            "grs": "-49.15",
            "op_prfi_inrt": "-54.13",
            "bsop_prfi_inrt": "-56.95",
            "ntin_inrt": "-55.41",
            "equt_inrt": "0.00",
            "cptl_tnrt": "0.10",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "6",
            "hts_kor_isnm": "남화산업",
            "mksc_shrn_iscd": "111710",
            "stck_prpr": "5550",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.25",
            "acml_vol": "6167",
            "cptl_op_prfi": "67.83",
            "cptl_ntin_rate": "11.81",
            "sale_totl_rate": "100.00",
            "sale_ntin_rate": "67.83",
            "bis": "92.25",
            "lblt_rate": "8.40",
            "bram_depn": "0.00",
            "rsrv_rate": "3992.60",
            "grs": "17.54",
            "op_prfi_inrt": "39.10",
            "bsop_prfi_inrt": "28.15",
            "ntin_inrt": "50.28",
            "equt_inrt": "10.96",
            "cptl_tnrt": "0.19",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "9.40",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "7",
            "hts_kor_isnm": "한국자산신탁",
            "mksc_shrn_iscd": "123890",
            "stck_prpr": "3435",
            "prdy_vrss": "-40",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.15",
            "acml_vol": "114745",
            "cptl_op_prfi": "58.16",
            "cptl_ntin_rate": "10.28",
            "sale_totl_rate": "69.89",
            "sale_ntin_rate": "58.16",
            "bis": "69.40",
            "lblt_rate": "44.10",
            "bram_depn": "23.44",
            "rsrv_rate": "1556.75",
            "grs": "9.52",
            "op_prfi_inrt": "24.86",
            "bsop_prfi_inrt": "-20.40",
            "ntin_inrt": "26.18",
            "equt_inrt": "11.47",
            "cptl_tnrt": "0.26",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "8.51",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "8",
            "hts_kor_isnm": "현대지에프홀딩스",
            "mksc_shrn_iscd": "005440",
            "stck_prpr": "4190",
            "prdy_vrss": "85",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.07",
            "acml_vol": "119703",
            "cptl_op_prfi": "57.82",
            "cptl_ntin_rate": "32.87",
            "sale_totl_rate": "16.24",
            "sale_ntin_rate": "63.46",
            "bis": "69.32",
            "lblt_rate": "44.25",
            "bram_depn": "7.16",
            "rsrv_rate": "3097.52",
            "grs": "7.28",
            "op_prfi_inrt": "1767.95",
            "bsop_prfi_inrt": "152.41",
            "ntin_inrt": "957.30",
            "equt_inrt": "46.84",
            "cptl_tnrt": "0.75",
            "sale_bond_tnrt": "3.42",
            "totl_aset_inrt": "46.43",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "9",
            "hts_kor_isnm": "HB솔루션",
            "mksc_shrn_iscd": "297890",
            "stck_prpr": "4395",
            "prdy_vrss": "240",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.78",
            "acml_vol": "4360947",
            "cptl_op_prfi": "56.59",
            "cptl_ntin_rate": "26.88",
            "sale_totl_rate": "26.37",
            "sale_ntin_rate": "56.59",
            "bis": "76.96",
            "lblt_rate": "29.94",
            "bram_depn": "9.95",
            "rsrv_rate": "483.05",
            "grs": "-40.05",
            "op_prfi_inrt": "87.41",
            "bsop_prfi_inrt": "-53.78",
            "ntin_inrt": "57.18",
            "equt_inrt": "56.07",
            "cptl_tnrt": "0.66",
            "sale_bond_tnrt": "9.13",
            "totl_aset_inrt": "31.92",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "10",
            "hts_kor_isnm": "액토즈소프트",
            "mksc_shrn_iscd": "052790",
            "stck_prpr": "9200",
            "prdy_vrss": "120",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.32",
            "acml_vol": "11322",
            "cptl_op_prfi": "52.47",
            "cptl_ntin_rate": "13.07",
            "sale_totl_rate": "85.52",
            "sale_ntin_rate": "52.47",
            "bis": "67.95",
            "lblt_rate": "47.16",
            "bram_depn": "1.56",
            "rsrv_rate": "4140.61",
            "grs": "35.08",
            "op_prfi_inrt": "173.49",
            "bsop_prfi_inrt": "50.33",
            "ntin_inrt": "339.23",
            "equt_inrt": "4.24",
            "cptl_tnrt": "0.38",
            "sale_bond_tnrt": "1.69",
            "totl_aset_inrt": "-0.86",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "11",
            "hts_kor_isnm": "비올",
            "mksc_shrn_iscd": "335890",
            "stck_prpr": "9000",
            "prdy_vrss": "-220",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.39",
            "acml_vol": "2021224",
            "cptl_op_prfi": "50.71",
            "cptl_ntin_rate": "39.77",
            "sale_totl_rate": "77.77",
            "sale_ntin_rate": "50.71",
            "bis": "89.42",
            "lblt_rate": "11.83",
            "bram_depn": "1.02",
            "rsrv_rate": "930.70",
            "grs": "36.69",
            "op_prfi_inrt": "89.29",
            "bsop_prfi_inrt": "72.80",
            "ntin_inrt": "87.93",
            "equt_inrt": "46.71",
            "cptl_tnrt": "0.89",
            "sale_bond_tnrt": "9.93",
            "totl_aset_inrt": "43.43",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "12",
            "hts_kor_isnm": "케어젠",
            "mksc_shrn_iscd": "214370",
            "stck_prpr": "24250",
            "prdy_vrss": "300",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.25",
            "acml_vol": "92291",
            "cptl_op_prfi": "50.41",
            "cptl_ntin_rate": "16.59",
            "sale_totl_rate": "73.68",
            "sale_ntin_rate": "50.41",
            "bis": "91.92",
            "lblt_rate": "8.79",
            "bram_depn": "0.00",
            "rsrv_rate": "5382.82",
            "grs": "14.63",
            "op_prfi_inrt": "43.87",
            "bsop_prfi_inrt": "20.08",
            "ntin_inrt": "46.71",
            "equt_inrt": "5.24",
            "cptl_tnrt": "0.36",
            "sale_bond_tnrt": "7.88",
            "totl_aset_inrt": "5.64",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "13",
            "hts_kor_isnm": "캡스톤파트너스",
            "mksc_shrn_iscd": "452300",
            "stck_prpr": "4840",
            "prdy_vrss": "470",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "10.76",
            "acml_vol": "929728",
            "cptl_op_prfi": "50.13",
            "cptl_ntin_rate": "20.74",
            "sale_totl_rate": "90.77",
            "sale_ntin_rate": "50.13",
            "bis": "62.63",
            "lblt_rate": "59.66",
            "bram_depn": "25.63",
            "rsrv_rate": "867.77",
            "grs": "-15.09",
            "op_prfi_inrt": "13.50",
            "bsop_prfi_inrt": "-7.40",
            "ntin_inrt": "8.21",
            "equt_inrt": "40.76",
            "cptl_tnrt": "0.68",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "33.35",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "14",
            "hts_kor_isnm": "HB인베스트먼트",
            "mksc_shrn_iscd": "440290",
            "stck_prpr": "3215",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "26774",
            "cptl_op_prfi": "46.91",
            "cptl_ntin_rate": "15.32",
            "sale_totl_rate": "90.90",
            "sale_ntin_rate": "46.91",
            "bis": "90.89",
            "lblt_rate": "10.03",
            "bram_depn": "0.00",
            "rsrv_rate": "388.81",
            "grs": "39.39",
            "op_prfi_inrt": "19.39",
            "bsop_prfi_inrt": "19.53",
            "ntin_inrt": "22.90",
            "equt_inrt": "20.05",
            "cptl_tnrt": "0.36",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "22.87",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "15",
            "hts_kor_isnm": "클래시스",
            "mksc_shrn_iscd": "214150",
            "stck_prpr": "34650",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.14",
            "acml_vol": "73547",
            "cptl_op_prfi": "43.97",
            "cptl_ntin_rate": "22.47",
            "sale_totl_rate": "77.78",
            "sale_ntin_rate": "43.97",
            "bis": "74.68",
            "lblt_rate": "33.91",
            "bram_depn": "18.35",
            "rsrv_rate": "4332.41",
            "grs": "31.36",
            "op_prfi_inrt": "34.19",
            "bsop_prfi_inrt": "36.92",
            "ntin_inrt": "29.08",
            "equt_inrt": "34.41",
            "cptl_tnrt": "0.71",
            "sale_bond_tnrt": "15.34",
            "totl_aset_inrt": "8.62",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "16",
            "hts_kor_isnm": "코엔텍",
            "mksc_shrn_iscd": "029960",
            "stck_prpr": "6830",
            "prdy_vrss": "-40",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.58",
            "acml_vol": "14290",
            "cptl_op_prfi": "43.84",
            "cptl_ntin_rate": "19.67",
            "sale_totl_rate": "58.73",
            "sale_ntin_rate": "43.84",
            "bis": "81.88",
            "lblt_rate": "22.13",
            "bram_depn": "5.39",
            "rsrv_rate": "622.42",
            "grs": "21.85",
            "op_prfi_inrt": "34.98",
            "bsop_prfi_inrt": "32.27",
            "ntin_inrt": "33.51",
            "equt_inrt": "9.68",
            "cptl_tnrt": "0.55",
            "sale_bond_tnrt": "9.00",
            "totl_aset_inrt": "7.26",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "17",
            "hts_kor_isnm": "폴라리스오피스",
            "mksc_shrn_iscd": "041020",
            "stck_prpr": "7150",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.83",
            "acml_vol": "560557",
            "cptl_op_prfi": "43.82",
            "cptl_ntin_rate": "18.08",
            "sale_totl_rate": "39.36",
            "sale_ntin_rate": "43.82",
            "bis": "81.59",
            "lblt_rate": "22.57",
            "bram_depn": "4.04",
            "rsrv_rate": "247.49",
            "grs": "254.29",
            "op_prfi_inrt": "125.32",
            "bsop_prfi_inrt": "221.82",
            "ntin_inrt": "116.06",
            "equt_inrt": "331.24",
            "cptl_tnrt": "0.50",
            "sale_bond_tnrt": "4.79",
            "totl_aset_inrt": "375.94",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "18",
            "hts_kor_isnm": "바이오플러스",
            "mksc_shrn_iscd": "099430",
            "stck_prpr": "6810",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "54755",
            "cptl_op_prfi": "41.60",
            "cptl_ntin_rate": "17.49",
            "sale_totl_rate": "60.54",
            "sale_ntin_rate": "41.60",
            "bis": "79.41",
            "lblt_rate": "25.92",
            "bram_depn": "4.46",
            "rsrv_rate": "336.08",
            "grs": "21.50",
            "op_prfi_inrt": "28.55",
            "bsop_prfi_inrt": "16.99",
            "ntin_inrt": "36.82",
            "equt_inrt": "18.57",
            "cptl_tnrt": "0.53",
            "sale_bond_tnrt": "3.47",
            "totl_aset_inrt": "39.69",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "19",
            "hts_kor_isnm": "HPSP",
            "mksc_shrn_iscd": "403870",
            "stck_prpr": "52800",
            "prdy_vrss": "600",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.15",
            "acml_vol": "224631",
            "cptl_op_prfi": "41.43",
            "cptl_ntin_rate": "37.44",
            "sale_totl_rate": "69.10",
            "sale_ntin_rate": "41.43",
            "bis": "74.88",
            "lblt_rate": "33.55",
            "bram_depn": "1.17",
            "rsrv_rate": "1825.82",
            "grs": "73.66",
            "op_prfi_inrt": "86.18",
            "bsop_prfi_inrt": "88.39",
            "ntin_inrt": "86.75",
            "equt_inrt": "270.38",
            "cptl_tnrt": "1.28",
            "sale_bond_tnrt": "41.66",
            "totl_aset_inrt": "184.79",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "20",
            "hts_kor_isnm": "컴퍼니케이",
            "mksc_shrn_iscd": "307930",
            "stck_prpr": "8030",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.74",
            "acml_vol": "209397",
            "cptl_op_prfi": "40.84",
            "cptl_ntin_rate": "7.52",
            "sale_totl_rate": "71.06",
            "sale_ntin_rate": "40.84",
            "bis": "89.16",
            "lblt_rate": "12.16",
            "bram_depn": "6.37",
            "rsrv_rate": "692.91",
            "grs": "-42.27",
            "op_prfi_inrt": "-71.04",
            "bsop_prfi_inrt": "-70.37",
            "ntin_inrt": "-65.74",
            "equt_inrt": "3.96",
            "cptl_tnrt": "0.21",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "1.62",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "21",
            "hts_kor_isnm": "피에스케이홀딩스",
            "mksc_shrn_iscd": "031980",
            "stck_prpr": "41050",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "72338",
            "cptl_op_prfi": "39.98",
            "cptl_ntin_rate": "8.26",
            "sale_totl_rate": "58.99",
            "sale_ntin_rate": "39.98",
            "bis": "84.33",
            "lblt_rate": "18.58",
            "bram_depn": "5.18",
            "rsrv_rate": "2906.96",
            "grs": "33.25",
            "op_prfi_inrt": "-0.40",
            "bsop_prfi_inrt": "81.06",
            "ntin_inrt": "-5.79",
            "equt_inrt": "20.21",
            "cptl_tnrt": "0.24",
            "sale_bond_tnrt": "8.37",
            "totl_aset_inrt": "15.97",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "22",
            "hts_kor_isnm": "린드먼아시아",
            "mksc_shrn_iscd": "277070",
            "stck_prpr": "5920",
            "prdy_vrss": "-110",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.82",
            "acml_vol": "10616",
            "cptl_op_prfi": "39.24",
            "cptl_ntin_rate": "3.86",
            "sale_totl_rate": "88.54",
            "sale_ntin_rate": "39.24",
            "bis": "85.69",
            "lblt_rate": "16.70",
            "bram_depn": "0.00",
            "rsrv_rate": "778.36",
            "grs": "-38.51",
            "op_prfi_inrt": "-55.32",
            "bsop_prfi_inrt": "-56.61",
            "ntin_inrt": "-51.01",
            "equt_inrt": "1.44",
            "cptl_tnrt": "0.12",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "0.79",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "23",
            "hts_kor_isnm": "인포바인",
            "mksc_shrn_iscd": "115310",
            "stck_prpr": "22150",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.89",
            "acml_vol": "631",
            "cptl_op_prfi": "38.66",
            "cptl_ntin_rate": "7.68",
            "sale_totl_rate": "100.00",
            "sale_ntin_rate": "38.66",
            "bis": "92.45",
            "lblt_rate": "8.17",
            "bram_depn": "0.00",
            "rsrv_rate": "8316.36",
            "grs": "8.90",
            "op_prfi_inrt": "25.12",
            "bsop_prfi_inrt": "14.40",
            "ntin_inrt": "25.51",
            "equt_inrt": "7.80",
            "cptl_tnrt": "0.21",
            "sale_bond_tnrt": "6.74",
            "totl_aset_inrt": "7.94",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "24",
            "hts_kor_isnm": "제놀루션",
            "mksc_shrn_iscd": "225220",
            "stck_prpr": "3865",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.26",
            "acml_vol": "8931",
            "cptl_op_prfi": "38.34",
            "cptl_ntin_rate": "13.95",
            "sale_totl_rate": "69.20",
            "sale_ntin_rate": "38.34",
            "bis": "82.74",
            "lblt_rate": "20.86",
            "bram_depn": "14.75",
            "rsrv_rate": "2070.62",
            "grs": "-47.71",
            "op_prfi_inrt": "-60.40",
            "bsop_prfi_inrt": "-64.30",
            "ntin_inrt": "-57.55",
            "equt_inrt": "15.20",
            "cptl_tnrt": "0.43",
            "sale_bond_tnrt": "7.55",
            "totl_aset_inrt": "20.55",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "25",
            "hts_kor_isnm": "스틱인베스트먼트",
            "mksc_shrn_iscd": "026890",
            "stck_prpr": "7310",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.14",
            "acml_vol": "42011",
            "cptl_op_prfi": "37.72",
            "cptl_ntin_rate": "9.19",
            "sale_totl_rate": "95.87",
            "sale_ntin_rate": "37.72",
            "bis": "92.91",
            "lblt_rate": "7.63",
            "bram_depn": "0.00",
            "rsrv_rate": "1156.76",
            "grs": "-5.22",
            "op_prfi_inrt": "65.18",
            "bsop_prfi_inrt": "38.47",
            "ntin_inrt": "-6.51",
            "equt_inrt": "3.14",
            "cptl_tnrt": "0.26",
            "sale_bond_tnrt": "0.00",
            "totl_aset_inrt": "-0.15",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "26",
            "hts_kor_isnm": "SG&G",
            "mksc_shrn_iscd": "040610",
            "stck_prpr": "1690",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.59",
            "acml_vol": "78652",
            "cptl_op_prfi": "37.65",
            "cptl_ntin_rate": "3.79",
            "sale_totl_rate": "10.17",
            "sale_ntin_rate": "37.65",
            "bis": "83.63",
            "lblt_rate": "19.57",
            "bram_depn": "10.94",
            "rsrv_rate": "1802.44",
            "grs": "-9.37",
            "op_prfi_inrt": "-26.36",
            "bsop_prfi_inrt": "-21.22",
            "ntin_inrt": "-17.25",
            "equt_inrt": "10.68",
            "cptl_tnrt": "0.12",
            "sale_bond_tnrt": "6.31",
            "totl_aset_inrt": "1.69",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "27",
            "hts_kor_isnm": "선바이오",
            "mksc_shrn_iscd": "067370",
            "stck_prpr": "8860",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.11",
            "acml_vol": "9474",
            "cptl_op_prfi": "37.48",
            "cptl_ntin_rate": "10.17",
            "sale_totl_rate": "70.26",
            "sale_ntin_rate": "37.48",
            "bis": "58.97",
            "lblt_rate": "69.59",
            "bram_depn": "34.57",
            "rsrv_rate": "360.22",
            "grs": "65.65",
            "op_prfi_inrt": "492.04",
            "bsop_prfi_inrt": "2619.78",
            "ntin_inrt": "429.92",
            "equt_inrt": "17.90",
            "cptl_tnrt": "0.47",
            "sale_bond_tnrt": "2.98",
            "totl_aset_inrt": "11.11",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "28",
            "hts_kor_isnm": "넥스틴",
            "mksc_shrn_iscd": "348210",
            "stck_prpr": "71400",
            "prdy_vrss": "600",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.85",
            "acml_vol": "20944",
            "cptl_op_prfi": "37.13",
            "cptl_ntin_rate": "25.40",
            "sale_totl_rate": "70.61",
            "sale_ntin_rate": "37.13",
            "bis": "83.18",
            "lblt_rate": "20.21",
            "bram_depn": "1.18",
            "rsrv_rate": "2409.86",
            "grs": "-26.81",
            "op_prfi_inrt": "-38.52",
            "bsop_prfi_inrt": "-37.71",
            "ntin_inrt": "-36.78",
            "equt_inrt": "26.57",
            "cptl_tnrt": "0.83",
            "sale_bond_tnrt": "8.40",
            "totl_aset_inrt": "18.22",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "29",
            "hts_kor_isnm": "인지소프트",
            "mksc_shrn_iscd": "100030",
            "stck_prpr": "18730",
            "prdy_vrss": "-170",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.90",
            "acml_vol": "264",
            "cptl_op_prfi": "36.63",
            "cptl_ntin_rate": "13.91",
            "sale_totl_rate": "41.78",
            "sale_ntin_rate": "36.63",
            "bis": "86.72",
            "lblt_rate": "15.32",
            "bram_depn": "2.89",
            "rsrv_rate": "3548.32",
            "grs": "6.75",
            "op_prfi_inrt": "-38.13",
            "bsop_prfi_inrt": "-21.98",
            "ntin_inrt": "-38.07",
            "equt_inrt": "-5.06",
            "cptl_tnrt": "0.45",
            "sale_bond_tnrt": "17.55",
            "totl_aset_inrt": "-7.15",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        },
        {
            "data_rank": "30",
            "hts_kor_isnm": "티케이케미칼",
            "mksc_shrn_iscd": "104480",
            "stck_prpr": "1685",
            "prdy_vrss": "3",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.18",
            "acml_vol": "26105",
            "cptl_op_prfi": "36.53",
            "cptl_ntin_rate": "21.33",
            "sale_totl_rate": "4.15",
            "sale_ntin_rate": "36.53",
            "bis": "66.22",
            "lblt_rate": "51.01",
            "bram_depn": "16.52",
            "rsrv_rate": "1985.76",
            "grs": "8.57",
            "op_prfi_inrt": "-25.90",
            "bsop_prfi_inrt": "-99.28",
            "ntin_inrt": "-21.55",
            "equt_inrt": "41.94",
            "cptl_tnrt": "0.93",
            "sale_bond_tnrt": "13.54",
            "totl_aset_inrt": "24.61",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1283"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시간외잔량 순위[v1_국내주식-093]

REST

국내주식 시간외잔량 순위[v1_국내주식-093]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/after-hour-balance
  • Format
     
  • Content-Type
     

개요

국내주식 시간외잔량 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0176] 시간외잔량 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01760000
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_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20176 )
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 1: 장전 시간외, 2: 장후 시간외, 3:매도잔량, 4:매수잔량
fid_div_cls_code 분류 구분 코드 String Y 2 0 : 전체
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체
fid_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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_shrn_iscd 주식 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-ovtm_total_askp_rsqn 시간외 총 매도호가 잔량 String Y 12
-ovtm_total_bidp_rsqn 시간외 총 매수호가 잔량 String Y 12
-mkob_otcp_vol 장개시전 시간외종가 거래량 String Y 18
-mkfa_otcp_vol 장종료후 시간외종가 거래량 String Y 18

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20176",
"fid_rank_sort_cls_code":"1",
"fid_div_cls_code":"0",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0"
"fid_trgt_exls_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
}

Response

{
    "output": [
        {
            "stck_shrn_iscd": "252670",
            "data_rank": "1",
            "hts_kor_isnm": "KODEX 200선물인버스2X",
            "stck_prpr": "2170",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.46",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "451685",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "255220",
            "data_rank": "2",
            "hts_kor_isnm": "SG",
            "stck_prpr": "2565",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-7.23",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "216921",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "001470",
            "data_rank": "3",
            "hts_kor_isnm": "삼부토건",
            "stck_prpr": "2535",
            "prdy_vrss": "-155",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-5.76",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "77285",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "253590",
            "data_rank": "4",
            "hts_kor_isnm": "네오셈",
            "stck_prpr": "15850",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.25",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "45191",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "065450",
            "data_rank": "5",
            "hts_kor_isnm": "빅텍",
            "stck_prpr": "5180",
            "prdy_vrss": "80",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.57",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "39634",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "001780",
            "data_rank": "6",
            "hts_kor_isnm": "알루코",
            "stck_prpr": "3580",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.83",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "36447",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "043100",
            "data_rank": "7",
            "hts_kor_isnm": "솔고바이오",
            "stck_prpr": "524",
            "prdy_vrss": "-9",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.69",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "33361",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "109610",
            "data_rank": "8",
            "hts_kor_isnm": "에스와이",
            "stck_prpr": "4700",
            "prdy_vrss": "-145",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.99",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "32283",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "012170",
            "data_rank": "9",
            "hts_kor_isnm": "아센디오",
            "stck_prpr": "1071",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.47",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "27599",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "033170",
            "data_rank": "10",
            "hts_kor_isnm": "시그네틱스",
            "stck_prpr": "1998",
            "prdy_vrss": "123",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.56",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "22443",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "114800",
            "data_rank": "11",
            "hts_kor_isnm": "KODEX 인버스",
            "stck_prpr": "4265",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.23",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "21052",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "032800",
            "data_rank": "12",
            "hts_kor_isnm": "판타지오",
            "stck_prpr": "398",
            "prdy_vrss": "67",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "20.24",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "16326",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "317850",
            "data_rank": "13",
            "hts_kor_isnm": "대모",
            "stck_prpr": "9430",
            "prdy_vrss": "-230",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.38",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "15514",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "357250",
            "data_rank": "14",
            "hts_kor_isnm": "미래에셋맵스리츠",
            "stck_prpr": "3260",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.61",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "12500",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "066790",
            "data_rank": "15",
            "hts_kor_isnm": "씨씨에스",
            "stck_prpr": "5450",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "10989",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "039980",
            "data_rank": "16",
            "hts_kor_isnm": "폴라리스AI",
            "stck_prpr": "2690",
            "prdy_vrss": "-55",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.00",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "10086",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "162300",
            "data_rank": "17",
            "hts_kor_isnm": "신스틸",
            "stck_prpr": "3795",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.81",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "9970",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "007460",
            "data_rank": "18",
            "hts_kor_isnm": "에이프로젠",
            "stck_prpr": "1079",
            "prdy_vrss": "7",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.65",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "9859",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "033230",
            "data_rank": "19",
            "hts_kor_isnm": "인성정보",
            "stck_prpr": "4465",
            "prdy_vrss": "15",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.34",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "9773",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "251340",
            "data_rank": "20",
            "hts_kor_isnm": "KODEX 코스닥150선물인버스",
            "stck_prpr": "3315",
            "prdy_vrss": "-65",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.92",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "9049",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "232140",
            "data_rank": "21",
            "hts_kor_isnm": "와이아이케이",
            "stck_prpr": "7300",
            "prdy_vrss": "80",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.11",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "8832",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "219550",
            "data_rank": "22",
            "hts_kor_isnm": "디와이디",
            "stck_prpr": "1014",
            "prdy_vrss": "-19",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.84",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "8557",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "032680",
            "data_rank": "23",
            "hts_kor_isnm": "소프트센",
            "stck_prpr": "732",
            "prdy_vrss": "-5",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.68",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "8371",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "256840",
            "data_rank": "24",
            "hts_kor_isnm": "한국비엔씨",
            "stck_prpr": "7240",
            "prdy_vrss": "90",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.26",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "7590",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "112040",
            "data_rank": "25",
            "hts_kor_isnm": "위메이드",
            "stck_prpr": "60800",
            "prdy_vrss": "4600",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.19",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "7258",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "357430",
            "data_rank": "26",
            "hts_kor_isnm": "마스턴프리미어리츠",
            "stck_prpr": "3045",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.33",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "6870",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "264850",
            "data_rank": "27",
            "hts_kor_isnm": "이랜시스",
            "stck_prpr": "7650",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.13",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "6177",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "113810",
            "data_rank": "28",
            "hts_kor_isnm": "디젠스",
            "stck_prpr": "1033",
            "prdy_vrss": "3",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.29",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "5874",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "001440",
            "data_rank": "29",
            "hts_kor_isnm": "대한전선",
            "stck_prpr": "11080",
            "prdy_vrss": "980",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.70",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "5792",
            "mkfa_otcp_vol": "0"
        },
        {
            "stck_shrn_iscd": "418620",
            "data_rank": "30",
            "hts_kor_isnm": "이에이트",
            "stck_prpr": "23000",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "ovtm_total_askp_rsqn": "0",
            "ovtm_total_bidp_rsqn": "0",
            "mkob_otcp_vol": "5486",
            "mkfa_otcp_vol": "0"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 우선주/괴리율 상위[v1_국내주식-094]

REST

국내주식 우선주/괴리율 상위[v1_국내주식-094]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/prefer-disparate-ratio
  • Format
     
  • Content-Type
     

개요

국내주식 우선주/괴리율 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0177] 우선주/괴리율 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01770000
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_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20177 )
fid_div_cls_code 분류 구분 코드 String Y 2 0: 전체
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 10
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 10
-acml_vol 누적 거래량 String Y 10
-prst_iscd 우선주 종목코드 String Y 10
-prst_kor_isnm 우선주 한글 종목명 String Y 10
-prst_prpr 우선주 현재가 String Y 10
-prst_prdy_vrss 우선주 전일대비 String Y 10
-prst_prdy_vrss_sign 우선주 전일 대비 부호 String Y 10
-prst_acml_vol 우선주 누적 거래량 String Y 40
-diff_prpr 차이 현재가 String Y 10
-dprt 괴리율 String Y 10
-prdy_ctrt 전일 대비율 String Y 1
-prst_prdy_ctrt 우선주 전일 대비율 String Y 82

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20177",
"fid_div_cls_code":"0",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0"
"fid_trgt_exls_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
}

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "336370",
            "data_rank": "1",
            "hts_kor_isnm": "솔루스첨단소재",
            "stck_prpr": "13610",
            "prdy_vrss": "210",
            "prdy_vrss_sign": "2",
            "acml_vol": "108604",
            "prst_iscd": "A33637K",
            "prst_kor_isnm": "솔루스첨단소재1우",
            "prst_prpr": "2890",
            "prst_prdy_vrss": "30",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "8203",
            "diff_prpr": "10720",
            "dprt": "78.77",
            "prdy_ctrt": "1.57",
            "prst_prdy_ctrt": "1.05"
        },
        {
            "mksc_shrn_iscd": "336260",
            "data_rank": "2",
            "hts_kor_isnm": "두산퓨얼셀",
            "stck_prpr": "20300",
            "prdy_vrss": "510",
            "prdy_vrss_sign": "2",
            "acml_vol": "186883",
            "prst_iscd": "A33626K",
            "prst_kor_isnm": "두산퓨얼셀1우",
            "prst_prpr": "6140",
            "prst_prdy_vrss": "40",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "4656",
            "diff_prpr": "14160",
            "dprt": "69.75",
            "prdy_ctrt": "2.58",
            "prst_prdy_ctrt": "0.66"
        },
        {
            "mksc_shrn_iscd": "090430",
            "data_rank": "3",
            "hts_kor_isnm": "아모레퍼시픽",
            "stck_prpr": "113000",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "acml_vol": "28537",
            "prst_iscd": "A090435",
            "prst_kor_isnm": "아모레퍼시픽우",
            "prst_prpr": "34900",
            "prst_prdy_vrss": "900",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "4561",
            "diff_prpr": "78100",
            "dprt": "69.12",
            "prdy_ctrt": "-0.09",
            "prst_prdy_ctrt": "2.65"
        },
        {
            "mksc_shrn_iscd": "336370",
            "data_rank": "4",
            "hts_kor_isnm": "솔루스첨단소재",
            "stck_prpr": "13610",
            "prdy_vrss": "210",
            "prdy_vrss_sign": "2",
            "acml_vol": "108604",
            "prst_iscd": "A33637L",
            "prst_kor_isnm": "솔루스첨단소재2우B",
            "prst_prpr": "4825",
            "prst_prdy_vrss": "40",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "8216",
            "diff_prpr": "8785",
            "dprt": "64.55",
            "prdy_ctrt": "1.57",
            "prst_prdy_ctrt": "0.84"
        },
        {
            "mksc_shrn_iscd": "007810",
            "data_rank": "5",
            "hts_kor_isnm": "코리아써키트",
            "stck_prpr": "18580",
            "prdy_vrss": "340",
            "prdy_vrss_sign": "2",
            "acml_vol": "89546",
            "prst_iscd": "A007815",
            "prst_kor_isnm": "코리아써우",
            "prst_prpr": "6610",
            "prst_prdy_vrss": "0",
            "prst_prdy_vrss_sign": "3",
            "prst_acml_vol": "2062",
            "diff_prpr": "11970",
            "dprt": "64.42",
            "prdy_ctrt": "1.86",
            "prst_prdy_ctrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "002790",
            "data_rank": "6",
            "hts_kor_isnm": "아모레G",
            "stck_prpr": "26050",
            "prdy_vrss": "100",
            "prdy_vrss_sign": "2",
            "acml_vol": "25297",
            "prst_iscd": "A002795",
            "prst_kor_isnm": "아모레G우",
            "prst_prpr": "9780",
            "prst_prdy_vrss": "-30",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "1796",
            "diff_prpr": "16270",
            "dprt": "62.46",
            "prdy_ctrt": "0.39",
            "prst_prdy_ctrt": "-0.31"
        },
        {
            "mksc_shrn_iscd": "001460",
            "data_rank": "7",
            "hts_kor_isnm": "BYC",
            "stck_prpr": "481000",
            "prdy_vrss": "3000",
            "prdy_vrss_sign": "2",
            "acml_vol": "89",
            "prst_iscd": "A001465",
            "prst_kor_isnm": "BYC우",
            "prst_prpr": "182500",
            "prst_prdy_vrss": "2700",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "169",
            "diff_prpr": "298500",
            "dprt": "62.06",
            "prdy_ctrt": "0.63",
            "prst_prdy_ctrt": "1.50"
        },
        {
            "mksc_shrn_iscd": "007810",
            "data_rank": "8",
            "hts_kor_isnm": "코리아써키트",
            "stck_prpr": "18580",
            "prdy_vrss": "340",
            "prdy_vrss_sign": "2",
            "acml_vol": "89546",
            "prst_iscd": "A00781K",
            "prst_kor_isnm": "코리아써키트2우B",
            "prst_prpr": "7110",
            "prst_prdy_vrss": "-80",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "477",
            "diff_prpr": "11470",
            "dprt": "61.73",
            "prdy_ctrt": "1.86",
            "prst_prdy_ctrt": "-1.11"
        },
        {
            "mksc_shrn_iscd": "002350",
            "data_rank": "9",
            "hts_kor_isnm": "넥센타이어",
            "stck_prpr": "8170",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "acml_vol": "18622",
            "prst_iscd": "A002355",
            "prst_kor_isnm": "넥센타이어1우B",
            "prst_prpr": "3240",
            "prst_prdy_vrss": "-10",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "671",
            "diff_prpr": "4930",
            "dprt": "60.34",
            "prdy_ctrt": "-1.21",
            "prst_prdy_ctrt": "-0.31"
        },
        {
            "mksc_shrn_iscd": "353200",
            "data_rank": "10",
            "hts_kor_isnm": "대덕전자",
            "stck_prpr": "22750",
            "prdy_vrss": "-150",
            "prdy_vrss_sign": "5",
            "acml_vol": "94610",
            "prst_iscd": "A35320K",
            "prst_kor_isnm": "대덕전자1우",
            "prst_prpr": "9400",
            "prst_prdy_vrss": "-80",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "2310",
            "diff_prpr": "13350",
            "dprt": "58.68",
            "prdy_ctrt": "-0.66",
            "prst_prdy_ctrt": "-0.84"
        },
        {
            "mksc_shrn_iscd": "336260",
            "data_rank": "11",
            "hts_kor_isnm": "두산퓨얼셀",
            "stck_prpr": "20300",
            "prdy_vrss": "510",
            "prdy_vrss_sign": "2",
            "acml_vol": "186883",
            "prst_iscd": "A33626L",
            "prst_kor_isnm": "두산퓨얼셀2우B",
            "prst_prpr": "8450",
            "prst_prdy_vrss": "80",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "1058",
            "diff_prpr": "11850",
            "dprt": "58.37",
            "prdy_ctrt": "2.58",
            "prst_prdy_ctrt": "0.96"
        },
        {
            "mksc_shrn_iscd": "285130",
            "data_rank": "12",
            "hts_kor_isnm": "SK케미칼",
            "stck_prpr": "65200",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "acml_vol": "6644",
            "prst_iscd": "A28513K",
            "prst_kor_isnm": "SK케미칼우",
            "prst_prpr": "28300",
            "prst_prdy_vrss": "0",
            "prst_prdy_vrss_sign": "3",
            "prst_acml_vol": "497",
            "diff_prpr": "36900",
            "dprt": "56.60",
            "prdy_ctrt": "0.00",
            "prst_prdy_ctrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "051900",
            "data_rank": "13",
            "hts_kor_isnm": "LG생활건강",
            "stck_prpr": "353500",
            "prdy_vrss": "8000",
            "prdy_vrss_sign": "2",
            "acml_vol": "34567",
            "prst_iscd": "A051905",
            "prst_kor_isnm": "LG생활건강우",
            "prst_prpr": "153700",
            "prst_prdy_vrss": "1700",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "1066",
            "diff_prpr": "199800",
            "dprt": "56.52",
            "prdy_ctrt": "2.32",
            "prst_prdy_ctrt": "1.12"
        },
        {
            "mksc_shrn_iscd": "180640",
            "data_rank": "14",
            "hts_kor_isnm": "한진칼",
            "stck_prpr": "59500",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "acml_vol": "47348",
            "prst_iscd": "A18064K",
            "prst_kor_isnm": "한진칼우",
            "prst_prpr": "25900",
            "prst_prdy_vrss": "250",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "229",
            "diff_prpr": "33600",
            "dprt": "56.47",
            "prdy_ctrt": "0.68",
            "prst_prdy_ctrt": "0.97"
        },
        {
            "mksc_shrn_iscd": "066570",
            "data_rank": "15",
            "hts_kor_isnm": "LG전자",
            "stck_prpr": "97600",
            "prdy_vrss": "-1300",
            "prdy_vrss_sign": "5",
            "acml_vol": "149144",
            "prst_iscd": "A066575",
            "prst_kor_isnm": "LG전자우",
            "prst_prpr": "43600",
            "prst_prdy_vrss": "-300",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "9737",
            "diff_prpr": "54000",
            "dprt": "55.33",
            "prdy_ctrt": "-1.31",
            "prst_prdy_ctrt": "-0.68"
        },
        {
            "mksc_shrn_iscd": "000150",
            "data_rank": "16",
            "hts_kor_isnm": "두산",
            "stck_prpr": "150700",
            "prdy_vrss": "5700",
            "prdy_vrss_sign": "2",
            "acml_vol": "203379",
            "prst_iscd": "A000155",
            "prst_kor_isnm": "두산우",
            "prst_prpr": "69600",
            "prst_prdy_vrss": "4700",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "46666",
            "diff_prpr": "81100",
            "dprt": "53.82",
            "prdy_ctrt": "3.93",
            "prst_prdy_ctrt": "7.24"
        },
        {
            "mksc_shrn_iscd": "097950",
            "data_rank": "17",
            "hts_kor_isnm": "CJ제일제당",
            "stck_prpr": "290500",
            "prdy_vrss": "3000",
            "prdy_vrss_sign": "2",
            "acml_vol": "6350",
            "prst_iscd": "A097955",
            "prst_kor_isnm": "CJ제일제당 우",
            "prst_prpr": "134600",
            "prst_prdy_vrss": "700",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "743",
            "diff_prpr": "155900",
            "dprt": "53.67",
            "prdy_ctrt": "1.04",
            "prst_prdy_ctrt": "0.52"
        },
        {
            "mksc_shrn_iscd": "006800",
            "data_rank": "18",
            "hts_kor_isnm": "미래에셋증권",
            "stck_prpr": "8080",
            "prdy_vrss": "60",
            "prdy_vrss_sign": "2",
            "acml_vol": "149300",
            "prst_iscd": "A00680K",
            "prst_kor_isnm": "미래에셋증권2우B",
            "prst_prpr": "3845",
            "prst_prdy_vrss": "15",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "74992",
            "diff_prpr": "4235",
            "dprt": "52.41",
            "prdy_ctrt": "0.75",
            "prst_prdy_ctrt": "0.39"
        },
        {
            "mksc_shrn_iscd": "009150",
            "data_rank": "19",
            "hts_kor_isnm": "삼성전기",
            "stck_prpr": "143800",
            "prdy_vrss": "-1800",
            "prdy_vrss_sign": "5",
            "acml_vol": "225844",
            "prst_iscd": "A009155",
            "prst_kor_isnm": "삼성전기우",
            "prst_prpr": "70300",
            "prst_prdy_vrss": "-500",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "1722",
            "diff_prpr": "73500",
            "dprt": "51.11",
            "prdy_ctrt": "-1.24",
            "prst_prdy_ctrt": "-0.71"
        },
        {
            "mksc_shrn_iscd": "011780",
            "data_rank": "20",
            "hts_kor_isnm": "금호석유",
            "stck_prpr": "138000",
            "prdy_vrss": "-1700",
            "prdy_vrss_sign": "5",
            "acml_vol": "19759",
            "prst_iscd": "A011785",
            "prst_kor_isnm": "금호석유우",
            "prst_prpr": "69100",
            "prst_prdy_vrss": "-700",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "793",
            "diff_prpr": "68900",
            "dprt": "49.93",
            "prdy_ctrt": "-1.22",
            "prst_prdy_ctrt": "-1.00"
        },
        {
            "mksc_shrn_iscd": "375500",
            "data_rank": "21",
            "hts_kor_isnm": "DL이앤씨",
            "stck_prpr": "35000",
            "prdy_vrss": "150",
            "prdy_vrss_sign": "2",
            "acml_vol": "34365",
            "prst_iscd": "A37550K",
            "prst_kor_isnm": "DL이앤씨우",
            "prst_prpr": "17920",
            "prst_prdy_vrss": "-350",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "1575",
            "diff_prpr": "17080",
            "dprt": "48.80",
            "prdy_ctrt": "0.43",
            "prst_prdy_ctrt": "-1.92"
        },
        {
            "mksc_shrn_iscd": "000880",
            "data_rank": "22",
            "hts_kor_isnm": "한화",
            "stck_prpr": "28650",
            "prdy_vrss": "700",
            "prdy_vrss_sign": "2",
            "acml_vol": "135191",
            "prst_iscd": "A00088K",
            "prst_kor_isnm": "한화3우B",
            "prst_prpr": "15050",
            "prst_prdy_vrss": "110",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "9206",
            "diff_prpr": "13600",
            "dprt": "47.47",
            "prdy_ctrt": "2.50",
            "prst_prdy_ctrt": "0.74"
        },
        {
            "mksc_shrn_iscd": "108670",
            "data_rank": "23",
            "hts_kor_isnm": "LX하우시스",
            "stck_prpr": "39200",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "acml_vol": "4608",
            "prst_iscd": "A108675",
            "prst_kor_isnm": "LX하우시스우",
            "prst_prpr": "20600",
            "prst_prdy_vrss": "-300",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "555",
            "diff_prpr": "18600",
            "dprt": "47.45",
            "prdy_ctrt": "-0.13",
            "prst_prdy_ctrt": "-1.44"
        },
        {
            "mksc_shrn_iscd": "006800",
            "data_rank": "24",
            "hts_kor_isnm": "미래에셋증권",
            "stck_prpr": "8080",
            "prdy_vrss": "60",
            "prdy_vrss_sign": "2",
            "acml_vol": "149300",
            "prst_iscd": "A006805",
            "prst_kor_isnm": "미래에셋증권우",
            "prst_prpr": "4300",
            "prst_prdy_vrss": "-60",
            "prst_prdy_vrss_sign": "5",
            "prst_acml_vol": "18334",
            "diff_prpr": "3780",
            "dprt": "46.78",
            "prdy_ctrt": "0.75",
            "prst_prdy_ctrt": "-1.38"
        },
        {
            "mksc_shrn_iscd": "000210",
            "data_rank": "25",
            "hts_kor_isnm": "DL",
            "stck_prpr": "46400",
            "prdy_vrss": "1550",
            "prdy_vrss_sign": "2",
            "acml_vol": "39343",
            "prst_iscd": "A000215",
            "prst_kor_isnm": "DL우",
            "prst_prpr": "24900",
            "prst_prdy_vrss": "250",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "147",
            "diff_prpr": "21500",
            "dprt": "46.34",
            "prdy_ctrt": "3.46",
            "prst_prdy_ctrt": "1.01"
        },
        {
            "mksc_shrn_iscd": "000150",
            "data_rank": "26",
            "hts_kor_isnm": "두산",
            "stck_prpr": "150700",
            "prdy_vrss": "5700",
            "prdy_vrss_sign": "2",
            "acml_vol": "203379",
            "prst_iscd": "A000157",
            "prst_kor_isnm": "두산2우B",
            "prst_prpr": "81400",
            "prst_prdy_vrss": "2800",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "2430",
            "diff_prpr": "69300",
            "dprt": "45.99",
            "prdy_ctrt": "3.93",
            "prst_prdy_ctrt": "3.56"
        },
        {
            "mksc_shrn_iscd": "001040",
            "data_rank": "27",
            "hts_kor_isnm": "CJ",
            "stck_prpr": "110600",
            "prdy_vrss": "1400",
            "prdy_vrss_sign": "2",
            "acml_vol": "229827",
            "prst_iscd": "A001045",
            "prst_kor_isnm": "CJ우",
            "prst_prpr": "59800",
            "prst_prdy_vrss": "0",
            "prst_prdy_vrss_sign": "3",
            "prst_acml_vol": "2681",
            "diff_prpr": "50800",
            "dprt": "45.93",
            "prdy_ctrt": "1.28",
            "prst_prdy_ctrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "005300",
            "data_rank": "28",
            "hts_kor_isnm": "롯데칠성",
            "stck_prpr": "126500",
            "prdy_vrss": "300",
            "prdy_vrss_sign": "2",
            "acml_vol": "3080",
            "prst_iscd": "A005305",
            "prst_kor_isnm": "롯데칠성우",
            "prst_prpr": "68400",
            "prst_prdy_vrss": "300",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "267",
            "diff_prpr": "58100",
            "dprt": "45.93",
            "prdy_ctrt": "0.24",
            "prst_prdy_ctrt": "0.44"
        },
        {
            "mksc_shrn_iscd": "014820",
            "data_rank": "29",
            "hts_kor_isnm": "동원시스템즈",
            "stck_prpr": "46200",
            "prdy_vrss": "3150",
            "prdy_vrss_sign": "2",
            "acml_vol": "224535",
            "prst_iscd": "A014825",
            "prst_kor_isnm": "동원시스템즈우",
            "prst_prpr": "25200",
            "prst_prdy_vrss": "1250",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "456",
            "diff_prpr": "21000",
            "dprt": "45.45",
            "prdy_ctrt": "7.32",
            "prst_prdy_ctrt": "5.22"
        },
        {
            "mksc_shrn_iscd": "006400",
            "data_rank": "30",
            "hts_kor_isnm": "삼성SDI",
            "stck_prpr": "438000",
            "prdy_vrss": "13000",
            "prdy_vrss_sign": "2",
            "acml_vol": "236248",
            "prst_iscd": "A006405",
            "prst_kor_isnm": "삼성SDI우",
            "prst_prpr": "245500",
            "prst_prdy_vrss": "2500",
            "prst_prdy_vrss_sign": "2",
            "prst_acml_vol": "1166",
            "diff_prpr": "192500",
            "dprt": "43.95",
            "prdy_ctrt": "3.06",
            "prst_prdy_ctrt": "1.03"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 호가잔량 순위[국내주식-089]

REST

국내주식 호가잔량 순위[국내주식-089]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/quote-balance
  • Format
     
  • Content-Type
     

개요

국내주식 호가잔량 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0172] 호가잔량 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01720000
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_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20172 )
fid_input_iscd 입력 종목코드 String Y 12 0000(전체) 코스피(0001), 코스닥(1001), 코스피200(2001)
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0: 순매수잔량순, 1:순매도잔량순, 2:매수비율순, 3:매도비율순
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체
fid_trgt_cls_code 대상 구분 코드 String Y 32 0:전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0:전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-total_askp_rsqn 총 매도호가 잔량 String Y 12
-total_bidp_rsqn 총 매수호가 잔량 String Y 12
-total_ntsl_bidp_rsqn 총 순 매수호가 잔량 String Y 12
-shnu_rsqn_rate 매수 잔량 비율 String Y 84
-seln_rsqn_rate 매도 잔량 비율 String Y 84

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20172",
"fid_input_iscd":"0000",
"fid_rank_sort_cls_code":"0",
"fid_div_cls_code":"0",
"fid_trgt_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":""
}

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "Q530036",
            "data_rank": "1",
            "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
            "stck_prpr": "92",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "4019460",
            "total_askp_rsqn": "27327397",
            "total_bidp_rsqn": "59778444",
            "total_ntsl_bidp_rsqn": "32451047",
            "shnu_rsqn_rate": "68.63",
            "seln_rsqn_rate": "31.37"
        },
        {
            "mksc_shrn_iscd": "003410",
            "data_rank": "2",
            "hts_kor_isnm": "쌍용C&E",
            "stck_prpr": "7000",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "83785",
            "total_askp_rsqn": "238068",
            "total_bidp_rsqn": "22904795",
            "total_ntsl_bidp_rsqn": "22666727",
            "shnu_rsqn_rate": "98.97",
            "seln_rsqn_rate": "1.03"
        },
        {
            "mksc_shrn_iscd": "252670",
            "data_rank": "3",
            "hts_kor_isnm": "KODEX 200선물인버스2X",
            "stck_prpr": "2180",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "45344920",
            "total_askp_rsqn": "16674598",
            "total_bidp_rsqn": "26686853",
            "total_ntsl_bidp_rsqn": "10012255",
            "shnu_rsqn_rate": "61.55",
            "seln_rsqn_rate": "38.45"
        },
        {
            "mksc_shrn_iscd": "114800",
            "data_rank": "4",
            "hts_kor_isnm": "KODEX 인버스",
            "stck_prpr": "4275",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "4988727",
            "total_askp_rsqn": "5715746",
            "total_bidp_rsqn": "9303814",
            "total_ntsl_bidp_rsqn": "3588068",
            "shnu_rsqn_rate": "61.94",
            "seln_rsqn_rate": "38.06"
        },
        {
            "mksc_shrn_iscd": "018000",
            "data_rank": "5",
            "hts_kor_isnm": "유니슨",
            "stck_prpr": "1233",
            "prdy_vrss": "215",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "21.12",
            "acml_vol": "2436474",
            "total_askp_rsqn": "0",
            "total_bidp_rsqn": "2617859",
            "total_ntsl_bidp_rsqn": "2617859",
            "shnu_rsqn_rate": "100.00",
            "seln_rsqn_rate": "0.00"
        },
        {
            "mksc_shrn_iscd": "005930",
            "data_rank": "6",
            "hts_kor_isnm": "삼성전자",
            "stck_prpr": "72800",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.69",
            "acml_vol": "3310579",
            "total_askp_rsqn": "970901",
            "total_bidp_rsqn": "2358190",
            "total_ntsl_bidp_rsqn": "1387289",
            "shnu_rsqn_rate": "70.84",
            "seln_rsqn_rate": "29.16"
        },
        {
            "mksc_shrn_iscd": "251340",
            "data_rank": "7",
            "hts_kor_isnm": "KODEX 코스닥150선물인버스",
            "stck_prpr": "3315",
            "prdy_vrss": "-65",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.92",
            "acml_vol": "20976556",
            "total_askp_rsqn": "5821013",
            "total_bidp_rsqn": "6913597",
            "total_ntsl_bidp_rsqn": "1092584",
            "shnu_rsqn_rate": "54.29",
            "seln_rsqn_rate": "45.71"
        },
        {
            "mksc_shrn_iscd": "Q550074",
            "data_rank": "8",
            "hts_kor_isnm": "QV 블룸버그 2X 천연가스 선물 ETN(H)",
            "stck_prpr": "395",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "381899",
            "total_askp_rsqn": "156122",
            "total_bidp_rsqn": "1037967",
            "total_ntsl_bidp_rsqn": "881845",
            "shnu_rsqn_rate": "86.93",
            "seln_rsqn_rate": "13.07"
        },
        {
            "mksc_shrn_iscd": "Q500027",
            "data_rank": "9",
            "hts_kor_isnm": "신한 인버스 2X WTI원유 선물 ETN(H)",
            "stck_prpr": "81",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "535276",
            "total_askp_rsqn": "45614576",
            "total_bidp_rsqn": "46290045",
            "total_ntsl_bidp_rsqn": "675469",
            "shnu_rsqn_rate": "50.37",
            "seln_rsqn_rate": "49.63"
        },
        {
            "mksc_shrn_iscd": "900110",
            "data_rank": "10",
            "hts_kor_isnm": "이스트아시아홀딩스",
            "stck_prpr": "93",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "680301",
            "total_askp_rsqn": "1831739",
            "total_bidp_rsqn": "2470524",
            "total_ntsl_bidp_rsqn": "638785",
            "shnu_rsqn_rate": "57.42",
            "seln_rsqn_rate": "42.58"
        },
        {
            "mksc_shrn_iscd": "900280",
            "data_rank": "11",
            "hts_kor_isnm": "골든센츄리",
            "stck_prpr": "128",
            "prdy_vrss": "-1",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.78",
            "acml_vol": "742379",
            "total_askp_rsqn": "1028799",
            "total_bidp_rsqn": "1485157",
            "total_ntsl_bidp_rsqn": "456358",
            "shnu_rsqn_rate": "59.08",
            "seln_rsqn_rate": "40.92"
        },
        {
            "mksc_shrn_iscd": "001470",
            "data_rank": "12",
            "hts_kor_isnm": "삼부토건",
            "stck_prpr": "2535",
            "prdy_vrss": "-155",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-5.76",
            "acml_vol": "7133448",
            "total_askp_rsqn": "257260",
            "total_bidp_rsqn": "713292",
            "total_ntsl_bidp_rsqn": "456032",
            "shnu_rsqn_rate": "73.49",
            "seln_rsqn_rate": "26.51"
        },
        {
            "mksc_shrn_iscd": "252710",
            "data_rank": "13",
            "hts_kor_isnm": "TIGER 200선물인버스2X",
            "stck_prpr": "2310",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.22",
            "acml_vol": "1556254",
            "total_askp_rsqn": "314399",
            "total_bidp_rsqn": "757848",
            "total_ntsl_bidp_rsqn": "443449",
            "shnu_rsqn_rate": "70.68",
            "seln_rsqn_rate": "29.32"
        },
        {
            "mksc_shrn_iscd": "010140",
            "data_rank": "14",
            "hts_kor_isnm": "삼성중공업",
            "stck_prpr": "8930",
            "prdy_vrss": "80",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.90",
            "acml_vol": "6043474",
            "total_askp_rsqn": "176430",
            "total_bidp_rsqn": "487408",
            "total_ntsl_bidp_rsqn": "310978",
            "shnu_rsqn_rate": "73.42",
            "seln_rsqn_rate": "26.58"
        },
        {
            "mksc_shrn_iscd": "271050",
            "data_rank": "15",
            "hts_kor_isnm": "KODEX WTI원유선물인버스(H)",
            "stck_prpr": "4190",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.24",
            "acml_vol": "106936",
            "total_askp_rsqn": "201253",
            "total_bidp_rsqn": "458790",
            "total_ntsl_bidp_rsqn": "257537",
            "shnu_rsqn_rate": "69.51",
            "seln_rsqn_rate": "30.49"
        },
        {
            "mksc_shrn_iscd": "453850",
            "data_rank": "16",
            "hts_kor_isnm": "ACE 미국30년국채액티브(H)",
            "stck_prpr": "8540",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.35",
            "acml_vol": "413651",
            "total_askp_rsqn": "394820",
            "total_bidp_rsqn": "641051",
            "total_ntsl_bidp_rsqn": "246231",
            "shnu_rsqn_rate": "61.89",
            "seln_rsqn_rate": "38.11"
        },
        {
            "mksc_shrn_iscd": "031860",
            "data_rank": "17",
            "hts_kor_isnm": "에스유홀딩스",
            "stck_prpr": "200",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.56",
            "acml_vol": "3005608",
            "total_askp_rsqn": "592337",
            "total_bidp_rsqn": "834037",
            "total_ntsl_bidp_rsqn": "241700",
            "shnu_rsqn_rate": "58.47",
            "seln_rsqn_rate": "41.53"
        },
        {
            "mksc_shrn_iscd": "123310",
            "data_rank": "18",
            "hts_kor_isnm": "TIGER 인버스",
            "stck_prpr": "4790",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "61009",
            "total_askp_rsqn": "1040106",
            "total_bidp_rsqn": "1274948",
            "total_ntsl_bidp_rsqn": "234842",
            "shnu_rsqn_rate": "55.07",
            "seln_rsqn_rate": "44.93"
        },
        {
            "mksc_shrn_iscd": "066790",
            "data_rank": "19",
            "hts_kor_isnm": "씨씨에스",
            "stck_prpr": "5460",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.18",
            "acml_vol": "5044542",
            "total_askp_rsqn": "79481",
            "total_bidp_rsqn": "289718",
            "total_ntsl_bidp_rsqn": "210237",
            "shnu_rsqn_rate": "78.47",
            "seln_rsqn_rate": "21.53"
        },
        {
            "mksc_shrn_iscd": "152550",
            "data_rank": "20",
            "hts_kor_isnm": "한국ANKOR유전",
            "stck_prpr": "353",
            "prdy_vrss": "-5",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.40",
            "acml_vol": "439971",
            "total_askp_rsqn": "127722",
            "total_bidp_rsqn": "327363",
            "total_ntsl_bidp_rsqn": "199641",
            "shnu_rsqn_rate": "71.93",
            "seln_rsqn_rate": "28.07"
        },
        {
            "mksc_shrn_iscd": "007460",
            "data_rank": "21",
            "hts_kor_isnm": "에이프로젠",
            "stck_prpr": "1078",
            "prdy_vrss": "6",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.56",
            "acml_vol": "4547618",
            "total_askp_rsqn": "14915",
            "total_bidp_rsqn": "212791",
            "total_ntsl_bidp_rsqn": "197876",
            "shnu_rsqn_rate": "93.45",
            "seln_rsqn_rate": "6.55"
        },
        {
            "mksc_shrn_iscd": "016600",
            "data_rank": "22",
            "hts_kor_isnm": "큐캐피탈",
            "stck_prpr": "324",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "127470",
            "total_askp_rsqn": "56103",
            "total_bidp_rsqn": "251242",
            "total_ntsl_bidp_rsqn": "195139",
            "shnu_rsqn_rate": "81.75",
            "seln_rsqn_rate": "18.25"
        },
        {
            "mksc_shrn_iscd": "261260",
            "data_rank": "23",
            "hts_kor_isnm": "KODEX 미국달러선물인버스2X",
            "stck_prpr": "6350",
            "prdy_vrss": "-40",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.63",
            "acml_vol": "132188",
            "total_askp_rsqn": "208219",
            "total_bidp_rsqn": "394699",
            "total_ntsl_bidp_rsqn": "186480",
            "shnu_rsqn_rate": "65.46",
            "seln_rsqn_rate": "34.54"
        },
        {
            "mksc_shrn_iscd": "032640",
            "data_rank": "24",
            "hts_kor_isnm": "LG유플러스",
            "stck_prpr": "10000",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.60",
            "acml_vol": "208413",
            "total_askp_rsqn": "69973",
            "total_bidp_rsqn": "241811",
            "total_ntsl_bidp_rsqn": "171838",
            "shnu_rsqn_rate": "77.56",
            "seln_rsqn_rate": "22.44"
        },
        {
            "mksc_shrn_iscd": "000890",
            "data_rank": "25",
            "hts_kor_isnm": "보해양조",
            "stck_prpr": "499",
            "prdy_vrss": "-1",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.20",
            "acml_vol": "33688",
            "total_askp_rsqn": "42161",
            "total_bidp_rsqn": "204169",
            "total_ntsl_bidp_rsqn": "162008",
            "shnu_rsqn_rate": "82.88",
            "seln_rsqn_rate": "17.12"
        },
        {
            "mksc_shrn_iscd": "115530",
            "data_rank": "26",
            "hts_kor_isnm": "씨엔플러스",
            "stck_prpr": "345",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "8657778",
            "total_askp_rsqn": "38681",
            "total_bidp_rsqn": "197775",
            "total_ntsl_bidp_rsqn": "159094",
            "shnu_rsqn_rate": "83.64",
            "seln_rsqn_rate": "16.36"
        },
        {
            "mksc_shrn_iscd": "475280",
            "data_rank": "27",
            "hts_kor_isnm": "ACE 8월만기자동연장회사채AA-이상액티브",
            "stck_prpr": "10065",
            "prdy_vrss": "-5",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.05",
            "acml_vol": "1029",
            "total_askp_rsqn": "43999",
            "total_bidp_rsqn": "202972",
            "total_ntsl_bidp_rsqn": "158973",
            "shnu_rsqn_rate": "82.18",
            "seln_rsqn_rate": "17.82"
        },
        {
            "mksc_shrn_iscd": "082660",
            "data_rank": "28",
            "hts_kor_isnm": "코스나인",
            "stck_prpr": "281",
            "prdy_vrss": "1",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.36",
            "acml_vol": "197620",
            "total_askp_rsqn": "68474",
            "total_bidp_rsqn": "220086",
            "total_ntsl_bidp_rsqn": "151612",
            "shnu_rsqn_rate": "76.27",
            "seln_rsqn_rate": "23.73"
        },
        {
            "mksc_shrn_iscd": "365590",
            "data_rank": "29",
            "hts_kor_isnm": "하이딥",
            "stck_prpr": "1419",
            "prdy_vrss": "-4",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.28",
            "acml_vol": "34996",
            "total_askp_rsqn": "2430",
            "total_bidp_rsqn": "150999",
            "total_ntsl_bidp_rsqn": "148569",
            "shnu_rsqn_rate": "98.42",
            "seln_rsqn_rate": "1.58"
        },
        {
            "mksc_shrn_iscd": "000680",
            "data_rank": "30",
            "hts_kor_isnm": "LS네트웍스",
            "stck_prpr": "5400",
            "prdy_vrss": "-240",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-4.26",
            "acml_vol": "6399421",
            "total_askp_rsqn": "103613",
            "total_bidp_rsqn": "248579",
            "total_ntsl_bidp_rsqn": "144966",
            "shnu_rsqn_rate": "70.58",
            "seln_rsqn_rate": "29.42"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 이격도 순위[v1_국내주식-095]

REST

국내주식 이격도 순위[v1_국내주식-095]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/disparity
  • Format
     
  • Content-Type
     

개요

국내주식 이격도 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0178] 이격도 순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01780000
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_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20178 )
fid_div_cls_code 분류 구분 코드 String Y 2 0: 전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보톧주, 7:우선주
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0: 이격도상위순, 1:이격도하위순
fid_hour_cls_code 시간 구분 코드 String Y 5 5:이격도5, 10:이격도10, 20:이격도20, 60:이격도60, 120:이격도120
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-prdy_vrss_sign 전일 대비 부호 String Y 1
-acml_vol 누적 거래량 String Y 18
-d5_dsrt 5일 이격도 String Y 112
-d10_dsrt 10일 이격도 String Y 112
-d20_dsrt 20일 이격도 String Y 112
-d60_dsrt 60일 이격도 String Y 112
-d120_dsrt 120일 이격도 String Y 112

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20178",
"fid_div_cls_code":"0",
"fid_rank_sort_cls_code":"0",
"fid_hour_cls_code":"0000",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":""
}

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "199800",
            "data_rank": "1",
            "hts_kor_isnm": "툴젠",
            "stck_prpr": "76100",
            "prdy_vrss": "17500",
            "prdy_ctrt": "29.86",
            "prdy_vrss_sign": "1",
            "acml_vol": "333421",
            "d5_dsrt": "126.92",
            "d10_dsrt": "137.66",
            "d20_dsrt": "143.04",
            "d60_dsrt": "134.37",
            "d120_dsrt": "146.59"
        },
        {
            "mksc_shrn_iscd": "032800",
            "data_rank": "2",
            "hts_kor_isnm": "판타지오",
            "stck_prpr": "394",
            "prdy_vrss": "63",
            "prdy_ctrt": "19.03",
            "prdy_vrss_sign": "2",
            "acml_vol": "42856944",
            "d5_dsrt": "125.32",
            "d10_dsrt": "154.75",
            "d20_dsrt": "181.27",
            "d60_dsrt": "183.38",
            "d120_dsrt": "169.90"
        },
        {
            "mksc_shrn_iscd": "083790",
            "data_rank": "3",
            "hts_kor_isnm": "CG인바이츠",
            "stck_prpr": "4235",
            "prdy_vrss": "855",
            "prdy_ctrt": "25.30",
            "prdy_vrss_sign": "2",
            "acml_vol": "3067053",
            "d5_dsrt": "123.18",
            "d10_dsrt": "121.02",
            "d20_dsrt": "118.13",
            "d60_dsrt": "138.02",
            "d120_dsrt": "145.73"
        },
        {
            "mksc_shrn_iscd": "237690",
            "data_rank": "4",
            "hts_kor_isnm": "에스티팜",
            "stck_prpr": "96400",
            "prdy_vrss": "18800",
            "prdy_ctrt": "24.23",
            "prdy_vrss_sign": "2",
            "acml_vol": "1694242",
            "d5_dsrt": "121.72",
            "d10_dsrt": "127.83",
            "d20_dsrt": "138.42",
            "d60_dsrt": "147.80",
            "d120_dsrt": "142.70"
        },
        {
            "mksc_shrn_iscd": "010660",
            "data_rank": "5",
            "hts_kor_isnm": "화천기계",
            "stck_prpr": "7250",
            "prdy_vrss": "990",
            "prdy_ctrt": "15.81",
            "prdy_vrss_sign": "2",
            "acml_vol": "10506735",
            "d5_dsrt": "120.59",
            "d10_dsrt": "135.12",
            "d20_dsrt": "149.55",
            "d60_dsrt": "179.64",
            "d120_dsrt": "175.87"
        },
        {
            "mksc_shrn_iscd": "103590",
            "data_rank": "6",
            "hts_kor_isnm": "일진전기",
            "stck_prpr": "17370",
            "prdy_vrss": "2690",
            "prdy_ctrt": "18.32",
            "prdy_vrss_sign": "2",
            "acml_vol": "10956331",
            "d5_dsrt": "119.93",
            "d10_dsrt": "128.02",
            "d20_dsrt": "142.95",
            "d60_dsrt": "149.68",
            "d120_dsrt": "144.38"
        },
        {
            "mksc_shrn_iscd": "276730",
            "data_rank": "7",
            "hts_kor_isnm": "제주맥주",
            "stck_prpr": "1492",
            "prdy_vrss": "148",
            "prdy_ctrt": "11.01",
            "prdy_vrss_sign": "2",
            "acml_vol": "3304408",
            "d5_dsrt": "116.44",
            "d10_dsrt": "127.45",
            "d20_dsrt": "137.72",
            "d60_dsrt": "150.64",
            "d120_dsrt": "147.72"
        },
        {
            "mksc_shrn_iscd": "189330",
            "data_rank": "8",
            "hts_kor_isnm": "씨이랩",
            "stck_prpr": "17130",
            "prdy_vrss": "-70",
            "prdy_ctrt": "-0.41",
            "prdy_vrss_sign": "5",
            "acml_vol": "552497",
            "d5_dsrt": "116.28",
            "d10_dsrt": "131.23",
            "d20_dsrt": "137.29",
            "d60_dsrt": "145.68",
            "d120_dsrt": "143.29"
        },
        {
            "mksc_shrn_iscd": "255220",
            "data_rank": "9",
            "hts_kor_isnm": "SG",
            "stck_prpr": "2550",
            "prdy_vrss": "-215",
            "prdy_ctrt": "-7.78",
            "prdy_vrss_sign": "5",
            "acml_vol": "16959683",
            "d5_dsrt": "116.25",
            "d10_dsrt": "128.68",
            "d20_dsrt": "143.81",
            "d60_dsrt": "155.60",
            "d120_dsrt": "176.12"
        },
        {
            "mksc_shrn_iscd": "101000",
            "data_rank": "10",
            "hts_kor_isnm": "상상인인더스트리",
            "stck_prpr": "3510",
            "prdy_vrss": "55",
            "prdy_ctrt": "1.59",
            "prdy_vrss_sign": "2",
            "acml_vol": "679073",
            "d5_dsrt": "115.96",
            "d10_dsrt": "134.74",
            "d20_dsrt": "149.26",
            "d60_dsrt": "154.00",
            "d120_dsrt": "159.79"
        },
        {
            "mksc_shrn_iscd": "060230",
            "data_rank": "11",
            "hts_kor_isnm": "소니드",
            "stck_prpr": "2570",
            "prdy_vrss": "475",
            "prdy_ctrt": "22.67",
            "prdy_vrss_sign": "2",
            "acml_vol": "3807050",
            "d5_dsrt": "115.71",
            "d10_dsrt": "115.45",
            "d20_dsrt": "105.64",
            "d60_dsrt": "121.17",
            "d120_dsrt": "110.82"
        },
        {
            "mksc_shrn_iscd": "073570",
            "data_rank": "12",
            "hts_kor_isnm": "리튬포어스",
            "stck_prpr": "6870",
            "prdy_vrss": "1470",
            "prdy_ctrt": "27.22",
            "prdy_vrss_sign": "2",
            "acml_vol": "5384918",
            "d5_dsrt": "115.58",
            "d10_dsrt": "112.84",
            "d20_dsrt": "118.04",
            "d60_dsrt": "113.48",
            "d120_dsrt": "93.27"
        },
        {
            "mksc_shrn_iscd": "036220",
            "data_rank": "13",
            "hts_kor_isnm": "오상헬스케어",
            "stck_prpr": "25300",
            "prdy_vrss": "100",
            "prdy_ctrt": "0.40",
            "prdy_vrss_sign": "2",
            "acml_vol": "175169",
            "d5_dsrt": "115.47",
            "d10_dsrt": "202.87",
            "d20_dsrt": "287.60",
            "d60_dsrt": "385.34",
            "d120_dsrt": "327.55"
        },
        {
            "mksc_shrn_iscd": "321370",
            "data_rank": "14",
            "hts_kor_isnm": "센서뷰",
            "stck_prpr": "4890",
            "prdy_vrss": "790",
            "prdy_ctrt": "19.27",
            "prdy_vrss_sign": "2",
            "acml_vol": "5626573",
            "d5_dsrt": "114.73",
            "d10_dsrt": "117.60",
            "d20_dsrt": "112.33",
            "d60_dsrt": "102.91",
            "d120_dsrt": "108.28"
        },
        {
            "mksc_shrn_iscd": "030350",
            "data_rank": "15",
            "hts_kor_isnm": "드래곤플라이",
            "stck_prpr": "614",
            "prdy_vrss": "-7",
            "prdy_ctrt": "-1.13",
            "prdy_vrss_sign": "5",
            "acml_vol": "13499054",
            "d5_dsrt": "114.72",
            "d10_dsrt": "119.64",
            "d20_dsrt": "116.56",
            "d60_dsrt": "103.46",
            "d120_dsrt": "105.08"
        },
        {
            "mksc_shrn_iscd": "066910",
            "data_rank": "16",
            "hts_kor_isnm": "손오공",
            "stck_prpr": "3800",
            "prdy_vrss": "470",
            "prdy_ctrt": "14.11",
            "prdy_vrss_sign": "2",
            "acml_vol": "2211703",
            "d5_dsrt": "114.25",
            "d10_dsrt": "125.60",
            "d20_dsrt": "132.42",
            "d60_dsrt": "132.81",
            "d120_dsrt": "148.85"
        },
        {
            "mksc_shrn_iscd": "115530",
            "data_rank": "17",
            "hts_kor_isnm": "씨엔플러스",
            "stck_prpr": "340",
            "prdy_vrss": "-5",
            "prdy_ctrt": "-1.45",
            "prdy_vrss_sign": "5",
            "acml_vol": "9226496",
            "d5_dsrt": "114.17",
            "d10_dsrt": "117.16",
            "d20_dsrt": "110.16",
            "d60_dsrt": "103.26",
            "d120_dsrt": "92.59"
        },
        {
            "mksc_shrn_iscd": "219130",
            "data_rank": "18",
            "hts_kor_isnm": "타이거일렉",
            "stck_prpr": "38550",
            "prdy_vrss": "5550",
            "prdy_ctrt": "16.82",
            "prdy_vrss_sign": "2",
            "acml_vol": "306979",
            "d5_dsrt": "112.98",
            "d10_dsrt": "115.90",
            "d20_dsrt": "119.17",
            "d60_dsrt": "147.68",
            "d120_dsrt": "168.89"
        },
        {
            "mksc_shrn_iscd": "053030",
            "data_rank": "19",
            "hts_kor_isnm": "바이넥스",
            "stck_prpr": "18190",
            "prdy_vrss": "1730",
            "prdy_ctrt": "10.51",
            "prdy_vrss_sign": "2",
            "acml_vol": "6841463",
            "d5_dsrt": "112.84",
            "d10_dsrt": "128.02",
            "d20_dsrt": "143.73",
            "d60_dsrt": "174.00",
            "d120_dsrt": "198.06"
        },
        {
            "mksc_shrn_iscd": "008600",
            "data_rank": "20",
            "hts_kor_isnm": "윌비스",
            "stck_prpr": "575",
            "prdy_vrss": "45",
            "prdy_ctrt": "8.49",
            "prdy_vrss_sign": "2",
            "acml_vol": "4543051",
            "d5_dsrt": "112.83",
            "d10_dsrt": "115.30",
            "d20_dsrt": "111.54",
            "d60_dsrt": "97.44",
            "d120_dsrt": "97.79"
        },
        {
            "mksc_shrn_iscd": "091970",
            "data_rank": "21",
            "hts_kor_isnm": "나노캠텍",
            "stck_prpr": "777",
            "prdy_vrss": "123",
            "prdy_ctrt": "18.81",
            "prdy_vrss_sign": "2",
            "acml_vol": "1580766",
            "d5_dsrt": "112.12",
            "d10_dsrt": "110.95",
            "d20_dsrt": "103.11",
            "d60_dsrt": "88.09",
            "d120_dsrt": "83.87"
        },
        {
            "mksc_shrn_iscd": "000680",
            "data_rank": "22",
            "hts_kor_isnm": "LS네트웍스",
            "stck_prpr": "5350",
            "prdy_vrss": "-290",
            "prdy_ctrt": "-5.14",
            "prdy_vrss_sign": "5",
            "acml_vol": "7951524",
            "d5_dsrt": "112.04",
            "d10_dsrt": "121.22",
            "d20_dsrt": "123.64",
            "d60_dsrt": "121.96",
            "d120_dsrt": "121.76"
        },
        {
            "mksc_shrn_iscd": "010640",
            "data_rank": "23",
            "hts_kor_isnm": "진양폴리",
            "stck_prpr": "6700",
            "prdy_vrss": "560",
            "prdy_ctrt": "9.12",
            "prdy_vrss_sign": "2",
            "acml_vol": "330657",
            "d5_dsrt": "111.74",
            "d10_dsrt": "116.85",
            "d20_dsrt": "119.33",
            "d60_dsrt": "113.49",
            "d120_dsrt": "104.66"
        },
        {
            "mksc_shrn_iscd": "000150",
            "data_rank": "24",
            "hts_kor_isnm": "두산",
            "stck_prpr": "150400",
            "prdy_vrss": "5400",
            "prdy_ctrt": "3.72",
            "prdy_vrss_sign": "2",
            "acml_vol": "205583",
            "d5_dsrt": "111.71",
            "d10_dsrt": "126.98",
            "d20_dsrt": "140.65",
            "d60_dsrt": "158.32",
            "d120_dsrt": "164.12"
        },
        {
            "mksc_shrn_iscd": "119860",
            "data_rank": "25",
            "hts_kor_isnm": "커넥트웨이브",
            "stck_prpr": "15270",
            "prdy_vrss": "10",
            "prdy_ctrt": "0.07",
            "prdy_vrss_sign": "2",
            "acml_vol": "196410",
            "d5_dsrt": "111.46",
            "d10_dsrt": "113.09",
            "d20_dsrt": "110.40",
            "d60_dsrt": "106.56",
            "d120_dsrt": "120.72"
        },
        {
            "mksc_shrn_iscd": "105740",
            "data_rank": "26",
            "hts_kor_isnm": "디케이락",
            "stck_prpr": "9420",
            "prdy_vrss": "1070",
            "prdy_ctrt": "12.81",
            "prdy_vrss_sign": "2",
            "acml_vol": "3498003",
            "d5_dsrt": "111.40",
            "d10_dsrt": "115.50",
            "d20_dsrt": "115.86",
            "d60_dsrt": "111.85",
            "d120_dsrt": "106.17"
        },
        {
            "mksc_shrn_iscd": "219550",
            "data_rank": "27",
            "hts_kor_isnm": "디와이디",
            "stck_prpr": "1010",
            "prdy_vrss": "-23",
            "prdy_ctrt": "-2.23",
            "prdy_vrss_sign": "5",
            "acml_vol": "1923238",
            "d5_dsrt": "111.14",
            "d10_dsrt": "118.50",
            "d20_dsrt": "128.36",
            "d60_dsrt": "126.66",
            "d120_dsrt": "113.85"
        },
        {
            "mksc_shrn_iscd": "001040",
            "data_rank": "28",
            "hts_kor_isnm": "CJ",
            "stck_prpr": "111100",
            "prdy_vrss": "1900",
            "prdy_ctrt": "1.74",
            "prdy_vrss_sign": "2",
            "acml_vol": "234342",
            "d5_dsrt": "111.06",
            "d10_dsrt": "113.97",
            "d20_dsrt": "113.04",
            "d60_dsrt": "115.40",
            "d120_dsrt": "120.89"
        },
        {
            "mksc_shrn_iscd": "110020",
            "data_rank": "29",
            "hts_kor_isnm": "전진바이오팜",
            "stck_prpr": "8690",
            "prdy_vrss": "680",
            "prdy_ctrt": "8.49",
            "prdy_vrss_sign": "2",
            "acml_vol": "173087",
            "d5_dsrt": "110.79",
            "d10_dsrt": "111.85",
            "d20_dsrt": "110.95",
            "d60_dsrt": "103.49",
            "d120_dsrt": "109.97"
        },
        {
            "mksc_shrn_iscd": "001440",
            "data_rank": "30",
            "hts_kor_isnm": "대한전선",
            "stck_prpr": "10990",
            "prdy_vrss": "890",
            "prdy_ctrt": "8.81",
            "prdy_vrss_sign": "2",
            "acml_vol": "6305591",
            "d5_dsrt": "110.76",
            "d10_dsrt": "115.88",
            "d20_dsrt": "116.62",
            "d60_dsrt": "118.40",
            "d120_dsrt": "109.38"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시장가치 순위[v1_국내주식-096]

REST

국내주식 시장가치 순위[v1_국내주식-096]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/market-value
  • Format
     
  • Content-Type
     

개요

국내주식 시장가치 순위 API입니다.
한국투자 HTS(eFriend Plus) > [0179] 시장가치순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01790000
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_trgt_cls_code 대상 구분 코드 String Y 32 0 : 전체
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20179 )
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_div_cls_code 분류 구분 코드 String Y 2 0: 전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보톧주, 7:우선주
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_input_option_1 입력 옵션1 String Y 10 회계연도 입력 (ex 2023)
fid_input_option_2 입력 옵션2 String Y 10 0: 1/4분기 , 1: 반기, 2: 3/4분기, 3: 결산
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 '가치분석(23:PER, 24:PBR, 25:PCR, 26:PSR, 27: EPS, 28:EVA,
29: EBITDA, 30: EV/EBITDA, 31:EBITDA/금융비율'
fid_blng_cls_code 소속 구분 코드 String Y 2 0 : 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0 : 전체

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
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-per PER String Y 82
-pbr PBR String Y 82
-pcr PCR String Y 82
-psr PSR String Y 82
-eps EPS String Y 112
-eva EVA String Y 82
-ebitda EBITDA String Y 82
-pv_div_ebitda PV DIV EBITDA String Y 82
-ebitda_div_fnnc_expn EBITDA DIV 금융비용 String Y 82
-stac_month 결산 월 String Y 2
-stac_month_cls_code 결산 월 구분 코드 String Y 2
-iqry_csnu 조회 건수 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20179",
"fid_input_iscd":"0000",
"fid_div_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_input_option_1":"2023",
"fid_input_option_2":"3",
"fid_rank_sort_cls_code":"23",
"fid_blng_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_trgt_cls_code":"0"
}

Response

{
    "output": [
        {
            "data_rank": "1",
            "hts_kor_isnm": "효성",
            "mksc_shrn_iscd": "004800",
            "stck_prpr": "57800",
            "prdy_vrss": "-400",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.69",
            "acml_vol": "7453",
            "per": "19266.67",
            "pbr": "0.49",
            "pcr": "11.19",
            "psr": "0.35",
            "eps": "300",
            "eva": "-812.00",
            "ebitda": "2031.00",
            "pv_div_ebitda": "12.98",
            "ebitda_div_fnnc_expn": "0.02",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "2",
            "hts_kor_isnm": "에이엘티",
            "mksc_shrn_iscd": "172670",
            "stck_prpr": "21450",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.23",
            "acml_vol": "28989",
            "per": "10725.00",
            "pbr": "1.87",
            "pcr": "10.63",
            "psr": "3.68",
            "eps": "200",
            "eva": "0.00",
            "ebitda": "170.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.05",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "3",
            "hts_kor_isnm": "한싹",
            "mksc_shrn_iscd": "430690",
            "stck_prpr": "14450",
            "prdy_vrss": "-170",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.16",
            "acml_vol": "11549",
            "per": "4816.67",
            "pbr": "2.44",
            "pcr": "171.76",
            "psr": "3.74",
            "eps": "300",
            "eva": "0.00",
            "ebitda": "1.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "4",
            "hts_kor_isnm": "파버나인",
            "mksc_shrn_iscd": "177830",
            "stck_prpr": "3565",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.14",
            "acml_vol": "7838",
            "per": "1188.33",
            "pbr": "0.61",
            "pcr": "6.37",
            "psr": "0.40",
            "eps": "300",
            "eva": "0.00",
            "ebitda": "83.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.03",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "5",
            "hts_kor_isnm": "카카오페이",
            "mksc_shrn_iscd": "377300",
            "stck_prpr": "39800",
            "prdy_vrss": "-150",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.38",
            "acml_vol": "49767",
            "per": "1170.59",
            "pbr": "2.84",
            "pcr": "102.25",
            "psr": "8.90",
            "eps": "3400",
            "eva": "0.00",
            "ebitda": "-6.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "6",
            "hts_kor_isnm": "디케이티",
            "mksc_shrn_iscd": "290550",
            "stck_prpr": "9030",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "5782",
            "per": "752.50",
            "pbr": "1.28",
            "pcr": "18.89",
            "psr": "0.60",
            "eps": "1200",
            "eva": "0.00",
            "ebitda": "180.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.09",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "7",
            "hts_kor_isnm": "키움제6호스팩",
            "mksc_shrn_iscd": "413600",
            "stck_prpr": "2125",
            "prdy_vrss": "-25",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.16",
            "acml_vol": "3455",
            "per": "708.33",
            "pbr": "1.11",
            "pcr": "689.94",
            "psr": "0.00",
            "eps": "300",
            "eva": "0.00",
            "ebitda": "-1.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "8",
            "hts_kor_isnm": "네온테크",
            "mksc_shrn_iscd": "306620",
            "stck_prpr": "2740",
            "prdy_vrss": "30",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.11",
            "acml_vol": "30166",
            "per": "685.00",
            "pbr": "2.33",
            "pcr": "46.94",
            "psr": "1.63",
            "eps": "400",
            "eva": "0.00",
            "ebitda": "18.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.01",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "9",
            "hts_kor_isnm": "한올바이오파마",
            "mksc_shrn_iscd": "009420",
            "stck_prpr": "36900",
            "prdy_vrss": "900",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.50",
            "acml_vol": "241062",
            "per": "550.75",
            "pbr": "9.67",
            "pcr": "285.34",
            "psr": "14.29",
            "eps": "6700",
            "eva": "-67.00",
            "ebitda": "55.00",
            "pv_div_ebitda": "423.99",
            "ebitda_div_fnnc_expn": "0.87",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "10",
            "hts_kor_isnm": "IBKS제20호스팩",
            "mksc_shrn_iscd": "439730",
            "stck_prpr": "2595",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "730",
            "per": "519.00",
            "pbr": "1.33",
            "pcr": "571.59",
            "psr": "0.00",
            "eps": "500",
            "eva": "0.00",
            "ebitda": "0.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "11",
            "hts_kor_isnm": "에코프로머티",
            "mksc_shrn_iscd": "450080",
            "stck_prpr": "151300",
            "prdy_vrss": "1100",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.73",
            "acml_vol": "140199",
            "per": "514.63",
            "pbr": "27.87",
            "pcr": "221.45",
            "psr": "12.06",
            "eps": "29400",
            "eva": "266.00",
            "ebitda": "596.00",
            "pv_div_ebitda": "4.36",
            "ebitda_div_fnnc_expn": "0.05",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "12",
            "hts_kor_isnm": "씨씨에스",
            "mksc_shrn_iscd": "066790",
            "stck_prpr": "5460",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.18",
            "acml_vol": "5892226",
            "per": "496.36",
            "pbr": "10.52",
            "pcr": "74.99",
            "psr": "15.94",
            "eps": "1100",
            "eva": "0.00",
            "ebitda": "28.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.10",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "13",
            "hts_kor_isnm": "로보스타",
            "mksc_shrn_iscd": "090360",
            "stck_prpr": "34800",
            "prdy_vrss": "650",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.90",
            "acml_vol": "131404",
            "per": "490.14",
            "pbr": "3.77",
            "pcr": "151.06",
            "psr": "3.30",
            "eps": "7100",
            "eva": "-39.00",
            "ebitda": "27.00",
            "pv_div_ebitda": "108.07",
            "ebitda_div_fnnc_expn": "1.71",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "14",
            "hts_kor_isnm": "두산퓨얼셀",
            "mksc_shrn_iscd": "336260",
            "stck_prpr": "20300",
            "prdy_vrss": "510",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.58",
            "acml_vol": "188218",
            "per": "431.91",
            "pbr": "3.17",
            "pcr": "102.57",
            "psr": "5.32",
            "eps": "4700",
            "eva": "-492.00",
            "ebitda": "196.00",
            "pv_div_ebitda": "118.06",
            "ebitda_div_fnnc_expn": "0.04",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "15",
            "hts_kor_isnm": "가온칩스",
            "mksc_shrn_iscd": "399720",
            "stck_prpr": "101900",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.39",
            "acml_vol": "223999",
            "per": "415.92",
            "pbr": "20.38",
            "pcr": "152.86",
            "psr": "20.56",
            "eps": "24500",
            "eva": "0.00",
            "ebitda": "49.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.23",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "16",
            "hts_kor_isnm": "미래나노텍",
            "mksc_shrn_iscd": "095500",
            "stck_prpr": "20200",
            "prdy_vrss": "1530",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.19",
            "acml_vol": "976189",
            "per": "412.24",
            "pbr": "2.34",
            "pcr": "41.51",
            "psr": "0.94",
            "eps": "4900",
            "eva": "0.00",
            "ebitda": "226.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.04",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "17",
            "hts_kor_isnm": "디와이피엔에프",
            "mksc_shrn_iscd": "104460",
            "stck_prpr": "20000",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.44",
            "acml_vol": "12543",
            "per": "350.88",
            "pbr": "1.90",
            "pcr": "64.19",
            "psr": "1.59",
            "eps": "5700",
            "eva": "0.00",
            "ebitda": "43.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.03",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "18",
            "hts_kor_isnm": "바이오니아",
            "mksc_shrn_iscd": "064550",
            "stck_prpr": "30150",
            "prdy_vrss": "150",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.50",
            "acml_vol": "79014",
            "per": "350.58",
            "pbr": "3.27",
            "pcr": "65.17",
            "psr": "2.93",
            "eps": "8600",
            "eva": "0.00",
            "ebitda": "158.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.20",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "19",
            "hts_kor_isnm": "픽셀플러스",
            "mksc_shrn_iscd": "087600",
            "stck_prpr": "9780",
            "prdy_vrss": "30",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.31",
            "acml_vol": "31501",
            "per": "326.00",
            "pbr": "0.77",
            "pcr": "45.96",
            "psr": "1.27",
            "eps": "3000",
            "eva": "-20.00",
            "ebitda": "44.00",
            "pv_div_ebitda": "14.29",
            "ebitda_div_fnnc_expn": "1.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "20",
            "hts_kor_isnm": "한국제12호스팩",
            "mksc_shrn_iscd": "458610",
            "stck_prpr": "2195",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "9418",
            "per": "313.57",
            "pbr": "1.10",
            "pcr": "302.76",
            "psr": "0.00",
            "eps": "700",
            "eva": "0.00",
            "ebitda": "0.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "0",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "21",
            "hts_kor_isnm": "유진스팩8호",
            "mksc_shrn_iscd": "413630",
            "stck_prpr": "3630",
            "prdy_vrss": "-80",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.16",
            "acml_vol": "181731",
            "per": "302.50",
            "pbr": "1.95",
            "pcr": "300.25",
            "psr": "0.00",
            "eps": "1200",
            "eva": "0.00",
            "ebitda": "-1.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "22",
            "hts_kor_isnm": "라온텍",
            "mksc_shrn_iscd": "418420",
            "stck_prpr": "6310",
            "prdy_vrss": "120",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.94",
            "acml_vol": "39277",
            "per": "300.48",
            "pbr": "23.99",
            "pcr": "229.71",
            "psr": "16.44",
            "eps": "2100",
            "eva": "3.00",
            "ebitda": "5.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.14",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "23",
            "hts_kor_isnm": "에프엔에스테크",
            "mksc_shrn_iscd": "083500",
            "stck_prpr": "12240",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "60455",
            "per": "291.43",
            "pbr": "1.57",
            "pcr": "28.61",
            "psr": "2.81",
            "eps": "4200",
            "eva": "0.00",
            "ebitda": "25.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.03",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "24",
            "hts_kor_isnm": "삼아알미늄",
            "mksc_shrn_iscd": "006110",
            "stck_prpr": "91500",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.44",
            "acml_vol": "17642",
            "per": "284.16",
            "pbr": "5.22",
            "pcr": "76.02",
            "psr": "4.80",
            "eps": "32200",
            "eva": "0.00",
            "ebitda": "133.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.07",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "25",
            "hts_kor_isnm": "하나기술",
            "mksc_shrn_iscd": "299030",
            "stck_prpr": "64900",
            "prdy_vrss": "1400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.20",
            "acml_vol": "56036",
            "per": "276.17",
            "pbr": "4.68",
            "pcr": "85.46",
            "psr": "4.52",
            "eps": "23500",
            "eva": "0.00",
            "ebitda": "-23.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "26",
            "hts_kor_isnm": "특수건설",
            "mksc_shrn_iscd": "026150",
            "stck_prpr": "7600",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.39",
            "acml_vol": "19735",
            "per": "271.43",
            "pbr": "1.24",
            "pcr": "13.64",
            "psr": "0.58",
            "eps": "2800",
            "eva": "0.00",
            "ebitda": "75.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.08",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "27",
            "hts_kor_isnm": "경보제약",
            "mksc_shrn_iscd": "214390",
            "stck_prpr": "6890",
            "prdy_vrss": "220",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.30",
            "acml_vol": "62124",
            "per": "265.00",
            "pbr": "1.15",
            "pcr": "13.13",
            "psr": "0.84",
            "eps": "2600",
            "eva": "-119.00",
            "ebitda": "133.00",
            "pv_div_ebitda": "22.24",
            "ebitda_div_fnnc_expn": "0.08",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "28",
            "hts_kor_isnm": "교보11호스팩",
            "mksc_shrn_iscd": "397880",
            "stck_prpr": "3425",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "0",
            "per": "263.46",
            "pbr": "1.75",
            "pcr": "253.89",
            "psr": "0.00",
            "eps": "1300",
            "eva": "0.00",
            "ebitda": "0.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "29",
            "hts_kor_isnm": "오스테오닉",
            "mksc_shrn_iscd": "226400",
            "stck_prpr": "4910",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.41",
            "acml_vol": "71736",
            "per": "258.42",
            "pbr": "1.98",
            "pcr": "31.94",
            "psr": "3.82",
            "eps": "1900",
            "eva": "0.00",
            "ebitda": "45.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.07",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        },
        {
            "data_rank": "30",
            "hts_kor_isnm": "유진스팩7호",
            "mksc_shrn_iscd": "388800",
            "stck_prpr": "2440",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "0",
            "per": "244.00",
            "pbr": "1.36",
            "pcr": "254.17",
            "psr": "0.00",
            "eps": "1000",
            "eva": "0.00",
            "ebitda": "-1.00",
            "pv_div_ebitda": "0.00",
            "ebitda_div_fnnc_expn": "0.00",
            "stac_month": "12",
            "stac_month_cls_code": "1",
            "iqry_csnu": "1773"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 체결강도 상위[v1_국내주식-101]

REST

국내주식 체결강도 상위[v1_국내주식-101]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/volume-power
  • Format
     
  • Content-Type
     

개요

국내주식 체결강도 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0168] 체결강도 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01680000
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_trgt_exls_cls_code 대상 제외 구분 코드 String Y 10 0 : 전체
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key( 20168 )
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_div_cls_code 분류 구분 코드 String Y 2 0: 전체, 1: 보통주 2: 우선주
fid_input_price_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_trgt_cls_code 대상 구분 코드 String Y 10 0 : 전체

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_shrn_iscd 주식 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-tday_rltv 당일 체결강도 String Y 112
-seln_cnqn_smtn 매도 체결량 합계 String Y 18
-shnu_cnqn_smtn 매수2 체결량 합계 String Y 18

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20168",
"fid_input_iscd":"0000",
"fid_div_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_trgt_exls_cls_code":"0",
"fid_trgt_cls_code":"0"
}

Response

{
    "output": [
        {
            "stck_shrn_iscd": "422260",
            "data_rank": "1",
            "hts_kor_isnm": "VITA MZ소비액티브",
            "stck_prpr": "7650",
            "prdy_vrss": "20",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.26",
            "acml_vol": "26424",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "26424"
        },
        {
            "stck_shrn_iscd": "452440",
            "data_rank": "2",
            "hts_kor_isnm": "VITA 밸류알파액티브",
            "stck_prpr": "11440",
            "prdy_vrss": "-45",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.39",
            "acml_vol": "23100",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "23100"
        },
        {
            "stck_shrn_iscd": "449680",
            "data_rank": "3",
            "hts_kor_isnm": "TIGER 한중전기차(합성)",
            "stck_prpr": "8945",
            "prdy_vrss": "200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.29",
            "acml_vol": "12065",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "12063"
        },
        {
            "stck_shrn_iscd": "457940",
            "data_rank": "4",
            "hts_kor_isnm": "에스케이증권제10호스팩",
            "stck_prpr": "2335",
            "prdy_vrss": "-5",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.21",
            "acml_vol": "1011",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "1011"
        },
        {
            "stck_shrn_iscd": "442580",
            "data_rank": "5",
            "hts_kor_isnm": "ARIRANG 글로벌D램반도체iSelect",
            "stck_prpr": "17290",
            "prdy_vrss": "200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.17",
            "acml_vol": "906",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "885"
        },
        {
            "stck_shrn_iscd": "458210",
            "data_rank": "6",
            "hts_kor_isnm": "히어로즈 CD금리액티브(합성)",
            "stck_prpr": "102975",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "663",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "663"
        },
        {
            "stck_shrn_iscd": "418210",
            "data_rank": "7",
            "hts_kor_isnm": "신한제10호스팩",
            "stck_prpr": "2420",
            "prdy_vrss": "40",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.68",
            "acml_vol": "618",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "618"
        },
        {
            "stck_shrn_iscd": "469790",
            "data_rank": "8",
            "hts_kor_isnm": "KOSEF K-테크TOP10",
            "stck_prpr": "11025",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.09",
            "acml_vol": "612",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "612"
        },
        {
            "stck_shrn_iscd": "449580",
            "data_rank": "9",
            "hts_kor_isnm": "KBSTAR 미국빅데이터Top3채권혼합iSelect",
            "stck_prpr": "12170",
            "prdy_vrss": "45",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.37",
            "acml_vol": "463",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "463"
        },
        {
            "stck_shrn_iscd": "424140",
            "data_rank": "10",
            "hts_kor_isnm": "케이비제21호스팩",
            "stck_prpr": "2090",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "924",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "419"
        },
        {
            "stck_shrn_iscd": "Q570055",
            "data_rank": "11",
            "hts_kor_isnm": "한투 금 선물 ETN",
            "stck_prpr": "13530",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.15",
            "acml_vol": "401",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "401"
        },
        {
            "stck_shrn_iscd": "433980",
            "data_rank": "12",
            "hts_kor_isnm": "KODEX TDF2040액티브",
            "stck_prpr": "12145",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.04",
            "acml_vol": "391",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "377"
        },
        {
            "stck_shrn_iscd": "474390",
            "data_rank": "13",
            "hts_kor_isnm": "SOL 국고채30년액티브",
            "stck_prpr": "49100",
            "prdy_vrss": "-135",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.27",
            "acml_vol": "307",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "307"
        },
        {
            "stck_shrn_iscd": "Q700009",
            "data_rank": "14",
            "hts_kor_isnm": "하나 레버리지 구리 선물 ETN(H)",
            "stck_prpr": "15195",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.33",
            "acml_vol": "302",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "302"
        },
        {
            "stck_shrn_iscd": "331910",
            "data_rank": "15",
            "hts_kor_isnm": "KOSEF Fn중소형",
            "stck_prpr": "21010",
            "prdy_vrss": "130",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.62",
            "acml_vol": "178",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "178"
        },
        {
            "stck_shrn_iscd": "334700",
            "data_rank": "16",
            "hts_kor_isnm": "KBSTAR 팔라듐선물인버스(H)",
            "stck_prpr": "5795",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "155",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "155"
        },
        {
            "stck_shrn_iscd": "453660",
            "data_rank": "17",
            "hts_kor_isnm": "KODEX 미국S&P500경기소비재",
            "stck_prpr": "12875",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.39",
            "acml_vol": "102",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "101"
        },
        {
            "stck_shrn_iscd": "Q610054",
            "data_rank": "18",
            "hts_kor_isnm": "메리츠 블룸버그 -2X 천연가스 선물 ETN(H)",
            "stck_prpr": "93505",
            "prdy_vrss": "-505",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.54",
            "acml_vol": "100",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "100"
        },
        {
            "stck_shrn_iscd": "322150",
            "data_rank": "19",
            "hts_kor_isnm": "ACE 스마트하이베타",
            "stck_prpr": "13240",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.53",
            "acml_vol": "91",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "91"
        },
        {
            "stck_shrn_iscd": "Q580057",
            "data_rank": "20",
            "hts_kor_isnm": "KB 일본 컨슈머 TOP 10 ETN",
            "stck_prpr": "11080",
            "prdy_vrss": "70",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.64",
            "acml_vol": "90",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "90"
        },
        {
            "stck_shrn_iscd": "Q580034",
            "data_rank": "21",
            "hts_kor_isnm": "KB 레버리지 FANG 플러스 ETN(H)",
            "stck_prpr": "37185",
            "prdy_vrss": "-420",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.12",
            "acml_vol": "76",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "76"
        },
        {
            "stck_shrn_iscd": "449780",
            "data_rank": "22",
            "hts_kor_isnm": "KOSEF 미국S&P500(H)",
            "stck_prpr": "13080",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.38",
            "acml_vol": "106",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "65"
        },
        {
            "stck_shrn_iscd": "122260",
            "data_rank": "23",
            "hts_kor_isnm": "KOSEF 통안채1년",
            "stck_prpr": "103225",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "61",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "61"
        },
        {
            "stck_shrn_iscd": "Q700014",
            "data_rank": "24",
            "hts_kor_isnm": "하나 인버스 2X 콩 선물 ETN(H)",
            "stck_prpr": "10850",
            "prdy_vrss": "-85",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.78",
            "acml_vol": "55",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "55"
        },
        {
            "stck_shrn_iscd": "433220",
            "data_rank": "25",
            "hts_kor_isnm": "에셋플러스 글로벌대장장이액티브",
            "stck_prpr": "13855",
            "prdy_vrss": "5",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.04",
            "acml_vol": "54",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "54"
        },
        {
            "stck_shrn_iscd": "Q530014",
            "data_rank": "26",
            "hts_kor_isnm": "삼성 China A50 선물 ETN(H)",
            "stck_prpr": "14910",
            "prdy_vrss": "55",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.37",
            "acml_vol": "51",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "51"
        },
        {
            "stck_shrn_iscd": "411540",
            "data_rank": "27",
            "hts_kor_isnm": "SOL 200 Top10",
            "stck_prpr": "9005",
            "prdy_vrss": "130",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.46",
            "acml_vol": "48",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "46"
        },
        {
            "stck_shrn_iscd": "227830",
            "data_rank": "28",
            "hts_kor_isnm": "ARIRANG 코스피",
            "stck_prpr": "28060",
            "prdy_vrss": "90",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.32",
            "acml_vol": "41",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "41"
        },
        {
            "stck_shrn_iscd": "375760",
            "data_rank": "29",
            "hts_kor_isnm": "HANARO 탄소효율그린뉴딜",
            "stck_prpr": "9070",
            "prdy_vrss": "45",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.50",
            "acml_vol": "37",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "37"
        },
        {
            "stck_shrn_iscd": "395750",
            "data_rank": "30",
            "hts_kor_isnm": "ARIRANG ESG가치주액티브",
            "stck_prpr": "8445",
            "prdy_vrss": "35",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.42",
            "acml_vol": "36",
            "tday_rltv": "999.99",
            "seln_cnqn_smtn": "0",
            "shnu_cnqn_smtn": "36"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 관심종목등록 상위[v1_국내주식-102]

REST

국내주식 관심종목등록 상위[v1_국내주식-102]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/top-interest-stock
  • Format
     
  • Content-Type
     

개요

국내주식 관심종목등록 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0180] 관심종목등록상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01800000
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_input_iscd_2 입력 종목코드2 String Y 12 000000 : 필수입력값
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key(20180)
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200
fid_trgt_cls_code 대상 구분 코드 String Y 2 0 : 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 2 0 : 전체
fid_input_price_1 입력 가격1 String Y 2 입력값 없을때 전체 (가격 ~)
fid_input_price_2 입력 가격2 String Y 2 입력값 없을때 전체 (~ 가격)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_div_cls_code 분류 구분 코드 String Y 12 0: 전체 1: 관리종목 2: 투자주의 3: 투자경고 4: 투자위험예고 5: 투자위험 6: 보통주 7: 우선주
fid_input_cnt_1 입력 수1 String Y 10 순위검색 입력값(1: 1위부터, 10: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
output 응답상세 Object Array Y array
-mrkt_div_cls_name 시장 분류 구분 명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-acml_tr_pbmn 누적 거래 대금 String Y 18
-askp 매도호가 String Y 10
-bidp 매수호가 String Y 10
-data_rank 데이터 순위 String Y 10
-inter_issu_reg_csnu 관심 종목 등록 건수 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20180",
"fid_input_iscd":"0000",
"fid_trgt_exls_cls_code":"0",
"fid_trgt_cls_code":"0",
"fid_input_price_1":"",
"fid_input_price_2":"",
"fid_vol_cnt":"",
"fid_div_cls_code":"0",
"fid_input_iscd_2":"000000",
"fid_input_cnt_1":"1"
}

Response

{
    "output": [
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "005930",
            "hts_kor_isnm": "삼성전자",
            "stck_prpr": "72700",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.55",
            "acml_vol": "4160099",
            "acml_tr_pbmn": "302366528800",
            "askp": "72800",
            "bidp": "72700",
            "data_rank": "1",
            "inter_issu_reg_csnu": "4316153"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "000660",
            "hts_kor_isnm": "SK하이닉스",
            "stck_prpr": "162900",
            "prdy_vrss": "1700",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.05",
            "acml_vol": "990751",
            "acml_tr_pbmn": "160519591000",
            "askp": "162900",
            "bidp": "162800",
            "data_rank": "2",
            "inter_issu_reg_csnu": "1173540"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "373220",
            "hts_kor_isnm": "LG에너지솔루션",
            "stck_prpr": "404500",
            "prdy_vrss": "6000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.51",
            "acml_vol": "46060",
            "acml_tr_pbmn": "18601165500",
            "askp": "404500",
            "bidp": "404000",
            "data_rank": "3",
            "inter_issu_reg_csnu": "932490"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "207940",
            "hts_kor_isnm": "삼성바이오로직스",
            "stck_prpr": "869000",
            "prdy_vrss": "43000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.21",
            "acml_vol": "102027",
            "acml_tr_pbmn": "87895574000",
            "askp": "869000",
            "bidp": "868000",
            "data_rank": "4",
            "inter_issu_reg_csnu": "587897"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "005380",
            "hts_kor_isnm": "현대차",
            "stck_prpr": "247000",
            "prdy_vrss": "3500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.44",
            "acml_vol": "313743",
            "acml_tr_pbmn": "76616945500",
            "askp": "247000",
            "bidp": "246500",
            "data_rank": "5",
            "inter_issu_reg_csnu": "515079"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "005935",
            "hts_kor_isnm": "삼성전자우",
            "stck_prpr": "62400",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.65",
            "acml_vol": "222773",
            "acml_tr_pbmn": "13898135300",
            "askp": "62400",
            "bidp": "62300",
            "data_rank": "6",
            "inter_issu_reg_csnu": "510190"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "000270",
            "hts_kor_isnm": "기아",
            "stck_prpr": "127600",
            "prdy_vrss": "2600",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.08",
            "acml_vol": "601506",
            "acml_tr_pbmn": "75893598900",
            "askp": "127800",
            "bidp": "127600",
            "data_rank": "7",
            "inter_issu_reg_csnu": "502555"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "068270",
            "hts_kor_isnm": "셀트리온",
            "stck_prpr": "182300",
            "prdy_vrss": "1500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.83",
            "acml_vol": "269213",
            "acml_tr_pbmn": "49066824700",
            "askp": "182300",
            "bidp": "182200",
            "data_rank": "8",
            "inter_issu_reg_csnu": "394234"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "005490",
            "hts_kor_isnm": "POSCO홀딩스",
            "stck_prpr": "437500",
            "prdy_vrss": "2500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.57",
            "acml_vol": "164953",
            "acml_tr_pbmn": "71803903500",
            "askp": "437500",
            "bidp": "437000",
            "data_rank": "9",
            "inter_issu_reg_csnu": "367885"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "105560",
            "hts_kor_isnm": "KB금융",
            "stck_prpr": "73300",
            "prdy_vrss": "-2900",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.81",
            "acml_vol": "1098724",
            "acml_tr_pbmn": "80094554600",
            "askp": "73300",
            "bidp": "73200",
            "data_rank": "10",
            "inter_issu_reg_csnu": "307475"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "051910",
            "hts_kor_isnm": "LG화학",
            "stck_prpr": "439500",
            "prdy_vrss": "8500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.97",
            "acml_vol": "76206",
            "acml_tr_pbmn": "33300157500",
            "askp": "440000",
            "bidp": "439500",
            "data_rank": "11",
            "inter_issu_reg_csnu": "304253"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "035420",
            "hts_kor_isnm": "NAVER",
            "stck_prpr": "184400",
            "prdy_vrss": "-1700",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.91",
            "acml_vol": "381339",
            "acml_tr_pbmn": "70460804100",
            "askp": "184400",
            "bidp": "184300",
            "data_rank": "12",
            "inter_issu_reg_csnu": "302242"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "006400",
            "hts_kor_isnm": "삼성SDI",
            "stck_prpr": "435500",
            "prdy_vrss": "10500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.47",
            "acml_vol": "243109",
            "acml_tr_pbmn": "105190587500",
            "askp": "435500",
            "bidp": "435000",
            "data_rank": "13",
            "inter_issu_reg_csnu": "292249"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "028260",
            "hts_kor_isnm": "삼성물산",
            "stck_prpr": "152000",
            "prdy_vrss": "-2100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.36",
            "acml_vol": "328745",
            "acml_tr_pbmn": "49869673600",
            "askp": "152100",
            "bidp": "152000",
            "data_rank": "14",
            "inter_issu_reg_csnu": "285997"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "055550",
            "hts_kor_isnm": "신한지주",
            "stck_prpr": "48550",
            "prdy_vrss": "-1050",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.12",
            "acml_vol": "962127",
            "acml_tr_pbmn": "46386742150",
            "askp": "48600",
            "bidp": "48550",
            "data_rank": "15",
            "inter_issu_reg_csnu": "254329"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "012330",
            "hts_kor_isnm": "현대모비스",
            "stck_prpr": "270000",
            "prdy_vrss": "1000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.37",
            "acml_vol": "88500",
            "acml_tr_pbmn": "23747976000",
            "askp": "270000",
            "bidp": "269500",
            "data_rank": "16",
            "inter_issu_reg_csnu": "251932"
        },
        {
            "mrkt_div_cls_name": "코스닥",
            "mksc_shrn_iscd": "247540",
            "hts_kor_isnm": "에코프로비엠",
            "stck_prpr": "264000",
            "prdy_vrss": "7500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.92",
            "acml_vol": "338076",
            "acml_tr_pbmn": "89005916500",
            "askp": "264500",
            "bidp": "264000",
            "data_rank": "17",
            "inter_issu_reg_csnu": "250860"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "003670",
            "hts_kor_isnm": "포스코퓨처엠",
            "stck_prpr": "317500",
            "prdy_vrss": "1000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.32",
            "acml_vol": "113774",
            "acml_tr_pbmn": "36129162000",
            "askp": "318000",
            "bidp": "317500",
            "data_rank": "18",
            "inter_issu_reg_csnu": "245171"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "035720",
            "hts_kor_isnm": "카카오",
            "stck_prpr": "53100",
            "prdy_vrss": "-1000",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.85",
            "acml_vol": "432969",
            "acml_tr_pbmn": "23106491000",
            "askp": "53200",
            "bidp": "53100",
            "data_rank": "19",
            "inter_issu_reg_csnu": "240828"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "032830",
            "hts_kor_isnm": "삼성생명",
            "stck_prpr": "96100",
            "prdy_vrss": "-3000",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.03",
            "acml_vol": "264230",
            "acml_tr_pbmn": "25155009400",
            "askp": "96100",
            "bidp": "96000",
            "data_rank": "20",
            "inter_issu_reg_csnu": "198200"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "086790",
            "hts_kor_isnm": "하나금융지주",
            "stck_prpr": "61800",
            "prdy_vrss": "-300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.48",
            "acml_vol": "819659",
            "acml_tr_pbmn": "50061945600",
            "askp": "61900",
            "bidp": "61800",
            "data_rank": "21",
            "inter_issu_reg_csnu": "181553"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "138040",
            "hts_kor_isnm": "메리츠금융지주",
            "stck_prpr": "82900",
            "prdy_vrss": "-300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.36",
            "acml_vol": "196602",
            "acml_tr_pbmn": "16315808200",
            "askp": "82900",
            "bidp": "82800",
            "data_rank": "22",
            "inter_issu_reg_csnu": "169206"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "066570",
            "hts_kor_isnm": "LG전자",
            "stck_prpr": "97300",
            "prdy_vrss": "-1600",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.62",
            "acml_vol": "171039",
            "acml_tr_pbmn": "16760736900",
            "askp": "97300",
            "bidp": "97200",
            "data_rank": "23",
            "inter_issu_reg_csnu": "161848"
        },
        {
            "mrkt_div_cls_name": "코스닥",
            "mksc_shrn_iscd": "086520",
            "hts_kor_isnm": "에코프로",
            "stck_prpr": "607000",
            "prdy_vrss": "6000",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.00",
            "acml_vol": "69604",
            "acml_tr_pbmn": "42222166000",
            "askp": "608000",
            "bidp": "607000",
            "data_rank": "24",
            "inter_issu_reg_csnu": "160032"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "015760",
            "hts_kor_isnm": "한국전력",
            "stck_prpr": "24400",
            "prdy_vrss": "-450",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.81",
            "acml_vol": "916977",
            "acml_tr_pbmn": "22547360200",
            "askp": "24450",
            "bidp": "24400",
            "data_rank": "25",
            "inter_issu_reg_csnu": "159528"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "003550",
            "hts_kor_isnm": "LG",
            "stck_prpr": "90300",
            "prdy_vrss": "-4600",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-4.85",
            "acml_vol": "256392",
            "acml_tr_pbmn": "23167295200",
            "askp": "90400",
            "bidp": "90300",
            "data_rank": "26",
            "inter_issu_reg_csnu": "149279"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "000810",
            "hts_kor_isnm": "삼성화재",
            "stck_prpr": "306000",
            "prdy_vrss": "-3500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.13",
            "acml_vol": "42010",
            "acml_tr_pbmn": "12806652000",
            "askp": "306500",
            "bidp": "306000",
            "data_rank": "27",
            "inter_issu_reg_csnu": "146625"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "034730",
            "hts_kor_isnm": "SK",
            "stck_prpr": "185100",
            "prdy_vrss": "-2200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.17",
            "acml_vol": "33965",
            "acml_tr_pbmn": "6295027100",
            "askp": "185100",
            "bidp": "185000",
            "data_rank": "28",
            "inter_issu_reg_csnu": "137100"
        },
        {
            "mrkt_div_cls_name": "코스피",
            "mksc_shrn_iscd": "323410",
            "hts_kor_isnm": "카카오뱅크",
            "stck_prpr": "27950",
            "prdy_vrss": "-450",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.58",
            "acml_vol": "328422",
            "acml_tr_pbmn": "9190884150",
            "askp": "27950",
            "bidp": "27900",
            "data_rank": "29",
            "inter_issu_reg_csnu": "135444"
        },
        {
            "mrkt_div_cls_name": "코스닥",
            "mksc_shrn_iscd": "028300",
            "hts_kor_isnm": "HLB",
            "stck_prpr": "102200",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.20",
            "acml_vol": "633944",
            "acml_tr_pbmn": "64667743200",
            "askp": "102200",
            "bidp": "102100",
            "data_rank": "30",
            "inter_issu_reg_csnu": "133952"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 예상체결 상승/하락상위[v1_국내주식-103]

REST

국내주식 예상체결 상승/하락상위[v1_국내주식-103]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/exp-trans-updown
  • Format
     
  • Content-Type
     

개요

국내주식 예상체결 상승/하락상위 API입니다.
한국투자 HTS(eFriend Plus) > [0182] 예상체결 상승/하락상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01820000
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_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0:상승률1:상승폭2:보합3:하락율4:하락폭5:체결량6:거래대금
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key(20182)
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체 1:보통주 2:우선주
fid_aply_rang_prc_1 적용 범위 가격1 String Y 18 입력값 없을때 전체 (가격 ~)
fid_vol_cnt 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
fid_pbmn 거래대금 String Y 18 입력값 없을때 전체 (거래대금 ~) 천원단위
fid_blng_cls_code 소속 구분 코드 String Y 2 0: 전체
fid_mkop_cls_code 장운영 구분 코드 String Y 2 0:장전예상1:장마감예상

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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_shrn_iscd 주식 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-stck_sdpr 주식 기준가 String Y 10
-seln_rsqn 매도 잔량 String Y 12
-askp 매도호가 String Y 10
-bidp 매수호가 String Y 10
-shnu_rsqn 매수2 잔량 String Y 12
-cntg_vol 체결 거래량 String Y 18
-antc_tr_pbmn 체결 거래대금 String Y 18
-total_askp_rsqn 총 매도호가 잔량 String Y 12
-total_bidp_rsqn 총 매수호가 잔량 String Y 12

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20182",
"fid_input_iscd":"0000",
"fid_div_cls_code":"0",
"fid_aply_rang_prc_1":"",
"fid_vol_cnt":"",
"fid_pbmn":"",
"fid_blng_cls_code":"0",
"fid_mkop_cls_code":"0",
"fid_rank_sort_cls_code":"0"
}

Response

{
    "output": [
        {
            "stck_shrn_iscd": "199800",
            "hts_kor_isnm": "툴젠",
            "stck_prpr": "76100",
            "prdy_vrss": "17500",
            "prdy_vrss_sign": "1",
            "prdy_ctrt": "29.86",
            "stck_sdpr": "58600",
            "seln_rsqn": "0",
            "askp": "0",
            "bidp": "76100",
            "shnu_rsqn": "49100",
            "cntg_vol": "51683",
            "antc_tr_pbmn": "3933076300",
            "total_askp_rsqn": "0",
            "total_bidp_rsqn": "67064"
        },
        {
            "stck_shrn_iscd": "378340",
            "hts_kor_isnm": "필에너지",
            "stck_prpr": "31800",
            "prdy_vrss": "3400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "11.97",
            "stck_sdpr": "28400",
            "seln_rsqn": "10680",
            "askp": "31800",
            "bidp": "31750",
            "shnu_rsqn": "6215",
            "cntg_vol": "198612",
            "antc_tr_pbmn": "6315861600",
            "total_askp_rsqn": "14705",
            "total_bidp_rsqn": "71743"
        },
        {
            "stck_shrn_iscd": "115530",
            "hts_kor_isnm": "씨엔플러스",
            "stck_prpr": "386",
            "prdy_vrss": "41",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "11.88",
            "stck_sdpr": "345",
            "seln_rsqn": "3257",
            "askp": "386",
            "bidp": "385",
            "shnu_rsqn": "92624",
            "cntg_vol": "1150496",
            "antc_tr_pbmn": "72949040",
            "total_askp_rsqn": "33272",
            "total_bidp_rsqn": "173439"
        },
        {
            "stck_shrn_iscd": "Q580040",
            "hts_kor_isnm": "KB 인버스 2X KOSPI 200 선물 ETN",
            "stck_prpr": "13305",
            "prdy_vrss": "1205",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.96",
            "stck_sdpr": "12100",
            "seln_rsqn": "0",
            "askp": "0",
            "bidp": "12730",
            "shnu_rsqn": "69",
            "cntg_vol": "13",
            "antc_tr_pbmn": "172965",
            "total_askp_rsqn": "49927",
            "total_bidp_rsqn": "15061"
        },
        {
            "stck_shrn_iscd": "078150",
            "hts_kor_isnm": "HB테크놀러지",
            "stck_prpr": "2620",
            "prdy_vrss": "230",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.62",
            "stck_sdpr": "2390",
            "seln_rsqn": "53479",
            "askp": "2625",
            "bidp": "2620",
            "shnu_rsqn": "7114",
            "cntg_vol": "822185",
            "antc_tr_pbmn": "2154124700",
            "total_askp_rsqn": "332932",
            "total_bidp_rsqn": "206643"
        },
        {
            "stck_shrn_iscd": "094820",
            "hts_kor_isnm": "일진파워",
            "stck_prpr": "13470",
            "prdy_vrss": "1150",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.33",
            "stck_sdpr": "12320",
            "seln_rsqn": "7647",
            "askp": "13470",
            "bidp": "13460",
            "shnu_rsqn": "680",
            "cntg_vol": "46521",
            "antc_tr_pbmn": "626637870",
            "total_askp_rsqn": "6235",
            "total_bidp_rsqn": "8704"
        },
        {
            "stck_shrn_iscd": "193250",
            "hts_kor_isnm": "와이제이엠게임즈",
            "stck_prpr": "827",
            "prdy_vrss": "66",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.67",
            "stck_sdpr": "761",
            "seln_rsqn": "5014",
            "askp": "827",
            "bidp": "826",
            "shnu_rsqn": "41",
            "cntg_vol": "19093",
            "antc_tr_pbmn": "49621503",
            "total_askp_rsqn": "10094",
            "total_bidp_rsqn": "36639"
        },
        {
            "stck_shrn_iscd": "030350",
            "hts_kor_isnm": "드래곤플라이",
            "stck_prpr": "674",
            "prdy_vrss": "53",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.53",
            "stck_sdpr": "621",
            "seln_rsqn": "2351",
            "askp": "674",
            "bidp": "672",
            "shnu_rsqn": "2501",
            "cntg_vol": "1000046",
            "antc_tr_pbmn": "23279190",
            "total_askp_rsqn": "47302",
            "total_bidp_rsqn": "211603"
        },
        {
            "stck_shrn_iscd": "020760",
            "hts_kor_isnm": "일진디스플",
            "stck_prpr": "979",
            "prdy_vrss": "75",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "8.30",
            "stck_sdpr": "904",
            "seln_rsqn": "6015",
            "askp": "979",
            "bidp": "952",
            "shnu_rsqn": "220",
            "cntg_vol": "6214",
            "antc_tr_pbmn": "6083506",
            "total_askp_rsqn": "16585",
            "total_bidp_rsqn": "5613"
        },
        {
            "stck_shrn_iscd": "321370",
            "hts_kor_isnm": "센서뷰",
            "stck_prpr": "4420",
            "prdy_vrss": "320",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "7.80",
            "stck_sdpr": "4100",
            "seln_rsqn": "4038",
            "askp": "4420",
            "bidp": "4410",
            "shnu_rsqn": "291",
            "cntg_vol": "41019",
            "antc_tr_pbmn": "552669480",
            "total_askp_rsqn": "22631",
            "total_bidp_rsqn": "26665"
        },
        {
            "stck_shrn_iscd": "105740",
            "hts_kor_isnm": "디케이락",
            "stck_prpr": "8960",
            "prdy_vrss": "610",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "7.31",
            "stck_sdpr": "8350",
            "seln_rsqn": "1321",
            "askp": "8970",
            "bidp": "8960",
            "shnu_rsqn": "9811",
            "cntg_vol": "62727",
            "antc_tr_pbmn": "698595660",
            "total_askp_rsqn": "3450",
            "total_bidp_rsqn": "16822"
        },
        {
            "stck_shrn_iscd": "103590",
            "hts_kor_isnm": "일진전기",
            "stck_prpr": "15700",
            "prdy_vrss": "1020",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.95",
            "stck_sdpr": "14680",
            "seln_rsqn": "1163",
            "askp": "15710",
            "bidp": "15700",
            "shnu_rsqn": "8187",
            "cntg_vol": "111684",
            "antc_tr_pbmn": "959050680",
            "total_askp_rsqn": "3352",
            "total_bidp_rsqn": "50667"
        },
        {
            "stck_shrn_iscd": "101000",
            "hts_kor_isnm": "상상인인더스트리",
            "stck_prpr": "3690",
            "prdy_vrss": "235",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.80",
            "stck_sdpr": "3455",
            "seln_rsqn": "1078",
            "askp": "3690",
            "bidp": "3600",
            "shnu_rsqn": "408",
            "cntg_vol": "59127",
            "antc_tr_pbmn": "34685280",
            "total_askp_rsqn": "9513",
            "total_bidp_rsqn": "12837"
        },
        {
            "stck_shrn_iscd": "211050",
            "hts_kor_isnm": "인카금융서비스",
            "stck_prpr": "24000",
            "prdy_vrss": "1450",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.43",
            "stck_sdpr": "22550",
            "seln_rsqn": "823",
            "askp": "24000",
            "bidp": "22550",
            "shnu_rsqn": "122",
            "cntg_vol": "1958",
            "antc_tr_pbmn": "2436000",
            "total_askp_rsqn": "1066",
            "total_bidp_rsqn": "4599"
        },
        {
            "stck_shrn_iscd": "010660",
            "hts_kor_isnm": "화천기계",
            "stck_prpr": "6660",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.39",
            "stck_sdpr": "6260",
            "seln_rsqn": "1260",
            "askp": "6670",
            "bidp": "6660",
            "shnu_rsqn": "8959",
            "cntg_vol": "219634",
            "antc_tr_pbmn": "640185240",
            "total_askp_rsqn": "63618",
            "total_bidp_rsqn": "17278"
        },
        {
            "stck_shrn_iscd": "110020",
            "hts_kor_isnm": "전진바이오팜",
            "stck_prpr": "8500",
            "prdy_vrss": "490",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.12",
            "stck_sdpr": "8010",
            "seln_rsqn": "999",
            "askp": "8500",
            "bidp": "8240",
            "shnu_rsqn": "10",
            "cntg_vol": "11074",
            "antc_tr_pbmn": "94129000",
            "total_askp_rsqn": "15232",
            "total_bidp_rsqn": "8635"
        },
        {
            "stck_shrn_iscd": "095700",
            "hts_kor_isnm": "제넥신",
            "stck_prpr": "8790",
            "prdy_vrss": "500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.03",
            "stck_sdpr": "8290",
            "seln_rsqn": "899",
            "askp": "8790",
            "bidp": "8750",
            "shnu_rsqn": "6640",
            "cntg_vol": "23275",
            "antc_tr_pbmn": "204587250",
            "total_askp_rsqn": "6140",
            "total_bidp_rsqn": "10924"
        },
        {
            "stck_shrn_iscd": "276730",
            "hts_kor_isnm": "제주맥주",
            "stck_prpr": "1425",
            "prdy_vrss": "81",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.03",
            "stck_sdpr": "1344",
            "seln_rsqn": "2279",
            "askp": "1427",
            "bidp": "1425",
            "shnu_rsqn": "4898",
            "cntg_vol": "74274",
            "antc_tr_pbmn": "105840450",
            "total_askp_rsqn": "33433",
            "total_bidp_rsqn": "12694"
        },
        {
            "stck_shrn_iscd": "161580",
            "hts_kor_isnm": "필옵틱스",
            "stck_prpr": "17020",
            "prdy_vrss": "950",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.91",
            "stck_sdpr": "16070",
            "seln_rsqn": "916",
            "askp": "17030",
            "bidp": "17020",
            "shnu_rsqn": "3118",
            "cntg_vol": "191675",
            "antc_tr_pbmn": "3262308500",
            "total_askp_rsqn": "13074",
            "total_bidp_rsqn": "22881"
        },
        {
            "stck_shrn_iscd": "000040",
            "hts_kor_isnm": "KR모터스",
            "stck_prpr": "1624",
            "prdy_vrss": "90",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.87",
            "stck_sdpr": "1624",
            "seln_rsqn": "7317",
            "askp": "1624",
            "bidp": "1623",
            "shnu_rsqn": "1",
            "cntg_vol": "78804",
            "antc_tr_pbmn": "49541596",
            "total_askp_rsqn": "4228",
            "total_bidp_rsqn": "4191"
        },
        {
            "stck_shrn_iscd": "234920",
            "hts_kor_isnm": "자이글",
            "stck_prpr": "8940",
            "prdy_vrss": "490",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.80",
            "stck_sdpr": "8450",
            "seln_rsqn": "230",
            "askp": "8940",
            "bidp": "8920",
            "shnu_rsqn": "85",
            "cntg_vol": "4391",
            "antc_tr_pbmn": "39255540",
            "total_askp_rsqn": "2307",
            "total_bidp_rsqn": "7692"
        },
        {
            "stck_shrn_iscd": "297890",
            "hts_kor_isnm": "HB솔루션",
            "stck_prpr": "4370",
            "prdy_vrss": "215",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.17",
            "stck_sdpr": "4155",
            "seln_rsqn": "7844",
            "askp": "4370",
            "bidp": "4365",
            "shnu_rsqn": "3918",
            "cntg_vol": "116931",
            "antc_tr_pbmn": "510988470",
            "total_askp_rsqn": "183035",
            "total_bidp_rsqn": "40374"
        },
        {
            "stck_shrn_iscd": "457190",
            "hts_kor_isnm": "이수스페셜티케미컬",
            "stck_prpr": "360000",
            "prdy_vrss": "17500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.11",
            "stck_sdpr": "342500",
            "seln_rsqn": "144",
            "askp": "360500",
            "bidp": "360000",
            "shnu_rsqn": "73",
            "cntg_vol": "8151",
            "antc_tr_pbmn": "1575276500",
            "total_askp_rsqn": "5572",
            "total_bidp_rsqn": "1942"
        },
        {
            "stck_shrn_iscd": "060230",
            "hts_kor_isnm": "소니드",
            "stck_prpr": "2200",
            "prdy_vrss": "105",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.01",
            "stck_sdpr": "2095",
            "seln_rsqn": "296",
            "askp": "2200",
            "bidp": "2195",
            "shnu_rsqn": "630",
            "cntg_vol": "11412",
            "antc_tr_pbmn": "134993250",
            "total_askp_rsqn": "52480",
            "total_bidp_rsqn": "54345"
        },
        {
            "stck_shrn_iscd": "101670",
            "hts_kor_isnm": "하이드로리튬",
            "stck_prpr": "6490",
            "prdy_vrss": "300",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.85",
            "stck_sdpr": "6190",
            "seln_rsqn": "160",
            "askp": "6490",
            "bidp": "6480",
            "shnu_rsqn": "660",
            "cntg_vol": "39612",
            "antc_tr_pbmn": "734458480",
            "total_askp_rsqn": "97472",
            "total_bidp_rsqn": "88960"
        },
        {
            "stck_shrn_iscd": "303030",
            "hts_kor_isnm": "지니틱스",
            "stck_prpr": "2275",
            "prdy_vrss": "105",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.84",
            "stck_sdpr": "2170",
            "seln_rsqn": "922",
            "askp": "2275",
            "bidp": "2255",
            "shnu_rsqn": "6749",
            "cntg_vol": "9329",
            "antc_tr_pbmn": "21223475",
            "total_askp_rsqn": "24653",
            "total_bidp_rsqn": "32378"
        },
        {
            "stck_shrn_iscd": "017940",
            "hts_kor_isnm": "E1",
            "stck_prpr": "73800",
            "prdy_vrss": "3400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.83",
            "stck_sdpr": "70400",
            "seln_rsqn": "306",
            "askp": "73800",
            "bidp": "73700",
            "shnu_rsqn": "24",
            "cntg_vol": "7337",
            "antc_tr_pbmn": "541470600",
            "total_askp_rsqn": "1165",
            "total_bidp_rsqn": "2062"
        },
        {
            "stck_shrn_iscd": "237690",
            "hts_kor_isnm": "에스티팜",
            "stck_prpr": "81300",
            "prdy_vrss": "3700",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.77",
            "stck_sdpr": "77600",
            "seln_rsqn": "834",
            "askp": "81400",
            "bidp": "81300",
            "shnu_rsqn": "312",
            "cntg_vol": "14128",
            "antc_tr_pbmn": "1147201200",
            "total_askp_rsqn": "9707",
            "total_bidp_rsqn": "10412"
        },
        {
            "stck_shrn_iscd": "082210",
            "hts_kor_isnm": "옵트론텍",
            "stck_prpr": "4300",
            "prdy_vrss": "185",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.50",
            "stck_sdpr": "4115",
            "seln_rsqn": "327",
            "askp": "4305",
            "bidp": "4300",
            "shnu_rsqn": "2099",
            "cntg_vol": "30755",
            "antc_tr_pbmn": "132246500",
            "total_askp_rsqn": "10418",
            "total_bidp_rsqn": "25612"
        },
        {
            "stck_shrn_iscd": "049120",
            "hts_kor_isnm": "파인디앤씨",
            "stck_prpr": "1385",
            "prdy_vrss": "59",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.45",
            "stck_sdpr": "1326",
            "seln_rsqn": "973",
            "askp": "1429",
            "bidp": "1385",
            "shnu_rsqn": "830",
            "cntg_vol": "442",
            "antc_tr_pbmn": "612170",
            "total_askp_rsqn": "4905",
            "total_bidp_rsqn": "8454"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 당사매매종목 상위[v1_국내주식-104]

REST

국내주식 당사매매종목 상위[v1_국내주식-104]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/traded-by-company
  • Format
     
  • Content-Type
     

개요

국내주식 당사매매종목 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0186] 당사매매종목 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01860000
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_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0: 전체
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key(20186)
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보통주, 7:우선주
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0:매도상위,1:매수상위
fid_input_date_1 입력 날짜1 String Y 10 기간~
fid_input_date_2 입력 날짜2 String Y 10 ~기간
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100
fid_trgt_cls_code 대상 구분 코드 String Y 32 0: 전체
fid_aply_rang_vol 적용 범위 거래량 String Y 18 0: 전체, 100: 100주 이상
fid_aply_rang_prc_2 적용 범위 가격2 String Y 18 ~ 가격
fid_aply_rang_prc_1 적용 범위 가격1 String Y 18 가격 ~

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
-data_rank 데이터 순위 String Y 10
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-acml_tr_pbmn 누적 거래 대금 String Y 18
-seln_cnqn_smtn 매도 체결량 합계 String Y 18
-shnu_cnqn_smtn 매수2 체결량 합계 String Y 18
-ntby_cnqn 순매수 체결량 String Y 18

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20186",
"fid_div_cls_code":"0",
"fid_rank_sort_cls_code":"0",
"fid_input_date_1":"20240314",
"fid_input_date_2":"20240315",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_aply_rang_prc_1":"",
"fid_aply_rang_prc_2":"",
"fid_aply_rang_vol":"0"
}

Response

{
    "output": [
        {
            "data_rank": "1",
            "mksc_shrn_iscd": "Q530036",
            "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
            "stck_prpr": "92",
            "prdy_vrss_sign": "3",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "5800370",
            "acml_tr_pbmn": "533513365",
            "seln_cnqn_smtn": "8248448",
            "shnu_cnqn_smtn": "4633200",
            "ntby_cnqn": "-3615248"
        },
        {
            "data_rank": "2",
            "mksc_shrn_iscd": "252670",
            "hts_kor_isnm": "KODEX 200선물인버스2X",
            "stck_prpr": "2175",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-5",
            "prdy_ctrt": "-0.23",
            "acml_vol": "55781783",
            "acml_tr_pbmn": "121550061085",
            "seln_cnqn_smtn": "27416314",
            "shnu_cnqn_smtn": "25991495",
            "ntby_cnqn": "-1424819"
        },
        {
            "data_rank": "3",
            "mksc_shrn_iscd": "025320",
            "hts_kor_isnm": "시노펙스",
            "stck_prpr": "10860",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "830",
            "prdy_ctrt": "8.28",
            "acml_vol": "4687707",
            "acml_tr_pbmn": "49125642180",
            "seln_cnqn_smtn": "5824623",
            "shnu_cnqn_smtn": "4909381",
            "ntby_cnqn": "-915242"
        },
        {
            "data_rank": "4",
            "mksc_shrn_iscd": "290690",
            "hts_kor_isnm": "소룩스",
            "stck_prpr": "2550",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "80",
            "prdy_ctrt": "3.24",
            "acml_vol": "2932021",
            "acml_tr_pbmn": "7432512210",
            "seln_cnqn_smtn": "1297638",
            "shnu_cnqn_smtn": "485714",
            "ntby_cnqn": "-811924"
        },
        {
            "data_rank": "5",
            "mksc_shrn_iscd": "453850",
            "hts_kor_isnm": "ACE 미국30년국채액티브(H)",
            "stck_prpr": "8555",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-15",
            "prdy_ctrt": "-0.18",
            "acml_vol": "535802",
            "acml_tr_pbmn": "4573586665",
            "seln_cnqn_smtn": "1416392",
            "shnu_cnqn_smtn": "622450",
            "ntby_cnqn": "-793942"
        },
        {
            "data_rank": "6",
            "mksc_shrn_iscd": "217620",
            "hts_kor_isnm": "디딤이앤에프",
            "stck_prpr": "422",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-19",
            "prdy_ctrt": "-4.31",
            "acml_vol": "4011940",
            "acml_tr_pbmn": "1603037358",
            "seln_cnqn_smtn": "3775356",
            "shnu_cnqn_smtn": "3104696",
            "ntby_cnqn": "-670660"
        },
        {
            "data_rank": "7",
            "mksc_shrn_iscd": "122630",
            "hts_kor_isnm": "KODEX 레버리지",
            "stck_prpr": "18620",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "75",
            "prdy_ctrt": "0.40",
            "acml_vol": "8919461",
            "acml_tr_pbmn": "165416410545",
            "seln_cnqn_smtn": "4396350",
            "shnu_cnqn_smtn": "3776614",
            "ntby_cnqn": "-619736"
        },
        {
            "data_rank": "8",
            "mksc_shrn_iscd": "900300",
            "hts_kor_isnm": "오가닉티코스메틱",
            "stck_prpr": "79",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "2",
            "prdy_ctrt": "2.60",
            "acml_vol": "1282716",
            "acml_tr_pbmn": "99560857",
            "seln_cnqn_smtn": "813110",
            "shnu_cnqn_smtn": "263052",
            "ntby_cnqn": "-550058"
        },
        {
            "data_rank": "9",
            "mksc_shrn_iscd": "003620",
            "hts_kor_isnm": "KG모빌리티",
            "stck_prpr": "7850",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "10",
            "prdy_ctrt": "0.13",
            "acml_vol": "154906",
            "acml_tr_pbmn": "1216385130",
            "seln_cnqn_smtn": "463658",
            "shnu_cnqn_smtn": "72251",
            "ntby_cnqn": "-391407"
        },
        {
            "data_rank": "10",
            "mksc_shrn_iscd": "271050",
            "hts_kor_isnm": "KODEX WTI원유선물인버스(H)",
            "stck_prpr": "4185",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-15",
            "prdy_ctrt": "-0.36",
            "acml_vol": "133001",
            "acml_tr_pbmn": "557302930",
            "seln_cnqn_smtn": "479478",
            "shnu_cnqn_smtn": "94195",
            "ntby_cnqn": "-385283"
        },
        {
            "data_rank": "11",
            "mksc_shrn_iscd": "227950",
            "hts_kor_isnm": "엔투텍",
            "stck_prpr": "787",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1",
            "prdy_ctrt": "0.13",
            "acml_vol": "531903",
            "acml_tr_pbmn": "421143789",
            "seln_cnqn_smtn": "978263",
            "shnu_cnqn_smtn": "593139",
            "ntby_cnqn": "-385124"
        },
        {
            "data_rank": "12",
            "mksc_shrn_iscd": "003410",
            "hts_kor_isnm": "쌍용C&E",
            "stck_prpr": "7000",
            "prdy_vrss_sign": "3",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "150020",
            "acml_tr_pbmn": "1050492840",
            "seln_cnqn_smtn": "605368",
            "shnu_cnqn_smtn": "221741",
            "ntby_cnqn": "-383627"
        },
        {
            "data_rank": "13",
            "mksc_shrn_iscd": "446770",
            "hts_kor_isnm": "ACE 글로벌반도체TOP4 Plus SOLACTIVE",
            "stck_prpr": "21540",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-210",
            "prdy_ctrt": "-0.97",
            "acml_vol": "121124",
            "acml_tr_pbmn": "2608030145",
            "seln_cnqn_smtn": "557891",
            "shnu_cnqn_smtn": "202444",
            "ntby_cnqn": "-355447"
        },
        {
            "data_rank": "14",
            "mksc_shrn_iscd": "012170",
            "hts_kor_isnm": "아센디오",
            "stck_prpr": "1066",
            "prdy_vrss_sign": "3",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "acml_vol": "2719320",
            "acml_tr_pbmn": "2937797895",
            "seln_cnqn_smtn": "4579213",
            "shnu_cnqn_smtn": "4278634",
            "ntby_cnqn": "-300579"
        },
        {
            "data_rank": "15",
            "mksc_shrn_iscd": "305720",
            "hts_kor_isnm": "KODEX 2차전지산업",
            "stck_prpr": "22090",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "290",
            "prdy_ctrt": "1.33",
            "acml_vol": "476994",
            "acml_tr_pbmn": "10501325940",
            "seln_cnqn_smtn": "669969",
            "shnu_cnqn_smtn": "381247",
            "ntby_cnqn": "-288722"
        },
        {
            "data_rank": "16",
            "mksc_shrn_iscd": "455850",
            "hts_kor_isnm": "SOL AI반도체소부장",
            "stck_prpr": "14950",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "180",
            "prdy_ctrt": "1.22",
            "acml_vol": "317328",
            "acml_tr_pbmn": "4715313100",
            "seln_cnqn_smtn": "513395",
            "shnu_cnqn_smtn": "228189",
            "ntby_cnqn": "-285206"
        },
        {
            "data_rank": "17",
            "mksc_shrn_iscd": "018000",
            "hts_kor_isnm": "유니슨",
            "stck_prpr": "1168",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "150",
            "prdy_ctrt": "14.73",
            "acml_vol": "5280049",
            "acml_tr_pbmn": "6263011909",
            "seln_cnqn_smtn": "407197",
            "shnu_cnqn_smtn": "124444",
            "ntby_cnqn": "-282753"
        },
        {
            "data_rank": "18",
            "mksc_shrn_iscd": "096350",
            "hts_kor_isnm": "대창솔루션",
            "stck_prpr": "498",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "4",
            "prdy_ctrt": "0.81",
            "acml_vol": "442715",
            "acml_tr_pbmn": "220176716",
            "seln_cnqn_smtn": "502574",
            "shnu_cnqn_smtn": "246358",
            "ntby_cnqn": "-256216"
        },
        {
            "data_rank": "19",
            "mksc_shrn_iscd": "474590",
            "hts_kor_isnm": "WOORI 반도체밸류체인액티브",
            "stck_prpr": "11080",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "95",
            "prdy_ctrt": "0.86",
            "acml_vol": "18",
            "acml_tr_pbmn": "198175",
            "seln_cnqn_smtn": "248406",
            "shnu_cnqn_smtn": "3999",
            "ntby_cnqn": "-244407"
        },
        {
            "data_rank": "20",
            "mksc_shrn_iscd": "007460",
            "hts_kor_isnm": "에이프로젠",
            "stck_prpr": "1084",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "12",
            "prdy_ctrt": "1.12",
            "acml_vol": "5282705",
            "acml_tr_pbmn": "5806140076",
            "seln_cnqn_smtn": "3418267",
            "shnu_cnqn_smtn": "3192395",
            "ntby_cnqn": "-225872"
        },
        {
            "data_rank": "21",
            "mksc_shrn_iscd": "088350",
            "hts_kor_isnm": "한화생명",
            "stck_prpr": "3185",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-65",
            "prdy_ctrt": "-2.00",
            "acml_vol": "1005843",
            "acml_tr_pbmn": "3216904250",
            "seln_cnqn_smtn": "795617",
            "shnu_cnqn_smtn": "589311",
            "ntby_cnqn": "-206306"
        },
        {
            "data_rank": "22",
            "mksc_shrn_iscd": "323230",
            "hts_kor_isnm": "엠에프엠코리아",
            "stck_prpr": "608",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-2",
            "prdy_ctrt": "-0.33",
            "acml_vol": "701312",
            "acml_tr_pbmn": "425004195",
            "seln_cnqn_smtn": "1357154",
            "shnu_cnqn_smtn": "1169986",
            "ntby_cnqn": "-187168"
        },
        {
            "data_rank": "23",
            "mksc_shrn_iscd": "053030",
            "hts_kor_isnm": "바이넥스",
            "stck_prpr": "18030",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1570",
            "prdy_ctrt": "9.54",
            "acml_vol": "7593833",
            "acml_tr_pbmn": "133713682520",
            "seln_cnqn_smtn": "1770115",
            "shnu_cnqn_smtn": "1590560",
            "ntby_cnqn": "-179555"
        },
        {
            "data_rank": "24",
            "mksc_shrn_iscd": "287410",
            "hts_kor_isnm": "제이시스메디칼",
            "stck_prpr": "7690",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "60",
            "prdy_ctrt": "0.79",
            "acml_vol": "171896",
            "acml_tr_pbmn": "1326481640",
            "seln_cnqn_smtn": "298796",
            "shnu_cnqn_smtn": "128249",
            "ntby_cnqn": "-170547"
        },
        {
            "data_rank": "25",
            "mksc_shrn_iscd": "462330",
            "hts_kor_isnm": "KODEX 2차전지산업레버리지",
            "stck_prpr": "4690",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "100",
            "prdy_ctrt": "2.18",
            "acml_vol": "1042444",
            "acml_tr_pbmn": "4855711260",
            "seln_cnqn_smtn": "648426",
            "shnu_cnqn_smtn": "481012",
            "ntby_cnqn": "-167414"
        },
        {
            "data_rank": "26",
            "mksc_shrn_iscd": "034220",
            "hts_kor_isnm": "LG디스플레이",
            "stck_prpr": "11060",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-120",
            "prdy_ctrt": "-1.07",
            "acml_vol": "208580",
            "acml_tr_pbmn": "2314630570",
            "seln_cnqn_smtn": "430800",
            "shnu_cnqn_smtn": "277677",
            "ntby_cnqn": "-153123"
        },
        {
            "data_rank": "27",
            "mksc_shrn_iscd": "316140",
            "hts_kor_isnm": "우리금융지주",
            "stck_prpr": "14780",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-450",
            "prdy_ctrt": "-2.95",
            "acml_vol": "2032465",
            "acml_tr_pbmn": "30023382510",
            "seln_cnqn_smtn": "898309",
            "shnu_cnqn_smtn": "745834",
            "ntby_cnqn": "-152475"
        },
        {
            "data_rank": "28",
            "mksc_shrn_iscd": "091170",
            "hts_kor_isnm": "KODEX 은행",
            "stck_prpr": "8480",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-185",
            "prdy_ctrt": "-2.14",
            "acml_vol": "633020",
            "acml_tr_pbmn": "5343176250",
            "seln_cnqn_smtn": "657061",
            "shnu_cnqn_smtn": "506916",
            "ntby_cnqn": "-150145"
        },
        {
            "data_rank": "29",
            "mksc_shrn_iscd": "015590",
            "hts_kor_isnm": "KIB플러그에너지",
            "stck_prpr": "377",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-2",
            "prdy_ctrt": "-0.53",
            "acml_vol": "1338633",
            "acml_tr_pbmn": "505056784",
            "seln_cnqn_smtn": "517713",
            "shnu_cnqn_smtn": "370216",
            "ntby_cnqn": "-147497"
        },
        {
            "data_rank": "30",
            "mksc_shrn_iscd": "004870",
            "hts_kor_isnm": "티웨이홀딩스",
            "stck_prpr": "465",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "9",
            "prdy_ctrt": "1.97",
            "acml_vol": "34028",
            "acml_tr_pbmn": "15695619",
            "seln_cnqn_smtn": "186276",
            "shnu_cnqn_smtn": "39824",
            "ntby_cnqn": "-146452"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 신고/신저근접종목 상위[v1_국내주식-105]

REST

국내주식 신고/신저근접종목 상위[v1_국내주식-105]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/near-new-highlow
  • Format
     
  • Content-Type
     

개요

국내주식 신고/신저근접종목 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0187] 신고/신저 근접종목 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST01870000
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_aply_rang_vol 적용 범위 거래량 String Y 18 0: 전체, 100: 100주 이상
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key(20187)
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체, 1:관리종목, 2:투자주의, 3:투자경고
fid_input_cnt_1 입력 수1 String Y 2 괴리율 최소
fid_input_cnt_2 입력 수2 String Y 10 괴리율 최대
fid_prc_cls_code 가격 구분 코드 String Y 10 0:신고근접, 1:신저근접
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100
fid_trgt_cls_code 대상 구분 코드 String Y 32 0: 전체
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0:전체, 1:관리종목, 2:투자주의, 3:투자경고, 4:투자위험예고, 5:투자위험, 6:보통주, 7:우선주
fid_aply_rang_prc_1 적용 범위 가격1 String Y 18 가격 ~
fid_aply_rang_prc_2 적용 범위 가격2 String Y 18 ~ 가격

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
-hts_kor_isnm HTS 한글 종목명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-askp 매도호가 String Y 10
-askp_rsqn1 매도호가 잔량1 String Y 12
-bidp 매수호가 String Y 10
-bidp_rsqn1 매수호가 잔량1 String Y 12
-acml_vol 누적 거래량 String Y 18
-new_hgpr 신 최고가 String Y 10
-hprc_near_rate 고가 근접 비율 String Y 84
-new_lwpr 신 최저가 String Y 10
-lwpr_near_rate 저가 근접 비율 String Y 84
-stck_sdpr 주식 기준가 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20187",
"fid_div_cls_code":"0",
"fid_input_cnt_1":"",
"fid_input_cnt_2":"",
"fid_prc_cls_code":"0",
"fid_input_iscd":"0000",
"fid_trgt_cls_code":"0",
"fid_trgt_exls_cls_code":"0",
"fid_aply_rang_prc_1":"",
"fid_aply_rang_prc_2":"",
"fid_aply_rang_vol":"0"
}

Response

{
    "output": [
        {
            "hts_kor_isnm": "IHQ",
            "mksc_shrn_iscd": "003560",
            "stck_prpr": "10760",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "10760",
            "hprc_near_rate": "0.00",
            "new_lwpr": "185",
            "lwpr_near_rate": "-98.28",
            "stck_sdpr": "10760"
        },
        {
            "hts_kor_isnm": "선도전기",
            "mksc_shrn_iscd": "007610",
            "stck_prpr": "3000",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "3000",
            "hprc_near_rate": "0.00",
            "new_lwpr": "3000",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "3000"
        },
        {
            "hts_kor_isnm": "청호ICT",
            "mksc_shrn_iscd": "012600",
            "stck_prpr": "2490",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2490",
            "hprc_near_rate": "0.00",
            "new_lwpr": "2490",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "2490"
        },
        {
            "hts_kor_isnm": "광림",
            "mksc_shrn_iscd": "014200",
            "stck_prpr": "1006",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "1006",
            "hprc_near_rate": "0.00",
            "new_lwpr": "1006",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "1006"
        },
        {
            "hts_kor_isnm": "비케이탑스",
            "mksc_shrn_iscd": "030790",
            "stck_prpr": "904",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "904",
            "hprc_near_rate": "0.00",
            "new_lwpr": "904",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "904"
        },
        {
            "hts_kor_isnm": "더라미",
            "mksc_shrn_iscd": "032860",
            "stck_prpr": "3640",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "3640",
            "hprc_near_rate": "0.00",
            "new_lwpr": "3640",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "3640"
        },
        {
            "hts_kor_isnm": "KH 필룩스",
            "mksc_shrn_iscd": "033180",
            "stck_prpr": "6630",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "6630",
            "hprc_near_rate": "0.00",
            "new_lwpr": "325",
            "lwpr_near_rate": "-95.10",
            "stck_sdpr": "6630"
        },
        {
            "hts_kor_isnm": "좋은사람들",
            "mksc_shrn_iscd": "033340",
            "stck_prpr": "2110",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2110",
            "hprc_near_rate": "0.00",
            "new_lwpr": "2110",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "2110"
        },
        {
            "hts_kor_isnm": "한국테크놀로지",
            "mksc_shrn_iscd": "053590",
            "stck_prpr": "334",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "334",
            "hprc_near_rate": "0.00",
            "new_lwpr": "334",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "334"
        },
        {
            "hts_kor_isnm": "이노시스",
            "mksc_shrn_iscd": "056090",
            "stck_prpr": "1180",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "1180",
            "hprc_near_rate": "0.00",
            "new_lwpr": "1180",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "1180"
        },
        {
            "hts_kor_isnm": "피에이치씨",
            "mksc_shrn_iscd": "057880",
            "stck_prpr": "17570",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "17570",
            "hprc_near_rate": "0.00",
            "new_lwpr": "1740",
            "lwpr_near_rate": "-90.10",
            "stck_sdpr": "17570"
        },
        {
            "hts_kor_isnm": "아리온",
            "mksc_shrn_iscd": "058220",
            "stck_prpr": "275",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "275",
            "hprc_near_rate": "0.00",
            "new_lwpr": "275",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "275"
        },
        {
            "hts_kor_isnm": "파나케이아",
            "mksc_shrn_iscd": "058530",
            "stck_prpr": "1620",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "1620",
            "hprc_near_rate": "0.00",
            "new_lwpr": "1620",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "1620"
        },
        {
            "hts_kor_isnm": "티엘아이",
            "mksc_shrn_iscd": "062860",
            "stck_prpr": "5800",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "5800",
            "hprc_near_rate": "0.00",
            "new_lwpr": "5800",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "5800"
        },
        {
            "hts_kor_isnm": "녹원씨엔아이",
            "mksc_shrn_iscd": "065560",
            "stck_prpr": "11540",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "11540",
            "hprc_near_rate": "0.00",
            "new_lwpr": "5770",
            "lwpr_near_rate": "-50.00",
            "stck_sdpr": "11540"
        },
        {
            "hts_kor_isnm": "버킷스튜디오",
            "mksc_shrn_iscd": "066410",
            "stck_prpr": "1153",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "1153",
            "hprc_near_rate": "0.00",
            "new_lwpr": "1153",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "1153"
        },
        {
            "hts_kor_isnm": "국일제지",
            "mksc_shrn_iscd": "078130",
            "stck_prpr": "800",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "800",
            "hprc_near_rate": "0.00",
            "new_lwpr": "800",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "800"
        },
        {
            "hts_kor_isnm": "세원이앤씨",
            "mksc_shrn_iscd": "091090",
            "stck_prpr": "1270",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "1270",
            "hprc_near_rate": "0.00",
            "new_lwpr": "185",
            "lwpr_near_rate": "-85.43",
            "stck_sdpr": "1270"
        },
        {
            "hts_kor_isnm": "인바이오젠",
            "mksc_shrn_iscd": "101140",
            "stck_prpr": "9340",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "9340",
            "hprc_near_rate": "0.00",
            "new_lwpr": "462",
            "lwpr_near_rate": "-95.05",
            "stck_sdpr": "9340"
        },
        {
            "hts_kor_isnm": "주성코퍼레이션",
            "mksc_shrn_iscd": "109070",
            "stck_prpr": "4100",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "4100",
            "hprc_near_rate": "0.00",
            "new_lwpr": "4100",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "4100"
        },
        {
            "hts_kor_isnm": "KH 전자",
            "mksc_shrn_iscd": "111870",
            "stck_prpr": "2970",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2970",
            "hprc_near_rate": "0.00",
            "new_lwpr": "145",
            "lwpr_near_rate": "-95.12",
            "stck_sdpr": "2970"
        },
        {
            "hts_kor_isnm": "스마트솔루션즈",
            "mksc_shrn_iscd": "136510",
            "stck_prpr": "11600",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "11600",
            "hprc_near_rate": "0.00",
            "new_lwpr": "11600",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "11600"
        },
        {
            "hts_kor_isnm": "비디아이",
            "mksc_shrn_iscd": "148140",
            "stck_prpr": "6140",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "6140",
            "hprc_near_rate": "0.00",
            "new_lwpr": "640",
            "lwpr_near_rate": "-89.58",
            "stck_sdpr": "6140"
        },
        {
            "hts_kor_isnm": "인트로메딕",
            "mksc_shrn_iscd": "150840",
            "stck_prpr": "5850",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "5850",
            "hprc_near_rate": "0.00",
            "new_lwpr": "5850",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "5850"
        },
        {
            "hts_kor_isnm": "이큐셀",
            "mksc_shrn_iscd": "160600",
            "stck_prpr": "3100",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "3100",
            "hprc_near_rate": "0.00",
            "new_lwpr": "3100",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "3100"
        },
        {
            "hts_kor_isnm": "장원테크",
            "mksc_shrn_iscd": "174880",
            "stck_prpr": "2650",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2650",
            "hprc_near_rate": "0.00",
            "new_lwpr": "455",
            "lwpr_near_rate": "-82.83",
            "stck_sdpr": "2650"
        },
        {
            "hts_kor_isnm": "일월지엠엘",
            "mksc_shrn_iscd": "178780",
            "stck_prpr": "8650",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "8650",
            "hprc_near_rate": "0.00",
            "new_lwpr": "8650",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "8650"
        },
        {
            "hts_kor_isnm": "이즈미디어",
            "mksc_shrn_iscd": "181340",
            "stck_prpr": "2705",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2705",
            "hprc_near_rate": "0.00",
            "new_lwpr": "2705",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "2705"
        },
        {
            "hts_kor_isnm": "KODEX 미국S&P500산업재(합성)",
            "mksc_shrn_iscd": "200030",
            "stck_prpr": "28335",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "200",
            "prdy_ctrt": "0.71",
            "askp": "28330",
            "askp_rsqn1": "5000",
            "bidp": "28270",
            "bidp_rsqn1": "7",
            "acml_vol": "4998",
            "new_hgpr": "28335",
            "hprc_near_rate": "0.00",
            "new_lwpr": "21600",
            "lwpr_near_rate": "-23.77",
            "stck_sdpr": "28135"
        },
        {
            "hts_kor_isnm": "엔지스테크널러지",
            "mksc_shrn_iscd": "208860",
            "stck_prpr": "2205",
            "prdy_vrss_sign": "0",
            "prdy_vrss": "0",
            "prdy_ctrt": "0.00",
            "askp": "0",
            "askp_rsqn1": "0",
            "bidp": "0",
            "bidp_rsqn1": "0",
            "acml_vol": "0",
            "new_hgpr": "2205",
            "hprc_near_rate": "0.00",
            "new_lwpr": "2205",
            "lwpr_near_rate": "0.00",
            "stck_sdpr": "2205"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 대량체결건수 상위[국내주식-107]

REST

국내주식 대량체결건수 상위[국내주식-107]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/bulk-trans-num
  • Format
     
  • Content-Type
     

개요

국내주식 대량체결건수 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0169] 대량체결건수 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHKST190900C0
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_aply_rang_prc_2 적용 범위 가격2 String Y 18 ~ 가격
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_cond_scr_div_code 조건 화면 분류 코드 String Y 5 Unique key(11909)
fid_input_iscd 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200, 4001: KRX100
fid_rank_sort_cls_code 순위 정렬 구분 코드 String Y 2 0:매수상위, 1:매도상위
fid_div_cls_code 분류 구분 코드 String Y 2 0:전체
fid_input_price_1 입력 가격1 String Y 12 건별금액 ~
fid_aply_rang_prc_1 적용 범위 가격1 String Y 18 가격 ~
fid_input_iscd_2 입력 종목코드2 String Y 8 공백:전체종목, 개별종목 조회시 종목코드 (000660)
fid_trgt_exls_cls_code 대상 제외 구분 코드 String Y 32 0:전체
fid_trgt_cls_code 대상 구분 코드 String Y 32 0:전체
fid_vol_cnt 거래량 수 String Y 12 거래량 ~

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-data_rank 데이터 순위 String Y 10
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-shnu_cntg_csnu 매수2 체결 건수 String Y 10
-seln_cntg_csnu 매도 체결 건수 String Y 10
-ntby_cnqn 순매수 체결량 String Y 18

Example

Request

{
    "output": [
        {
            "mksc_shrn_iscd": "000660",
            "data_rank": "1",
            "hts_kor_isnm": "SK하이닉스",
            "stck_prpr": "162600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1400",
            "prdy_ctrt": "0.87",
            "acml_vol": "1593227",
            "shnu_cntg_csnu": "3172",
            "seln_cntg_csnu": "2104",
            "ntby_cnqn": "1068"
        },
        {
            "mksc_shrn_iscd": "207940",
            "data_rank": "2",
            "hts_kor_isnm": "삼성바이오로직스",
            "stck_prpr": "869000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "43000",
            "prdy_ctrt": "5.21",
            "acml_vol": "140772",
            "shnu_cntg_csnu": "1446",
            "seln_cntg_csnu": "725",
            "ntby_cnqn": "721"
        },
        {
            "mksc_shrn_iscd": "006400",
            "data_rank": "3",
            "hts_kor_isnm": "삼성SDI",
            "stck_prpr": "444000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "19000",
            "prdy_ctrt": "4.47",
            "acml_vol": "441633",
            "shnu_cntg_csnu": "2167",
            "seln_cntg_csnu": "1488",
            "ntby_cnqn": "679"
        },
        {
            "mksc_shrn_iscd": "007660",
            "data_rank": "4",
            "hts_kor_isnm": "이수페타시스",
            "stck_prpr": "37150",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "3700",
            "prdy_ctrt": "11.06",
            "acml_vol": "7737796",
            "shnu_cntg_csnu": "2920",
            "seln_cntg_csnu": "2361",
            "ntby_cnqn": "559"
        },
        {
            "mksc_shrn_iscd": "112040",
            "data_rank": "5",
            "hts_kor_isnm": "위메이드",
            "stck_prpr": "67100",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "10900",
            "prdy_ctrt": "19.40",
            "acml_vol": "3088002",
            "shnu_cntg_csnu": "2150",
            "seln_cntg_csnu": "1697",
            "ntby_cnqn": "453"
        },
        {
            "mksc_shrn_iscd": "457190",
            "data_rank": "6",
            "hts_kor_isnm": "이수스페셜티케미컬",
            "stck_prpr": "389500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "47000",
            "prdy_ctrt": "13.72",
            "acml_vol": "671298",
            "shnu_cntg_csnu": "2582",
            "seln_cntg_csnu": "2201",
            "ntby_cnqn": "381"
        },
        {
            "mksc_shrn_iscd": "454910",
            "data_rank": "7",
            "hts_kor_isnm": "두산로보틱스",
            "stck_prpr": "92900",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "5800",
            "prdy_ctrt": "6.66",
            "acml_vol": "1169659",
            "shnu_cntg_csnu": "1214",
            "seln_cntg_csnu": "836",
            "ntby_cnqn": "378"
        },
        {
            "mksc_shrn_iscd": "441540",
            "data_rank": "8",
            "hts_kor_isnm": "HANARO Fn조선해운",
            "stck_prpr": "10610",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "245",
            "prdy_ctrt": "2.36",
            "acml_vol": "2423370",
            "shnu_cntg_csnu": "458",
            "seln_cntg_csnu": "82",
            "ntby_cnqn": "376"
        },
        {
            "mksc_shrn_iscd": "066970",
            "data_rank": "9",
            "hts_kor_isnm": "엘앤에프",
            "stck_prpr": "174700",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "12500",
            "prdy_ctrt": "7.71",
            "acml_vol": "424191",
            "shnu_cntg_csnu": "676",
            "seln_cntg_csnu": "328",
            "ntby_cnqn": "348"
        },
        {
            "mksc_shrn_iscd": "006260",
            "data_rank": "10",
            "hts_kor_isnm": "LS",
            "stck_prpr": "111000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "6900",
            "prdy_ctrt": "6.63",
            "acml_vol": "475967",
            "shnu_cntg_csnu": "831",
            "seln_cntg_csnu": "510",
            "ntby_cnqn": "321"
        },
        {
            "mksc_shrn_iscd": "247540",
            "data_rank": "11",
            "hts_kor_isnm": "에코프로비엠",
            "stck_prpr": "265500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "9000",
            "prdy_ctrt": "3.51",
            "acml_vol": "484949",
            "shnu_cntg_csnu": "1320",
            "seln_cntg_csnu": "1004",
            "ntby_cnqn": "316"
        },
        {
            "mksc_shrn_iscd": "051910",
            "data_rank": "12",
            "hts_kor_isnm": "LG화학",
            "stck_prpr": "441500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "10500",
            "prdy_ctrt": "2.44",
            "acml_vol": "119939",
            "shnu_cntg_csnu": "708",
            "seln_cntg_csnu": "399",
            "ntby_cnqn": "309"
        },
        {
            "mksc_shrn_iscd": "196170",
            "data_rank": "13",
            "hts_kor_isnm": "알테오젠",
            "stck_prpr": "209500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "5000",
            "prdy_ctrt": "2.44",
            "acml_vol": "1859846",
            "shnu_cntg_csnu": "3637",
            "seln_cntg_csnu": "3379",
            "ntby_cnqn": "258"
        },
        {
            "mksc_shrn_iscd": "042660",
            "data_rank": "14",
            "hts_kor_isnm": "한화오션",
            "stck_prpr": "28850",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1850",
            "prdy_ctrt": "6.85",
            "acml_vol": "3370897",
            "shnu_cntg_csnu": "1112",
            "seln_cntg_csnu": "856",
            "ntby_cnqn": "256"
        },
        {
            "mksc_shrn_iscd": "000270",
            "data_rank": "15",
            "hts_kor_isnm": "기아",
            "stck_prpr": "127500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "2500",
            "prdy_ctrt": "2.00",
            "acml_vol": "866368",
            "shnu_cntg_csnu": "1342",
            "seln_cntg_csnu": "1110",
            "ntby_cnqn": "232"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "000660",
            "data_rank": "1",
            "hts_kor_isnm": "SK하이닉스",
            "stck_prpr": "162600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1400",
            "prdy_ctrt": "0.87",
            "acml_vol": "1593227",
            "shnu_cntg_csnu": "3172",
            "seln_cntg_csnu": "2104",
            "ntby_cnqn": "1068"
        },
        {
            "mksc_shrn_iscd": "207940",
            "data_rank": "2",
            "hts_kor_isnm": "삼성바이오로직스",
            "stck_prpr": "869000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "43000",
            "prdy_ctrt": "5.21",
            "acml_vol": "140772",
            "shnu_cntg_csnu": "1446",
            "seln_cntg_csnu": "725",
            "ntby_cnqn": "721"
        },
        {
            "mksc_shrn_iscd": "006400",
            "data_rank": "3",
            "hts_kor_isnm": "삼성SDI",
            "stck_prpr": "444000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "19000",
            "prdy_ctrt": "4.47",
            "acml_vol": "441633",
            "shnu_cntg_csnu": "2167",
            "seln_cntg_csnu": "1488",
            "ntby_cnqn": "679"
        },
        {
            "mksc_shrn_iscd": "007660",
            "data_rank": "4",
            "hts_kor_isnm": "이수페타시스",
            "stck_prpr": "37150",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "3700",
            "prdy_ctrt": "11.06",
            "acml_vol": "7737796",
            "shnu_cntg_csnu": "2920",
            "seln_cntg_csnu": "2361",
            "ntby_cnqn": "559"
        },
        {
            "mksc_shrn_iscd": "112040",
            "data_rank": "5",
            "hts_kor_isnm": "위메이드",
            "stck_prpr": "67100",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "10900",
            "prdy_ctrt": "19.40",
            "acml_vol": "3088002",
            "shnu_cntg_csnu": "2150",
            "seln_cntg_csnu": "1697",
            "ntby_cnqn": "453"
        },
        {
            "mksc_shrn_iscd": "457190",
            "data_rank": "6",
            "hts_kor_isnm": "이수스페셜티케미컬",
            "stck_prpr": "389500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "47000",
            "prdy_ctrt": "13.72",
            "acml_vol": "671298",
            "shnu_cntg_csnu": "2582",
            "seln_cntg_csnu": "2201",
            "ntby_cnqn": "381"
        },
        {
            "mksc_shrn_iscd": "454910",
            "data_rank": "7",
            "hts_kor_isnm": "두산로보틱스",
            "stck_prpr": "92900",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "5800",
            "prdy_ctrt": "6.66",
            "acml_vol": "1169659",
            "shnu_cntg_csnu": "1214",
            "seln_cntg_csnu": "836",
            "ntby_cnqn": "378"
        },
        {
            "mksc_shrn_iscd": "441540",
            "data_rank": "8",
            "hts_kor_isnm": "HANARO Fn조선해운",
            "stck_prpr": "10610",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "245",
            "prdy_ctrt": "2.36",
            "acml_vol": "2423370",
            "shnu_cntg_csnu": "458",
            "seln_cntg_csnu": "82",
            "ntby_cnqn": "376"
        },
        {
            "mksc_shrn_iscd": "066970",
            "data_rank": "9",
            "hts_kor_isnm": "엘앤에프",
            "stck_prpr": "174700",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "12500",
            "prdy_ctrt": "7.71",
            "acml_vol": "424191",
            "shnu_cntg_csnu": "676",
            "seln_cntg_csnu": "328",
            "ntby_cnqn": "348"
        },
        {
            "mksc_shrn_iscd": "006260",
            "data_rank": "10",
            "hts_kor_isnm": "LS",
            "stck_prpr": "111000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "6900",
            "prdy_ctrt": "6.63",
            "acml_vol": "475967",
            "shnu_cntg_csnu": "831",
            "seln_cntg_csnu": "510",
            "ntby_cnqn": "321"
        },
        {
            "mksc_shrn_iscd": "247540",
            "data_rank": "11",
            "hts_kor_isnm": "에코프로비엠",
            "stck_prpr": "265500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "9000",
            "prdy_ctrt": "3.51",
            "acml_vol": "484949",
            "shnu_cntg_csnu": "1320",
            "seln_cntg_csnu": "1004",
            "ntby_cnqn": "316"
        },
        {
            "mksc_shrn_iscd": "051910",
            "data_rank": "12",
            "hts_kor_isnm": "LG화학",
            "stck_prpr": "441500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "10500",
            "prdy_ctrt": "2.44",
            "acml_vol": "119939",
            "shnu_cntg_csnu": "708",
            "seln_cntg_csnu": "399",
            "ntby_cnqn": "309"
        },
        {
            "mksc_shrn_iscd": "196170",
            "data_rank": "13",
            "hts_kor_isnm": "알테오젠",
            "stck_prpr": "209500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "5000",
            "prdy_ctrt": "2.44",
            "acml_vol": "1859846",
            "shnu_cntg_csnu": "3637",
            "seln_cntg_csnu": "3379",
            "ntby_cnqn": "258"
        },
        {
            "mksc_shrn_iscd": "042660",
            "data_rank": "14",
            "hts_kor_isnm": "한화오션",
            "stck_prpr": "28850",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1850",
            "prdy_ctrt": "6.85",
            "acml_vol": "3370897",
            "shnu_cntg_csnu": "1112",
            "seln_cntg_csnu": "856",
            "ntby_cnqn": "256"
        },
        {
            "mksc_shrn_iscd": "000270",
            "data_rank": "15",
            "hts_kor_isnm": "기아",
            "stck_prpr": "127500",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "2500",
            "prdy_ctrt": "2.00",
            "acml_vol": "866368",
            "shnu_cntg_csnu": "1342",
            "seln_cntg_csnu": "1110",
            "ntby_cnqn": "232"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 공매도 상위종목[국내주식-133]

REST

국내주식 공매도 상위종목[국내주식-133]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    미지원
  • URL
    /uapi/domestic-stock/v1/ranking/short-sale
  • Format
     
  • Content-Type
     

개요

공매도 상위종목 API입니다.
한국투자 HTS(eFriend Plus) > [0482] 공매도 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHPST04820000
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_APLY_RANG_VOL FID 적용 범위 거래량 String Y 18 공백
FID_COND_MRKT_DIV_CODE 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
FID_COND_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 Unique key(20482)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000:전체, 0001:코스피, 1001:코스닥, 2001:코스피200, 4001: KRX100, 3003: 코스닥150
FID_PERIOD_DIV_CODE 조회구분 (일/월) String Y 32 조회구분 (일/월) D: 일, M:월
FID_INPUT_CNT_1 조회가간(일수 String Y 12 '조회가간(일수):
조회구분(D) 0:1일, 1:2일, 2:3일, 3:4일, 4:1주일, 9:2주일, 14:3주일,
조회구분(M) 1:1개월, 2:2개월, 3:3개월'
FID_TRGT_EXLS_CLS_CODE 대상 제외 구분 코드 String Y 32 공백
FID_TRGT_CLS_CODE FID 대상 구분 코드 String Y 32 공백
FID_APLY_RANG_PRC_1 FID 적용 범위 가격1 String Y 18 가격 ~
FID_APLY_RANG_PRC_2 FID 적용 범위 가격2 String Y 18 ~ 가격

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
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-acml_tr_pbmn 누적 거래 대금 String Y 18
-ssts_cntg_qty 공매도 체결 수량 String Y 12
-ssts_vol_rlim 공매도 거래량 비중 String Y 62
-ssts_tr_pbmn 공매도 거래 대금 String Y 18
-ssts_tr_pbmn_rlim 공매도 거래대금 비중 String Y 62
-stnd_date1 기준 일자1 String Y 8
-stnd_date2 기준 일자2 String Y 8
-avrg_prc 평균가격 String Y 11

Example

Request

fid_cond_mrkt_div_code:J
fid_cond_scr_div_code:20482
fid_input_iscd:0000
fid_period_div_code:D
fid_input_cnt_1:000000000000
fid_trgt_exls_cls_code:0
fid_trgt_cls_code:0
fid_aply_rang_prc_1:
fid_aply_rang_prc_2:
fid_aply_rang_vol:0

Response

{
    "output": [
        {
            "mksc_shrn_iscd": "138930",
            "hts_kor_isnm": "BNK금융지주",
            "stck_prpr": "7760",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.13",
            "acml_vol": "874160",
            "acml_tr_pbmn": "6842692780",
            "ssts_cntg_qty": "64031",
            "ssts_vol_rlim": "7.32",
            "ssts_tr_pbmn": "499643430",
            "ssts_tr_pbmn_rlim": "7.30",
            "stnd_date1": "20240329",
            "stnd_date2": "20240329",
            "avrg_prc": "7803"
        },
        {
            "mksc_shrn_iscd": "024110",
            "hts_kor_isnm": "기업은행",
            "stck_prpr": "13230",
            "prdy_vrss": "-270",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.00",
            "acml_vol": "2940414",
            "acml_tr_pbmn": "39892800710",
            "ssts_cntg_qty": "42457",
            "ssts_vol_rlim": "1.44",
            "ssts_tr_pbmn": "573293240",
            "ssts_tr_pbmn_rlim": "1.44",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "13502"
        },
        {
            "mksc_shrn_iscd": "067310",
            "hts_kor_isnm": "하나마이크론",
            "stck_prpr": "29300",
            "prdy_vrss": "650",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.27",
            "acml_vol": "7785025",
            "acml_tr_pbmn": "219228491967",
            "ssts_cntg_qty": "41626",
            "ssts_vol_rlim": "0.53",
            "ssts_tr_pbmn": "1195641050",
            "ssts_tr_pbmn_rlim": "0.55",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "28723"
        },
        {
            "mksc_shrn_iscd": "139130",
            "hts_kor_isnm": "DGB금융지주",
            "stck_prpr": "8480",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.82",
            "acml_vol": "646804",
            "acml_tr_pbmn": "5579590090",
            "ssts_cntg_qty": "41615",
            "ssts_vol_rlim": "6.43",
            "ssts_tr_pbmn": "357709910",
            "ssts_tr_pbmn_rlim": "6.41",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "8595"
        },
        {
            "mksc_shrn_iscd": "316140",
            "hts_kor_isnm": "우리금융지주",
            "stck_prpr": "14050",
            "prdy_vrss": "-270",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.89",
            "acml_vol": "2158189",
            "acml_tr_pbmn": "30895435840",
            "ssts_cntg_qty": "39928",
            "ssts_vol_rlim": "1.85",
            "ssts_tr_pbmn": "570341910",
            "ssts_tr_pbmn_rlim": "1.85",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "14284"
        },
        {
            "mksc_shrn_iscd": "005930",
            "hts_kor_isnm": "삼성전자",
            "stck_prpr": "82800",
            "prdy_vrss": "400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.49",
            "acml_vol": "27126366",
            "acml_tr_pbmn": "2224901311700",
            "ssts_cntg_qty": "39325",
            "ssts_vol_rlim": "0.14",
            "ssts_tr_pbmn": "3236734600",
            "ssts_tr_pbmn_rlim": "0.15",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "82307"
        },
        {
            "mksc_shrn_iscd": "00680K",
            "hts_kor_isnm": "미래에셋증권2우B",
            "stck_prpr": "3590",
            "prdy_vrss": "-85",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.31",
            "acml_vol": "521897",
            "acml_tr_pbmn": "1920418685",
            "ssts_cntg_qty": "27624",
            "ssts_vol_rlim": "5.29",
            "ssts_tr_pbmn": "101602075",
            "ssts_tr_pbmn_rlim": "5.29",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "3678"
        },
        {
            "mksc_shrn_iscd": "088350",
            "hts_kor_isnm": "한화생명",
            "stck_prpr": "2835",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "2781608",
            "acml_tr_pbmn": "7916471305",
            "ssts_cntg_qty": "25456",
            "ssts_vol_rlim": "0.92",
            "ssts_tr_pbmn": "72204695",
            "ssts_tr_pbmn_rlim": "0.91",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "2836"
        },
        {
            "mksc_shrn_iscd": "005940",
            "hts_kor_isnm": "NH투자증권",
            "stck_prpr": "11350",
            "prdy_vrss": "-350",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.99",
            "acml_vol": "750616",
            "acml_tr_pbmn": "8827218780",
            "ssts_cntg_qty": "24915",
            "ssts_vol_rlim": "3.32",
            "ssts_tr_pbmn": "292457920",
            "ssts_tr_pbmn_rlim": "3.31",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "11738"
        },
        {
            "mksc_shrn_iscd": "032640",
            "hts_kor_isnm": "LG유플러스",
            "stck_prpr": "9990",
            "prdy_vrss": "20",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.20",
            "acml_vol": "796940",
            "acml_tr_pbmn": "7972130660",
            "ssts_cntg_qty": "23173",
            "ssts_vol_rlim": "2.91",
            "ssts_tr_pbmn": "231604320",
            "ssts_tr_pbmn_rlim": "2.91",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "9994"
        },
        {
            "mksc_shrn_iscd": "007660",
            "hts_kor_isnm": "이수페타시스",
            "stck_prpr": "41950",
            "prdy_vrss": "-350",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.83",
            "acml_vol": "5735235",
            "acml_tr_pbmn": "247424365700",
            "ssts_cntg_qty": "20252",
            "ssts_vol_rlim": "0.35",
            "ssts_tr_pbmn": "861494300",
            "ssts_tr_pbmn_rlim": "0.35",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "42538"
        },
        {
            "mksc_shrn_iscd": "175330",
            "hts_kor_isnm": "JB금융지주",
            "stck_prpr": "12680",
            "prdy_vrss": "-520",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.94",
            "acml_vol": "275866",
            "acml_tr_pbmn": "3642365310",
            "ssts_cntg_qty": "19076",
            "ssts_vol_rlim": "6.91",
            "ssts_tr_pbmn": "251554220",
            "ssts_tr_pbmn_rlim": "6.91",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "13186"
        },
        {
            "mksc_shrn_iscd": "353200",
            "hts_kor_isnm": "대덕전자",
            "stck_prpr": "26850",
            "prdy_vrss": "2300",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "9.37",
            "acml_vol": "959488",
            "acml_tr_pbmn": "23364959800",
            "ssts_cntg_qty": "18988",
            "ssts_vol_rlim": "1.98",
            "ssts_tr_pbmn": "465048200",
            "ssts_tr_pbmn_rlim": "1.99",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "24491"
        },
        {
            "mksc_shrn_iscd": "403870",
            "hts_kor_isnm": "HPSP",
            "stck_prpr": "52000",
            "prdy_vrss": "-1100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.07",
            "acml_vol": "1821358",
            "acml_tr_pbmn": "96690901900",
            "ssts_cntg_qty": "14408",
            "ssts_vol_rlim": "0.79",
            "ssts_tr_pbmn": "764718100",
            "ssts_tr_pbmn_rlim": "0.79",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "53075"
        },
        {
            "mksc_shrn_iscd": "003540",
            "hts_kor_isnm": "대신증권",
            "stck_prpr": "15540",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.64",
            "acml_vol": "106254",
            "acml_tr_pbmn": "1670379320",
            "ssts_cntg_qty": "13935",
            "ssts_vol_rlim": "13.11",
            "ssts_tr_pbmn": "218404520",
            "ssts_tr_pbmn_rlim": "13.08",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "15673"
        },
        {
            "mksc_shrn_iscd": "000660",
            "hts_kor_isnm": "SK하이닉스",
            "stck_prpr": "185900",
            "prdy_vrss": "2900",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.58",
            "acml_vol": "3035080",
            "acml_tr_pbmn": "550258980100",
            "ssts_cntg_qty": "13524",
            "ssts_vol_rlim": "0.45",
            "ssts_tr_pbmn": "2459992400",
            "ssts_tr_pbmn_rlim": "0.45",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "181898"
        },
        {
            "mksc_shrn_iscd": "095340",
            "hts_kor_isnm": "ISC",
            "stck_prpr": "95500",
            "prdy_vrss": "-2500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.55",
            "acml_vol": "387100",
            "acml_tr_pbmn": "37858878700",
            "ssts_cntg_qty": "11023",
            "ssts_vol_rlim": "2.85",
            "ssts_tr_pbmn": "1080996600",
            "ssts_tr_pbmn_rlim": "2.86",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "98067"
        },
        {
            "mksc_shrn_iscd": "005935",
            "hts_kor_isnm": "삼성전자우",
            "stck_prpr": "68000",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "1792197",
            "acml_tr_pbmn": "121695607500",
            "ssts_cntg_qty": "10863",
            "ssts_vol_rlim": "0.61",
            "ssts_tr_pbmn": "739454700",
            "ssts_tr_pbmn_rlim": "0.61",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "68070"
        },
        {
            "mksc_shrn_iscd": "036540",
            "hts_kor_isnm": "SFA반도체",
            "stck_prpr": "6100",
            "prdy_vrss": "70",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.16",
            "acml_vol": "2015142",
            "acml_tr_pbmn": "12201512130",
            "ssts_cntg_qty": "10781",
            "ssts_vol_rlim": "0.53",
            "ssts_tr_pbmn": "65141390",
            "ssts_tr_pbmn_rlim": "0.53",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "6042"
        },
        {
            "mksc_shrn_iscd": "029780",
            "hts_kor_isnm": "삼성카드",
            "stck_prpr": "37200",
            "prdy_vrss": "-650",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.72",
            "acml_vol": "124920",
            "acml_tr_pbmn": "4724311400",
            "ssts_cntg_qty": "10618",
            "ssts_vol_rlim": "8.50",
            "ssts_tr_pbmn": "400737650",
            "ssts_tr_pbmn_rlim": "8.48",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "37741"
        },
        {
            "mksc_shrn_iscd": "003690",
            "hts_kor_isnm": "코리안리",
            "stck_prpr": "8350",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.60",
            "acml_vol": "511433",
            "acml_tr_pbmn": "4226681430",
            "ssts_cntg_qty": "10065",
            "ssts_vol_rlim": "1.97",
            "ssts_tr_pbmn": "83410590",
            "ssts_tr_pbmn_rlim": "1.97",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "8287"
        },
        {
            "mksc_shrn_iscd": "030000",
            "hts_kor_isnm": "제일기획",
            "stck_prpr": "19110",
            "prdy_vrss": "330",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.76",
            "acml_vol": "216890",
            "acml_tr_pbmn": "4081885780",
            "ssts_cntg_qty": "10014",
            "ssts_vol_rlim": "4.62",
            "ssts_tr_pbmn": "188337710",
            "ssts_tr_pbmn_rlim": "4.61",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "18807"
        },
        {
            "mksc_shrn_iscd": "090350",
            "hts_kor_isnm": "노루페인트",
            "stck_prpr": "9960",
            "prdy_vrss": "270",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.79",
            "acml_vol": "168269",
            "acml_tr_pbmn": "1640849400",
            "ssts_cntg_qty": "9186",
            "ssts_vol_rlim": "5.46",
            "ssts_tr_pbmn": "89164490",
            "ssts_tr_pbmn_rlim": "5.43",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "9706"
        },
        {
            "mksc_shrn_iscd": "086790",
            "hts_kor_isnm": "하나금융지주",
            "stck_prpr": "56600",
            "prdy_vrss": "-1100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.91",
            "acml_vol": "740105",
            "acml_tr_pbmn": "43037308100",
            "ssts_cntg_qty": "8114",
            "ssts_vol_rlim": "1.10",
            "ssts_tr_pbmn": "471499600",
            "ssts_tr_pbmn_rlim": "1.10",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "58109"
        },
        {
            "mksc_shrn_iscd": "042700",
            "hts_kor_isnm": "한미반도체",
            "stck_prpr": "140400",
            "prdy_vrss": "6700",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "5.01",
            "acml_vol": "4188468",
            "acml_tr_pbmn": "562948611100",
            "ssts_cntg_qty": "7927",
            "ssts_vol_rlim": "0.19",
            "ssts_tr_pbmn": "1061391800",
            "ssts_tr_pbmn_rlim": "0.19",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "133895"
        },
        {
            "mksc_shrn_iscd": "055550",
            "hts_kor_isnm": "신한지주",
            "stck_prpr": "45500",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.09",
            "acml_vol": "1377596",
            "acml_tr_pbmn": "63828246950",
            "ssts_cntg_qty": "7790",
            "ssts_vol_rlim": "0.57",
            "ssts_tr_pbmn": "360468750",
            "ssts_tr_pbmn_rlim": "0.56",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "46273"
        },
        {
            "mksc_shrn_iscd": "044450",
            "hts_kor_isnm": "KSS해운",
            "stck_prpr": "8220",
            "prdy_vrss": "20",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.24",
            "acml_vol": "42700",
            "acml_tr_pbmn": "353638500",
            "ssts_cntg_qty": "7617",
            "ssts_vol_rlim": "17.84",
            "ssts_tr_pbmn": "62980890",
            "ssts_tr_pbmn_rlim": "17.81",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "8268"
        },
        {
            "mksc_shrn_iscd": "300720",
            "hts_kor_isnm": "한일시멘트",
            "stck_prpr": "12180",
            "prdy_vrss": "-120",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.98",
            "acml_vol": "28707",
            "acml_tr_pbmn": "354558700",
            "ssts_cntg_qty": "7547",
            "ssts_vol_rlim": "26.29",
            "ssts_tr_pbmn": "93090530",
            "ssts_tr_pbmn_rlim": "26.26",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "12334"
        },
        {
            "mksc_shrn_iscd": "105560",
            "hts_kor_isnm": "KB금융",
            "stck_prpr": "68800",
            "prdy_vrss": "-700",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.01",
            "acml_vol": "1004163",
            "acml_tr_pbmn": "70541592600",
            "ssts_cntg_qty": "7255",
            "ssts_vol_rlim": "0.72",
            "ssts_tr_pbmn": "508167300",
            "ssts_tr_pbmn_rlim": "0.72",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "70043"
        },
        {
            "mksc_shrn_iscd": "017670",
            "hts_kor_isnm": "SK텔레콤",
            "stck_prpr": "52000",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.95",
            "acml_vol": "382896",
            "acml_tr_pbmn": "20200687400",
            "ssts_cntg_qty": "6834",
            "ssts_vol_rlim": "1.78",
            "ssts_tr_pbmn": "359735100",
            "ssts_tr_pbmn_rlim": "1.78",
            "stnd_date1": "0",
            "stnd_date2": "0",
            "avrg_prc": "52639"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 신용잔고 상위[국내주식-109]

REST

국내주식 신용잔고 상위[국내주식-109]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/credit-balance
  • Format
     
  • Content-Type
     

개요

국내주식 신용잔고 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0475] 신용잔고 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 FHKST17010000
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_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 Unique key(11701)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000:전체, 0001:거래소, 1001:코스닥, 2001:코스피200,
FID_OPTION 증가율기간 String Y 5 2~999
FID_COND_MRKT_DIV_CODE 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
FID_RANK_SORT_CLS_CODE 순위 정렬 구분 코드 String Y 2 '(융자)0:잔고비율 상위, 1: 잔고수량 상위, 2: 잔고금액 상위, 3: 잔고비율 증가상위, 4: 잔고비율 감소상위
(대주)5:잔고비율 상위, 6: 잔고수량 상위, 7: 잔고금액 상위, 8: 잔고비율 증가상위, 9: 잔고비율 감소상위 '

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-bstp_cls_code 업종 구분 코드 String Y 4
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stnd_date1 기준 일자1 String Y 8
-stnd_date2 기준 일자2 String Y 8
output2 응답상세 Object Array Y array
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 82
-acml_vol 누적 거래량 String Y 18
-whol_loan_rmnd_stcn 전체 융자 잔고 주수 String Y 18
-whol_loan_rmnd_amt 전체 융자 잔고 금액 String Y 18
-whol_loan_rmnd_rate 전체 융자 잔고 비율 String Y 84
-whol_stln_rmnd_stcn 전체 대주 잔고 주수 String Y 18
-whol_stln_rmnd_amt 전체 대주 잔고 금액 String Y 18
-whol_stln_rmnd_rate 전체 대주 잔고 비율 String Y 84
-nday_vrss_loan_rmnd_inrt N일 대비 융자 잔고 증가율 String Y 84
-nday_vrss_stln_rmnd_inrt N일 대비 대주 잔고 증가율 String Y 84

Example

Request

fid_cond_scr_div_code:11701
fid_input_iscd:0000
fid_option:2
fid_cond_mrkt_div_code:J
fid_rank_sort_cls_code:0

Response

{
    "output1": [
        {
            "bstp_cls_code": "1001",
            "hts_kor_isnm": "종합",
            "stnd_date1": "20240409",
            "stnd_date2": "20240411"
        }
    ],
    "output2": [
        {
            "mksc_shrn_iscd": "089010",
            "hts_kor_isnm": "켐트로닉스",
            "stck_prpr": "28200",
            "prdy_vrss": "-300",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.05",
            "acml_vol": "2854589",
            "whol_loan_rmnd_stcn": "1470604",
            "whol_loan_rmnd_amt": "3312604",
            "whol_loan_rmnd_rate": "9.68",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "2.61",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "083500",
            "hts_kor_isnm": "에프엔에스테크",
            "stck_prpr": "12770",
            "prdy_vrss": "-390",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.96",
            "acml_vol": "640177",
            "whol_loan_rmnd_stcn": "830732",
            "whol_loan_rmnd_amt": "919030",
            "whol_loan_rmnd_rate": "9.68",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.98",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "251340",
            "hts_kor_isnm": "KODEX 코스닥150선물인버스",
            "stck_prpr": "3485",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.29",
            "acml_vol": "35592555",
            "whol_loan_rmnd_stcn": "13685692",
            "whol_loan_rmnd_amt": "4699136",
            "whol_loan_rmnd_rate": "9.54",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.46",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "054450",
            "hts_kor_isnm": "텔레칩스",
            "stck_prpr": "26350",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "158467",
            "whol_loan_rmnd_stcn": "1382693",
            "whol_loan_rmnd_amt": "3550014",
            "whol_loan_rmnd_rate": "9.12",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.00",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "278650",
            "hts_kor_isnm": "HLB바이오스텝",
            "stck_prpr": "3815",
            "prdy_vrss": "60",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.60",
            "acml_vol": "871174",
            "whol_loan_rmnd_stcn": "7597070",
            "whol_loan_rmnd_amt": "3006994",
            "whol_loan_rmnd_rate": "8.87",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "297890",
            "hts_kor_isnm": "HB솔루션",
            "stck_prpr": "5260",
            "prdy_vrss": "30",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.57",
            "acml_vol": "2140840",
            "whol_loan_rmnd_stcn": "6471546",
            "whol_loan_rmnd_amt": "2874725",
            "whol_loan_rmnd_rate": "8.84",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "032680",
            "hts_kor_isnm": "소프트센",
            "stck_prpr": "647",
            "prdy_vrss": "-2",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.31",
            "acml_vol": "681480",
            "whol_loan_rmnd_stcn": "8995737",
            "whol_loan_rmnd_amt": "633909",
            "whol_loan_rmnd_rate": "8.51",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "078150",
            "hts_kor_isnm": "HB테크놀러지",
            "stck_prpr": "3780",
            "prdy_vrss": "90",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.44",
            "acml_vol": "29649130",
            "whol_loan_rmnd_stcn": "7819411",
            "whol_loan_rmnd_amt": "2206799",
            "whol_loan_rmnd_rate": "8.43",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.44",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "099430",
            "hts_kor_isnm": "바이오플러스",
            "stck_prpr": "6700",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "118929",
            "whol_loan_rmnd_stcn": "4772558",
            "whol_loan_rmnd_amt": "3391432",
            "whol_loan_rmnd_rate": "8.23",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.07",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "032850",
            "hts_kor_isnm": "비트컴퓨터",
            "stck_prpr": "5940",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.17",
            "acml_vol": "281559",
            "whol_loan_rmnd_stcn": "1367824",
            "whol_loan_rmnd_amt": "950448",
            "whol_loan_rmnd_rate": "8.22",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "065450",
            "hts_kor_isnm": "빅텍",
            "stck_prpr": "5120",
            "prdy_vrss": "120",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.40",
            "acml_vol": "1379901",
            "whol_loan_rmnd_stcn": "2352791",
            "whol_loan_rmnd_amt": "1054776",
            "whol_loan_rmnd_rate": "8.20",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.63",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "085670",
            "hts_kor_isnm": "뉴프렉스",
            "stck_prpr": "7310",
            "prdy_vrss": "110",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.53",
            "acml_vol": "483355",
            "whol_loan_rmnd_stcn": "1993717",
            "whol_loan_rmnd_amt": "1368148",
            "whol_loan_rmnd_rate": "8.14",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.24",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "067310",
            "hts_kor_isnm": "하나마이크론",
            "stck_prpr": "31000",
            "prdy_vrss": "-500",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.59",
            "acml_vol": "2845444",
            "whol_loan_rmnd_stcn": "4197874",
            "whol_loan_rmnd_amt": "10546224",
            "whol_loan_rmnd_rate": "8.04",
            "whol_stln_rmnd_stcn": "8766",
            "whol_stln_rmnd_amt": "22042",
            "whol_stln_rmnd_rate": "0.01",
            "nday_vrss_loan_rmnd_inrt": "0.54",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "032580",
            "hts_kor_isnm": "피델릭스",
            "stck_prpr": "1664",
            "prdy_vrss": "-13",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.78",
            "acml_vol": "673012",
            "whol_loan_rmnd_stcn": "2660198",
            "whol_loan_rmnd_amt": "417362",
            "whol_loan_rmnd_rate": "8.02",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.76",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "119850",
            "hts_kor_isnm": "지엔씨에너지",
            "stck_prpr": "8300",
            "prdy_vrss": "330",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.14",
            "acml_vol": "2745093",
            "whol_loan_rmnd_stcn": "1319084",
            "whol_loan_rmnd_amt": "673602",
            "whol_loan_rmnd_rate": "8.01",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.19",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "045660",
            "hts_kor_isnm": "에이텍",
            "stck_prpr": "14870",
            "prdy_vrss": "1500",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "11.22",
            "acml_vol": "2077762",
            "whol_loan_rmnd_stcn": "658980",
            "whol_loan_rmnd_amt": "995291",
            "whol_loan_rmnd_rate": "7.97",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.68",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "059120",
            "hts_kor_isnm": "아진엑스텍",
            "stck_prpr": "11330",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.26",
            "acml_vol": "125062",
            "whol_loan_rmnd_stcn": "774940",
            "whol_loan_rmnd_amt": "842527",
            "whol_loan_rmnd_rate": "7.94",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "060310",
            "hts_kor_isnm": "3S",
            "stck_prpr": "2870",
            "prdy_vrss": "55",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.95",
            "acml_vol": "2095206",
            "whol_loan_rmnd_stcn": "3849904",
            "whol_loan_rmnd_amt": "1168005",
            "whol_loan_rmnd_rate": "7.92",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.32",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "013990",
            "hts_kor_isnm": "아가방컴퍼니",
            "stck_prpr": "5010",
            "prdy_vrss": "15",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.30",
            "acml_vol": "709707",
            "whol_loan_rmnd_stcn": "2607393",
            "whol_loan_rmnd_amt": "1326597",
            "whol_loan_rmnd_rate": "7.92",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "084650",
            "hts_kor_isnm": "랩지노믹스",
            "stck_prpr": "2645",
            "prdy_vrss": "-15",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.56",
            "acml_vol": "386632",
            "whol_loan_rmnd_stcn": "5866700",
            "whol_loan_rmnd_amt": "2248239",
            "whol_loan_rmnd_rate": "7.89",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "017040",
            "hts_kor_isnm": "광명전기",
            "stck_prpr": "2735",
            "prdy_vrss": "55",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.05",
            "acml_vol": "14782305",
            "whol_loan_rmnd_stcn": "3396695",
            "whol_loan_rmnd_amt": "797496",
            "whol_loan_rmnd_rate": "7.82",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.28",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "053050",
            "hts_kor_isnm": "지에스이",
            "stck_prpr": "3630",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.55",
            "acml_vol": "1063396",
            "whol_loan_rmnd_stcn": "2335946",
            "whol_loan_rmnd_amt": "852637",
            "whol_loan_rmnd_rate": "7.78",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.21",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "123410",
            "hts_kor_isnm": "코리아에프티",
            "stck_prpr": "6550",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.76",
            "acml_vol": "1739694",
            "whol_loan_rmnd_stcn": "2168343",
            "whol_loan_rmnd_amt": "1069541",
            "whol_loan_rmnd_rate": "7.78",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.17",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "027580",
            "hts_kor_isnm": "상보",
            "stck_prpr": "1715",
            "prdy_vrss": "14",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.82",
            "acml_vol": "481651",
            "whol_loan_rmnd_stcn": "4610038",
            "whol_loan_rmnd_amt": "799793",
            "whol_loan_rmnd_rate": "7.78",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "069410",
            "hts_kor_isnm": "엔텔스",
            "stck_prpr": "4840",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.41",
            "acml_vol": "11108",
            "whol_loan_rmnd_stcn": "792894",
            "whol_loan_rmnd_amt": "445356",
            "whol_loan_rmnd_rate": "7.73",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.01",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "011700",
            "hts_kor_isnm": "한신기계",
            "stck_prpr": "4325",
            "prdy_vrss": "40",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.93",
            "acml_vol": "234574",
            "whol_loan_rmnd_stcn": "2506499",
            "whol_loan_rmnd_amt": "1243551",
            "whol_loan_rmnd_rate": "7.71",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.08",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "441270",
            "hts_kor_isnm": "파인엠텍",
            "stck_prpr": "8290",
            "prdy_vrss": "40",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.48",
            "acml_vol": "120184",
            "whol_loan_rmnd_stcn": "2808021",
            "whol_loan_rmnd_amt": "2237689",
            "whol_loan_rmnd_rate": "7.60",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "058850",
            "hts_kor_isnm": "KTcs",
            "stck_prpr": "3255",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.91",
            "acml_vol": "315560",
            "whol_loan_rmnd_stcn": "3240142",
            "whol_loan_rmnd_amt": "1142392",
            "whol_loan_rmnd_rate": "7.58",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "091580",
            "hts_kor_isnm": "상신이디피",
            "stck_prpr": "16320",
            "prdy_vrss": "-290",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.75",
            "acml_vol": "116376",
            "whol_loan_rmnd_stcn": "1013775",
            "whol_loan_rmnd_amt": "1820763",
            "whol_loan_rmnd_rate": "7.54",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.12",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "200710",
            "hts_kor_isnm": "에이디테크놀로지",
            "stck_prpr": "43200",
            "prdy_vrss": "1400",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.35",
            "acml_vol": "768752",
            "whol_loan_rmnd_stcn": "1005663",
            "whol_loan_rmnd_amt": "3141897",
            "whol_loan_rmnd_rate": "7.48",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.02",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "033170",
            "hts_kor_isnm": "시그네틱스",
            "stck_prpr": "1768",
            "prdy_vrss": "-14",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.79",
            "acml_vol": "1353436",
            "whol_loan_rmnd_stcn": "6362245",
            "whol_loan_rmnd_amt": "1042181",
            "whol_loan_rmnd_rate": "7.41",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.05",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "272110",
            "hts_kor_isnm": "케이엔제이",
            "stck_prpr": "19920",
            "prdy_vrss": "-380",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.87",
            "acml_vol": "526814",
            "whol_loan_rmnd_stcn": "587700",
            "whol_loan_rmnd_amt": "1035337",
            "whol_loan_rmnd_rate": "7.36",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "2.89",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "126700",
            "hts_kor_isnm": "하이비젼시스템",
            "stck_prpr": "21750",
            "prdy_vrss": "450",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.11",
            "acml_vol": "250245",
            "whol_loan_rmnd_stcn": "1081067",
            "whol_loan_rmnd_amt": "2198402",
            "whol_loan_rmnd_rate": "7.23",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "064480",
            "hts_kor_isnm": "브리지텍",
            "stck_prpr": "7080",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "70003",
            "whol_loan_rmnd_stcn": "862374",
            "whol_loan_rmnd_amt": "674845",
            "whol_loan_rmnd_rate": "7.20",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "049070",
            "hts_kor_isnm": "인탑스",
            "stck_prpr": "27900",
            "prdy_vrss": "100",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.36",
            "acml_vol": "120198",
            "whol_loan_rmnd_stcn": "1240516",
            "whol_loan_rmnd_amt": "3631525",
            "whol_loan_rmnd_rate": "7.20",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.08",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "102120",
            "hts_kor_isnm": "어보브반도체",
            "stck_prpr": "16450",
            "prdy_vrss": "430",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.68",
            "acml_vol": "1247402",
            "whol_loan_rmnd_stcn": "1274613",
            "whol_loan_rmnd_amt": "1945592",
            "whol_loan_rmnd_rate": "7.16",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "242040",
            "hts_kor_isnm": "나무기술",
            "stck_prpr": "2270",
            "prdy_vrss": "45",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.02",
            "acml_vol": "294303",
            "whol_loan_rmnd_stcn": "2464083",
            "whol_loan_rmnd_amt": "521855",
            "whol_loan_rmnd_rate": "7.11",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.05",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "092870",
            "hts_kor_isnm": "엑시콘",
            "stck_prpr": "28450",
            "prdy_vrss": "200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.71",
            "acml_vol": "1115639",
            "whol_loan_rmnd_stcn": "771959",
            "whol_loan_rmnd_amt": "1866596",
            "whol_loan_rmnd_rate": "7.10",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.29",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "173130",
            "hts_kor_isnm": "오파스넷",
            "stck_prpr": "7450",
            "prdy_vrss": "-90",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.19",
            "acml_vol": "190126",
            "whol_loan_rmnd_stcn": "841989",
            "whol_loan_rmnd_amt": "874835",
            "whol_loan_rmnd_rate": "7.08",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.16",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "036010",
            "hts_kor_isnm": "아비코전자",
            "stck_prpr": "12240",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.57",
            "acml_vol": "87854",
            "whol_loan_rmnd_stcn": "942948",
            "whol_loan_rmnd_amt": "1134247",
            "whol_loan_rmnd_rate": "7.08",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "317850",
            "hts_kor_isnm": "대모",
            "stck_prpr": "8930",
            "prdy_vrss": "-10",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.11",
            "acml_vol": "39218",
            "whol_loan_rmnd_stcn": "587385",
            "whol_loan_rmnd_amt": "537776",
            "whol_loan_rmnd_rate": "7.05",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "356860",
            "hts_kor_isnm": "티엘비",
            "stck_prpr": "28100",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.18",
            "acml_vol": "768183",
            "whol_loan_rmnd_stcn": "691435",
            "whol_loan_rmnd_amt": "1698227",
            "whol_loan_rmnd_rate": "7.02",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "053690",
            "hts_kor_isnm": "한미글로벌",
            "stck_prpr": "15970",
            "prdy_vrss": "460",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.97",
            "acml_vol": "114724",
            "whol_loan_rmnd_stcn": "768802",
            "whol_loan_rmnd_amt": "1565129",
            "whol_loan_rmnd_rate": "7.01",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.00",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "119830",
            "hts_kor_isnm": "아이텍",
            "stck_prpr": "7800",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.26",
            "acml_vol": "275384",
            "whol_loan_rmnd_stcn": "1503355",
            "whol_loan_rmnd_amt": "1210314",
            "whol_loan_rmnd_rate": "7.00",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.12",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "079370",
            "hts_kor_isnm": "제우스",
            "stck_prpr": "17070",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.29",
            "acml_vol": "486845",
            "whol_loan_rmnd_stcn": "2170538",
            "whol_loan_rmnd_amt": "3909085",
            "whol_loan_rmnd_rate": "6.99",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "013810",
            "hts_kor_isnm": "스페코",
            "stck_prpr": "4250",
            "prdy_vrss": "20",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.47",
            "acml_vol": "1117693",
            "whol_loan_rmnd_stcn": "1024951",
            "whol_loan_rmnd_amt": "457257",
            "whol_loan_rmnd_rate": "6.98",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.53",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "170030",
            "hts_kor_isnm": "현대공업",
            "stck_prpr": "7160",
            "prdy_vrss": "-40",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.56",
            "acml_vol": "62752",
            "whol_loan_rmnd_stcn": "1070944",
            "whol_loan_rmnd_amt": "791679",
            "whol_loan_rmnd_rate": "6.97",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.07",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "105840",
            "hts_kor_isnm": "우진",
            "stck_prpr": "8040",
            "prdy_vrss": "20",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.25",
            "acml_vol": "213279",
            "whol_loan_rmnd_stcn": "1414634",
            "whol_loan_rmnd_amt": "1194554",
            "whol_loan_rmnd_rate": "6.95",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.12",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "005870",
            "hts_kor_isnm": "휴니드",
            "stck_prpr": "7890",
            "prdy_vrss": "260",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.41",
            "acml_vol": "867287",
            "whol_loan_rmnd_stcn": "970639",
            "whol_loan_rmnd_amt": "596254",
            "whol_loan_rmnd_rate": "6.86",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.21",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "058610",
            "hts_kor_isnm": "에스피지",
            "stck_prpr": "27900",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.18",
            "acml_vol": "123557",
            "whol_loan_rmnd_stcn": "1508594",
            "whol_loan_rmnd_amt": "4449364",
            "whol_loan_rmnd_rate": "6.80",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "089890",
            "hts_kor_isnm": "코세스",
            "stck_prpr": "14770",
            "prdy_vrss": "460",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.21",
            "acml_vol": "246072",
            "whol_loan_rmnd_stcn": "1117343",
            "whol_loan_rmnd_amt": "1591385",
            "whol_loan_rmnd_rate": "6.73",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.31",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "417840",
            "hts_kor_isnm": "저스템",
            "stck_prpr": "14750",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.34",
            "acml_vol": "101548",
            "whol_loan_rmnd_stcn": "486317",
            "whol_loan_rmnd_amt": "691578",
            "whol_loan_rmnd_rate": "6.70",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.01",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "330860",
            "hts_kor_isnm": "네패스아크",
            "stck_prpr": "31300",
            "prdy_vrss": "-100",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.32",
            "acml_vol": "205892",
            "whol_loan_rmnd_stcn": "813558",
            "whol_loan_rmnd_amt": "2564499",
            "whol_loan_rmnd_rate": "6.67",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "094940",
            "hts_kor_isnm": "푸른기술",
            "stck_prpr": "7960",
            "prdy_vrss": "-30",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.38",
            "acml_vol": "36883",
            "whol_loan_rmnd_stcn": "558956",
            "whol_loan_rmnd_amt": "458942",
            "whol_loan_rmnd_rate": "6.67",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "190510",
            "hts_kor_isnm": "나무가",
            "stck_prpr": "14400",
            "prdy_vrss": "170",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.19",
            "acml_vol": "76736",
            "whol_loan_rmnd_stcn": "1080318",
            "whol_loan_rmnd_amt": "1620263",
            "whol_loan_rmnd_rate": "6.63",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.05",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "388050",
            "hts_kor_isnm": "지투파워",
            "stck_prpr": "8320",
            "prdy_vrss": "360",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.52",
            "acml_vol": "388506",
            "whol_loan_rmnd_stcn": "1237161",
            "whol_loan_rmnd_amt": "1084612",
            "whol_loan_rmnd_rate": "6.61",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.16",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "083450",
            "hts_kor_isnm": "GST",
            "stck_prpr": "45550",
            "prdy_vrss": "-750",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.62",
            "acml_vol": "384176",
            "whol_loan_rmnd_stcn": "617379",
            "whol_loan_rmnd_amt": "2733486",
            "whol_loan_rmnd_rate": "6.61",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "001200",
            "hts_kor_isnm": "유진투자증권",
            "stck_prpr": "4480",
            "prdy_vrss": "45",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.01",
            "acml_vol": "1233478",
            "whol_loan_rmnd_stcn": "6390416",
            "whol_loan_rmnd_amt": "2008968",
            "whol_loan_rmnd_rate": "6.59",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.05",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "009470",
            "hts_kor_isnm": "삼화전기",
            "stck_prpr": "42100",
            "prdy_vrss": "-600",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.41",
            "acml_vol": "683124",
            "whol_loan_rmnd_stcn": "433894",
            "whol_loan_rmnd_amt": "1027829",
            "whol_loan_rmnd_rate": "6.55",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.23",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "211270",
            "hts_kor_isnm": "AP위성",
            "stck_prpr": "18050",
            "prdy_vrss": "1070",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "6.30",
            "acml_vol": "3756221",
            "whol_loan_rmnd_stcn": "984104",
            "whol_loan_rmnd_amt": "1467605",
            "whol_loan_rmnd_rate": "6.52",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "007810",
            "hts_kor_isnm": "코리아써키트",
            "stck_prpr": "16500",
            "prdy_vrss": "-200",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.20",
            "acml_vol": "184898",
            "whol_loan_rmnd_stcn": "1541603",
            "whol_loan_rmnd_amt": "2721485",
            "whol_loan_rmnd_rate": "6.52",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "205100",
            "hts_kor_isnm": "엑셈",
            "stck_prpr": "2340",
            "prdy_vrss": "95",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.23",
            "acml_vol": "876663",
            "whol_loan_rmnd_stcn": "4683303",
            "whol_loan_rmnd_amt": "1323790",
            "whol_loan_rmnd_rate": "6.49",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "419530",
            "hts_kor_isnm": "SAMG엔터",
            "stck_prpr": "13620",
            "prdy_vrss": "200",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.49",
            "acml_vol": "59201",
            "whol_loan_rmnd_stcn": "555857",
            "whol_loan_rmnd_amt": "997852",
            "whol_loan_rmnd_rate": "6.46",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "025320",
            "hts_kor_isnm": "시노펙스",
            "stck_prpr": "9080",
            "prdy_vrss": "-290",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.09",
            "acml_vol": "1711765",
            "whol_loan_rmnd_stcn": "5399872",
            "whol_loan_rmnd_amt": "3812492",
            "whol_loan_rmnd_rate": "6.43",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.07",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "037440",
            "hts_kor_isnm": "희림",
            "stck_prpr": "6400",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.93",
            "acml_vol": "56354",
            "whol_loan_rmnd_stcn": "896058",
            "whol_loan_rmnd_amt": "645536",
            "whol_loan_rmnd_rate": "6.43",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "133750",
            "hts_kor_isnm": "메가엠디",
            "stck_prpr": "2410",
            "prdy_vrss": "-50",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.03",
            "acml_vol": "166600",
            "whol_loan_rmnd_stcn": "1505219",
            "whol_loan_rmnd_amt": "441891",
            "whol_loan_rmnd_rate": "6.42",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.08",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "131030",
            "hts_kor_isnm": "옵투스제약",
            "stck_prpr": "6130",
            "prdy_vrss": "210",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "3.55",
            "acml_vol": "450441",
            "whol_loan_rmnd_stcn": "1034261",
            "whol_loan_rmnd_amt": "694025",
            "whol_loan_rmnd_rate": "6.39",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "098120",
            "hts_kor_isnm": "마이크로컨텍솔",
            "stck_prpr": "9450",
            "prdy_vrss": "170",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.83",
            "acml_vol": "85076",
            "whol_loan_rmnd_stcn": "530155",
            "whol_loan_rmnd_amt": "500738",
            "whol_loan_rmnd_rate": "6.37",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.22",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "182360",
            "hts_kor_isnm": "큐브엔터",
            "stck_prpr": "15540",
            "prdy_vrss": "-400",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.51",
            "acml_vol": "63162",
            "whol_loan_rmnd_stcn": "872814",
            "whol_loan_rmnd_amt": "1424695",
            "whol_loan_rmnd_rate": "6.31",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "151860",
            "hts_kor_isnm": "KG ETS",
            "stck_prpr": "8880",
            "prdy_vrss": "-230",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.52",
            "acml_vol": "104386",
            "whol_loan_rmnd_stcn": "2267472",
            "whol_loan_rmnd_amt": "2615797",
            "whol_loan_rmnd_rate": "6.29",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "027050",
            "hts_kor_isnm": "코리아나",
            "stck_prpr": "2910",
            "prdy_vrss": "-5",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.17",
            "acml_vol": "769994",
            "whol_loan_rmnd_stcn": "2504618",
            "whol_loan_rmnd_amt": "779004",
            "whol_loan_rmnd_rate": "6.25",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.12",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "004560",
            "hts_kor_isnm": "현대비앤지스틸",
            "stck_prpr": "21000",
            "prdy_vrss": "450",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.19",
            "acml_vol": "147828",
            "whol_loan_rmnd_stcn": "942853",
            "whol_loan_rmnd_amt": "1618795",
            "whol_loan_rmnd_rate": "6.24",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.17",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "230240",
            "hts_kor_isnm": "에치에프알",
            "stck_prpr": "13420",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-0.45",
            "acml_vol": "55089",
            "whol_loan_rmnd_stcn": "838985",
            "whol_loan_rmnd_amt": "1565881",
            "whol_loan_rmnd_rate": "6.21",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.05",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "059210",
            "hts_kor_isnm": "메타바이오메드",
            "stck_prpr": "4295",
            "prdy_vrss": "195",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.76",
            "acml_vol": "494936",
            "whol_loan_rmnd_stcn": "1484642",
            "whol_loan_rmnd_amt": "607071",
            "whol_loan_rmnd_rate": "6.21",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.01",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "220260",
            "hts_kor_isnm": "켐트로스",
            "stck_prpr": "7000",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "230100",
            "whol_loan_rmnd_stcn": "1640807",
            "whol_loan_rmnd_amt": "1332420",
            "whol_loan_rmnd_rate": "6.17",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.10",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "163730",
            "hts_kor_isnm": "핑거",
            "stck_prpr": "8590",
            "prdy_vrss": "70",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.82",
            "acml_vol": "19575",
            "whol_loan_rmnd_stcn": "576898",
            "whol_loan_rmnd_amt": "662547",
            "whol_loan_rmnd_rate": "6.16",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "263810",
            "hts_kor_isnm": "상신전자",
            "stck_prpr": "4140",
            "prdy_vrss": "50",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.22",
            "acml_vol": "88189",
            "whol_loan_rmnd_stcn": "877304",
            "whol_loan_rmnd_amt": "405633",
            "whol_loan_rmnd_rate": "6.15",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "189690",
            "hts_kor_isnm": "포시에스",
            "stck_prpr": "2840",
            "prdy_vrss": "15",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.53",
            "acml_vol": "172957",
            "whol_loan_rmnd_stcn": "1683864",
            "whol_loan_rmnd_amt": "496865",
            "whol_loan_rmnd_rate": "6.15",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "037950",
            "hts_kor_isnm": "엘컴텍",
            "stck_prpr": "1565",
            "prdy_vrss": "-24",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.51",
            "acml_vol": "8547977",
            "whol_loan_rmnd_stcn": "5175612",
            "whol_loan_rmnd_amt": "724012",
            "whol_loan_rmnd_rate": "6.12",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.24",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "200470",
            "hts_kor_isnm": "에이팩트",
            "stck_prpr": "5150",
            "prdy_vrss": "-70",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.34",
            "acml_vol": "970817",
            "whol_loan_rmnd_stcn": "2586717",
            "whol_loan_rmnd_amt": "1227462",
            "whol_loan_rmnd_rate": "6.10",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.07",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "263600",
            "hts_kor_isnm": "덕우전자",
            "stck_prpr": "8430",
            "prdy_vrss": "-320",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-3.66",
            "acml_vol": "423952",
            "whol_loan_rmnd_stcn": "972400",
            "whol_loan_rmnd_amt": "815829",
            "whol_loan_rmnd_rate": "6.10",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "036200",
            "hts_kor_isnm": "유니셈",
            "stck_prpr": "9380",
            "prdy_vrss": "170",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.85",
            "acml_vol": "1684457",
            "whol_loan_rmnd_stcn": "1867730",
            "whol_loan_rmnd_amt": "1467677",
            "whol_loan_rmnd_rate": "6.08",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.12",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "060540",
            "hts_kor_isnm": "에스에이티",
            "stck_prpr": "2325",
            "prdy_vrss": "45",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.97",
            "acml_vol": "682548",
            "whol_loan_rmnd_stcn": "1581922",
            "whol_loan_rmnd_amt": "379179",
            "whol_loan_rmnd_rate": "6.04",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.23",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "205470",
            "hts_kor_isnm": "휴마시스",
            "stck_prpr": "1905",
            "prdy_vrss": "0",
            "prdy_vrss_sign": "3",
            "prdy_ctrt": "0.00",
            "acml_vol": "1317440",
            "whol_loan_rmnd_stcn": "7800621",
            "whol_loan_rmnd_amt": "2190249",
            "whol_loan_rmnd_rate": "6.02",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.07",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "218150",
            "hts_kor_isnm": "미래생명자원",
            "stck_prpr": "4950",
            "prdy_vrss": "-60",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.20",
            "acml_vol": "422741",
            "whol_loan_rmnd_stcn": "1229435",
            "whol_loan_rmnd_amt": "628985",
            "whol_loan_rmnd_rate": "6.01",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "090410",
            "hts_kor_isnm": "덕신하우징",
            "stck_prpr": "1788",
            "prdy_vrss": "28",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.59",
            "acml_vol": "123642",
            "whol_loan_rmnd_stcn": "2770681",
            "whol_loan_rmnd_amt": "540342",
            "whol_loan_rmnd_rate": "6.00",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.02",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "058630",
            "hts_kor_isnm": "엠게임",
            "stck_prpr": "5460",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.18",
            "acml_vol": "49145",
            "whol_loan_rmnd_stcn": "1173440",
            "whol_loan_rmnd_amt": "737871",
            "whol_loan_rmnd_rate": "6.00",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.02",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "201490",
            "hts_kor_isnm": "미투온",
            "stck_prpr": "2655",
            "prdy_vrss": "10",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.38",
            "acml_vol": "64881",
            "whol_loan_rmnd_stcn": "1875620",
            "whol_loan_rmnd_amt": "672734",
            "whol_loan_rmnd_rate": "5.99",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.01",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "171010",
            "hts_kor_isnm": "램테크놀러지",
            "stck_prpr": "6310",
            "prdy_vrss": "130",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.10",
            "acml_vol": "11578890",
            "whol_loan_rmnd_stcn": "851142",
            "whol_loan_rmnd_amt": "505847",
            "whol_loan_rmnd_rate": "5.98",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.38",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "053030",
            "hts_kor_isnm": "바이넥스",
            "stck_prpr": "13600",
            "prdy_vrss": "1410",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "11.57",
            "acml_vol": "1566467",
            "whol_loan_rmnd_stcn": "1894439",
            "whol_loan_rmnd_amt": "2558217",
            "whol_loan_rmnd_rate": "5.96",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.13",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "318000",
            "hts_kor_isnm": "KBG",
            "stck_prpr": "7710",
            "prdy_vrss": "160",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.12",
            "acml_vol": "67145",
            "whol_loan_rmnd_stcn": "521071",
            "whol_loan_rmnd_amt": "448832",
            "whol_loan_rmnd_rate": "5.95",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.00",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "290550",
            "hts_kor_isnm": "디케이티",
            "stck_prpr": "9190",
            "prdy_vrss": "80",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.88",
            "acml_vol": "21953",
            "whol_loan_rmnd_stcn": "1113701",
            "whol_loan_rmnd_amt": "1072805",
            "whol_loan_rmnd_rate": "5.95",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.04",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "351330",
            "hts_kor_isnm": "이삭엔지니어링",
            "stck_prpr": "12290",
            "prdy_vrss": "540",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "4.60",
            "acml_vol": "260773",
            "whol_loan_rmnd_stcn": "490147",
            "whol_loan_rmnd_amt": "552994",
            "whol_loan_rmnd_rate": "5.91",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.14",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "046210",
            "hts_kor_isnm": "HLB파나진",
            "stck_prpr": "4435",
            "prdy_vrss": "25",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.57",
            "acml_vol": "321919",
            "whol_loan_rmnd_stcn": "2428843",
            "whol_loan_rmnd_amt": "1090733",
            "whol_loan_rmnd_rate": "5.91",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "224110",
            "hts_kor_isnm": "에이텍모빌리티",
            "stck_prpr": "14010",
            "prdy_vrss": "280",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "2.04",
            "acml_vol": "266427",
            "whol_loan_rmnd_stcn": "314930",
            "whol_loan_rmnd_amt": "505571",
            "whol_loan_rmnd_rate": "5.89",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.06",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "219130",
            "hts_kor_isnm": "타이거일렉",
            "stck_prpr": "28900",
            "prdy_vrss": "-650",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-2.20",
            "acml_vol": "124570",
            "whol_loan_rmnd_stcn": "371941",
            "whol_loan_rmnd_amt": "1020782",
            "whol_loan_rmnd_rate": "5.88",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.45",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "024060",
            "hts_kor_isnm": "흥구석유",
            "stck_prpr": "15550",
            "prdy_vrss": "140",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.91",
            "acml_vol": "7429882",
            "whol_loan_rmnd_stcn": "879083",
            "whol_loan_rmnd_amt": "1045599",
            "whol_loan_rmnd_rate": "5.85",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "1.46",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "033320",
            "hts_kor_isnm": "제이씨현시스템",
            "stck_prpr": "4070",
            "prdy_vrss": "40",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "0.99",
            "acml_vol": "58169",
            "whol_loan_rmnd_stcn": "1117574",
            "whol_loan_rmnd_amt": "564095",
            "whol_loan_rmnd_rate": "5.84",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.11",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "008700",
            "hts_kor_isnm": "아남전자",
            "stck_prpr": "1908",
            "prdy_vrss": "-20",
            "prdy_vrss_sign": "5",
            "prdy_ctrt": "-1.04",
            "acml_vol": "296451",
            "whol_loan_rmnd_stcn": "4516232",
            "whol_loan_rmnd_amt": "913342",
            "whol_loan_rmnd_rate": "5.84",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "-0.03",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        },
        {
            "mksc_shrn_iscd": "187270",
            "hts_kor_isnm": "신화콘텍",
            "stck_prpr": "4445",
            "prdy_vrss": "85",
            "prdy_vrss_sign": "2",
            "prdy_ctrt": "1.95",
            "acml_vol": "108191",
            "whol_loan_rmnd_stcn": "591576",
            "whol_loan_rmnd_amt": "256838",
            "whol_loan_rmnd_rate": "5.82",
            "whol_stln_rmnd_stcn": "0",
            "whol_stln_rmnd_amt": "0",
            "whol_stln_rmnd_rate": "0.00",
            "nday_vrss_loan_rmnd_inrt": "0.09",
            "nday_vrss_stln_rmnd_inrt": "0.00"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 배당률 상위[국내주식-106]

REST

국내주식 배당률 상위[국내주식-106]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/dividend-rate
  • Format
     
  • Content-Type
     

개요

국내주식 배당률 상위 API입니다.
한국투자 HTS(eFriend Plus) > [0188] 배당률 상위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

※ 30건 이상의 목록 조회가 필요한 경우, 대안으로 종목조건검색 API를 이용해서 원하는 종목 100개까지 검색할 수 있는 기능을 제공하고 있습니다.
종목조건검색 API는 HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API로,
자세한 사용 방법은 공지사항 - [조건검색 필독] 조건검색 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 HHKDB13470100
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
CTS_AREA CTS_AREA String Y 17 공백
GB1 KOSPI String Y 1 0:전체, 1:코스피, 2: 코스피200, 3: 코스닥,
UPJONG 업종구분 String Y 4 '코스피(0001:종합, 0002:대형주.…0027:제조업 ),
코스닥(1001:종합, …. 1041:IT부품
코스피200 (2001:KOSPI200, 2007:KOSPI100, 2008:KOSPI50)'
GB2 종목선택 String Y 1 0:전체, 6:보통주, 7:우선주
GB3 배당구분 String Y 1 1:주식배당, 2: 현금배당
F_DT 기준일From String Y 8
T_DT 기준일To String Y 8
GB4 결산/중간배당 String Y 1 0:전체, 1:결산배당, 2:중간배당

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-rank 순위 String Y 4
-sht_cd 종목코드 String Y 9
-isin_name 종목명 String Y 40
-record_date 기준일 String Y 8
-per_sto_divi_amt 현금/주식배당금 String Y 12
-divi_rate 현금/주식배당률(%) String Y 62
-divi_kind 배당종류 String Y 8

Example

Request

CTS_AREA:
GB1:0
UPJONG:0001
GB2:0
GB3:1
F_DT:20200101
T_DT:20240403
GB4:0

Response

{
    "output": [
        {
            "rank": "1",
            "sht_cd": "089600",
            "isin_name": "나스미디어",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "2",
            "sht_cd": "089600",
            "isin_name": "나스미디어",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "3",
            "sht_cd": "089600",
            "isin_name": "나스미디어",
            "record_date": "20221231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "4",
            "sht_cd": "243070",
            "isin_name": "휴온스",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "5",
            "sht_cd": "243070",
            "isin_name": "휴온스",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "6",
            "sht_cd": "086520",
            "isin_name": "에코프로",
            "record_date": "20221231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "7",
            "sht_cd": "084110",
            "isin_name": "휴온스글로벌",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "8",
            "sht_cd": "119610",
            "isin_name": "인터로조",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "9",
            "sht_cd": "086520",
            "isin_name": "에코프로",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "10",
            "sht_cd": "084110",
            "isin_name": "휴온스글로벌",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "11",
            "sht_cd": "239610",
            "isin_name": "에이치엘사이언스",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "12",
            "sht_cd": "068270",
            "isin_name": "셀트리온",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "13",
            "sht_cd": "049950",
            "isin_name": "미래컴퍼니",
            "record_date": "20221231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "14",
            "sht_cd": "068930",
            "isin_name": "디지털대성",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "15",
            "sht_cd": "086520",
            "isin_name": "에코프로",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "16",
            "sht_cd": "119610",
            "isin_name": "인터로조",
            "record_date": "20201231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "17",
            "sht_cd": "003300",
            "isin_name": "한일홀딩스",
            "record_date": "20211231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "18",
            "sht_cd": "001530",
            "isin_name": "디아이동일",
            "record_date": "20231231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "19",
            "sht_cd": "282880",
            "isin_name": "코윈테크",
            "record_date": "20231231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        },
        {
            "rank": "20",
            "sht_cd": "001530",
            "isin_name": "디아이동일",
            "record_date": "20221231",
            "per_sto_divi_amt": "0",
            "divi_rate": "0.00",
            "divi_kind": "결산"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시간외등락율순위 [국내주식-138]

REST

국내주식 시간외등락율순위 [국내주식-138]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/overtime-fluctuation
  • Format
     
  • Content-Type
     

개요

국내주식 시간외등락율순위 API입니다.
한국투자 HTS(eFriend Plus) > [0234] 시간외 등락률순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

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 FHPST02340000
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 시장구분코드 (J: 주식)
FID_MRKT_CLS_CODE 시장 구분 코드 String Y 2 공백 입력
FID_COND_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 Unique key(20234)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000(전체), 0001(코스피), 1001(코스닥)
FID_DIV_CLS_CODE 분류 구분 코드 String Y 2 1(상한가), 2(상승률), 3(보합),4(하한가),5(하락률)
FID_INPUT_PRICE_1 입력 가격1 String Y 12 입력값 없을때 전체 (가격 ~)
FID_INPUT_PRICE_2 입력 가격2 String Y 12 입력값 없을때 전체 (~ 가격)
FID_VOL_CNT 거래량 수 String Y 12 입력값 없을때 전체 (거래량 ~)
FID_TRGT_CLS_CODE 대상 구분 코드 String Y 32 공백 입력
FID_TRGT_EXLS_CLS_CODE 대상 제외 구분 코드 String Y 32 공백 입력

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output1 응답상세 Object Y
-ovtm_untp_uplm_issu_cnt 시간외 단일가 상한 종목 수 String Y 7
-ovtm_untp_ascn_issu_cnt 시간외 단일가 상승 종목 수 String Y 7
-ovtm_untp_stnr_issu_cnt 시간외 단일가 보합 종목 수 String Y 7
-ovtm_untp_lslm_issu_cnt 시간외 단일가 하한 종목 수 String Y 7
-ovtm_untp_down_issu_cnt 시간외 단일가 하락 종목 수 String Y 7
-ovtm_untp_acml_vol 시간외 단일가 누적 거래량 String Y 19
-ovtm_untp_acml_tr_pbmn 시간외 단일가 누적 거래대금 String Y 19
-ovtm_untp_exch_vol 시간외 단일가 거래소 거래량 String Y 18
-ovtm_untp_exch_tr_pbmn 시간외 단일가 거래소 거래대금 String Y 18
-ovtm_untp_kosdaq_vol 시간외 단일가 KOSDAQ 거래량 String Y 18
-ovtm_untp_kosdaq_tr_pbmn 시간외 단일가 KOSDAQ 거래대금 String Y 18
output2 응답상세 Object Array Y array
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-ovtm_untp_prpr 시간외 단일가 현재가 String Y 10
-ovtm_untp_prdy_vrss 시간외 단일가 전일 대비 String Y 10
-ovtm_untp_prdy_vrss_sign 시간외 단일가 전일 대비 부호 String Y 1
-ovtm_untp_prdy_ctrt 시간외 단일가 전일 대비율 String Y 82
-ovtm_untp_askp1 시간외 단일가 매도호가1 String Y 10
-ovtm_untp_seln_rsqn 시간외 단일가 매도 잔량 String Y 12
-ovtm_untp_bidp1 시간외 단일가 매수호가1 String Y 10
-ovtm_untp_shnu_rsqn 시간외 단일가 매수 잔량 String Y 12
-ovtm_untp_vol 시간외 단일가 거래량 String Y 18
-ovtm_vrss_acml_vol_rlim 시간외 대비 누적 거래량 비중 String Y 52
-stck_prpr 주식 현재가 String Y 10
-acml_vol 누적 거래량 String Y 18
-bidp 매수호가 String Y 10
-askp 매도호가 String Y 10

Example

Request

fid_cond_mrkt_div_code:J
fid_mrkt_cls_code:
fid_cond_scr_div_code:20234
fid_input_iscd:0000
fid_div_cls_code:2
fid_input_price_1:
fid_input_price_2:
fid_vol_cnt:
fid_trgt_cls_code:
fid_trgt_exls_cls_code:

Response

{
    "output1": {
        "ovtm_untp_uplm_issu_cnt": "2",
        "ovtm_untp_ascn_issu_cnt": "923",
        "ovtm_untp_stnr_issu_cnt": "634",
        "ovtm_untp_lslm_issu_cnt": "1",
        "ovtm_untp_down_issu_cnt": "731",
        "ovtm_untp_acml_vol": "30215421",
        "ovtm_untp_acml_tr_pbmn": "232960766966",
        "ovtm_untp_exch_vol": "15196593",
        "ovtm_untp_exch_tr_pbmn": "119450793021",
        "ovtm_untp_kosdaq_vol": "15018828",
        "ovtm_untp_kosdaq_tr_pbmn": "113509973945"
    },
    "output2": [
        {
            "mksc_shrn_iscd": "36328K",
            "hts_kor_isnm": "티와이홀딩스우",
            "ovtm_untp_prpr": "5880",
            "ovtm_untp_prdy_vrss": "530",
            "ovtm_untp_prdy_vrss_sign": "1",
            "ovtm_untp_prdy_ctrt": "9.91",
            "ovtm_untp_askp1": "0",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_bidp1": "5880",
            "ovtm_untp_shnu_rsqn": "13465",
            "ovtm_untp_vol": "19288",
            "ovtm_vrss_acml_vol_rlim": "12.06",
            "stck_prpr": "5480",
            "acml_vol": "159997",
            "bidp": "5470",
            "askp": "5480"
        },
        {
            "mksc_shrn_iscd": "025950",
            "hts_kor_isnm": "동신건설",
            "ovtm_untp_prpr": "21000",
            "ovtm_untp_prdy_vrss": "1890",
            "ovtm_untp_prdy_vrss_sign": "1",
            "ovtm_untp_prdy_ctrt": "9.89",
            "ovtm_untp_askp1": "0",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_bidp1": "21000",
            "ovtm_untp_shnu_rsqn": "27744",
            "ovtm_untp_vol": "46834",
            "ovtm_vrss_acml_vol_rlim": "12.37",
            "stck_prpr": "21250",
            "acml_vol": "378572",
            "bidp": "21150",
            "askp": "21250"
        },
        {
            "mksc_shrn_iscd": "465610",
            "hts_kor_isnm": "ACE 미국빅테크TOP7 Plus레버리지(합성)",
            "ovtm_untp_prpr": "16595",
            "ovtm_untp_prdy_vrss": "1465",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.68",
            "ovtm_untp_askp1": "16595",
            "ovtm_untp_seln_rsqn": "22",
            "ovtm_untp_bidp1": "15140",
            "ovtm_untp_shnu_rsqn": "623",
            "ovtm_untp_vol": "2",
            "ovtm_vrss_acml_vol_rlim": "0.01",
            "stck_prpr": "14430",
            "acml_vol": "26559",
            "bidp": "14430",
            "askp": "14450"
        },
        {
            "mksc_shrn_iscd": "201490",
            "hts_kor_isnm": "미투온",
            "ovtm_untp_prpr": "2785",
            "ovtm_untp_prdy_vrss": "245",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.65",
            "ovtm_untp_askp1": "2785",
            "ovtm_untp_seln_rsqn": "6957",
            "ovtm_untp_bidp1": "2540",
            "ovtm_untp_shnu_rsqn": "3182",
            "ovtm_untp_vol": "43772",
            "ovtm_vrss_acml_vol_rlim": "0.98",
            "stck_prpr": "2870",
            "acml_vol": "4444613",
            "bidp": "2870",
            "askp": "2880"
        },
        {
            "mksc_shrn_iscd": "448540",
            "hts_kor_isnm": "ACE 엔비디아채권혼합블룸버그",
            "ovtm_untp_prpr": "19690",
            "ovtm_untp_prdy_vrss": "1725",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.60",
            "ovtm_untp_askp1": "18945",
            "ovtm_untp_seln_rsqn": "47",
            "ovtm_untp_bidp1": "17980",
            "ovtm_untp_shnu_rsqn": "210",
            "ovtm_untp_vol": "21",
            "ovtm_vrss_acml_vol_rlim": "0.02",
            "stck_prpr": "17600",
            "acml_vol": "84622",
            "bidp": "17600",
            "askp": "17620"
        },
        {
            "mksc_shrn_iscd": "00499K",
            "hts_kor_isnm": "롯데지주우",
            "ovtm_untp_prpr": "38000",
            "ovtm_untp_prdy_vrss": "3300",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.51",
            "ovtm_untp_askp1": "38000",
            "ovtm_untp_seln_rsqn": "176",
            "ovtm_untp_bidp1": "34750",
            "ovtm_untp_shnu_rsqn": "60",
            "ovtm_untp_vol": "9",
            "ovtm_vrss_acml_vol_rlim": "64.29",
            "stck_prpr": "35150",
            "acml_vol": "14",
            "bidp": "34750",
            "askp": "35150"
        },
        {
            "mksc_shrn_iscd": "069140",
            "hts_kor_isnm": "누리플랜",
            "ovtm_untp_prpr": "1568",
            "ovtm_untp_prdy_vrss": "133",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.27",
            "ovtm_untp_askp1": "1552",
            "ovtm_untp_seln_rsqn": "4024",
            "ovtm_untp_bidp1": "1436",
            "ovtm_untp_shnu_rsqn": "2049",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "1438",
            "acml_vol": "31055",
            "bidp": "1435",
            "askp": "1438"
        },
        {
            "mksc_shrn_iscd": "007530",
            "hts_kor_isnm": "와이엠",
            "ovtm_untp_prpr": "2900",
            "ovtm_untp_prdy_vrss": "240",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "9.02",
            "ovtm_untp_askp1": "2900",
            "ovtm_untp_seln_rsqn": "4398",
            "ovtm_untp_bidp1": "2660",
            "ovtm_untp_shnu_rsqn": "1065",
            "ovtm_untp_vol": "11",
            "ovtm_vrss_acml_vol_rlim": "0.57",
            "stck_prpr": "2710",
            "acml_vol": "1918",
            "bidp": "2680",
            "askp": "2710"
        },
        {
            "mksc_shrn_iscd": "310870",
            "hts_kor_isnm": "디와이씨",
            "ovtm_untp_prpr": "1517",
            "ovtm_untp_prdy_vrss": "124",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "8.90",
            "ovtm_untp_askp1": "1516",
            "ovtm_untp_seln_rsqn": "20512",
            "ovtm_untp_bidp1": "1393",
            "ovtm_untp_shnu_rsqn": "1233",
            "ovtm_untp_vol": "5",
            "ovtm_vrss_acml_vol_rlim": "0.02",
            "stck_prpr": "1406",
            "acml_vol": "27844",
            "bidp": "1399",
            "askp": "1406"
        },
        {
            "mksc_shrn_iscd": "019490",
            "hts_kor_isnm": "하이트론",
            "ovtm_untp_prpr": "1350",
            "ovtm_untp_prdy_vrss": "110",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "8.87",
            "ovtm_untp_askp1": "1350",
            "ovtm_untp_seln_rsqn": "15196",
            "ovtm_untp_bidp1": "1240",
            "ovtm_untp_shnu_rsqn": "937",
            "ovtm_untp_vol": "22",
            "ovtm_vrss_acml_vol_rlim": "0.07",
            "stck_prpr": "1224",
            "acml_vol": "33488",
            "bidp": "1224",
            "askp": "1230"
        },
        {
            "mksc_shrn_iscd": "115570",
            "hts_kor_isnm": "스타플렉스",
            "ovtm_untp_prpr": "2995",
            "ovtm_untp_prdy_vrss": "225",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "8.12",
            "ovtm_untp_askp1": "2985",
            "ovtm_untp_seln_rsqn": "448",
            "ovtm_untp_bidp1": "2540",
            "ovtm_untp_shnu_rsqn": "428",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.03",
            "stck_prpr": "2720",
            "acml_vol": "3138",
            "bidp": "2710",
            "askp": "2720"
        },
        {
            "mksc_shrn_iscd": "045660",
            "hts_kor_isnm": "에이텍",
            "ovtm_untp_prpr": "15810",
            "ovtm_untp_prdy_vrss": "1130",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "7.70",
            "ovtm_untp_askp1": "15810",
            "ovtm_untp_seln_rsqn": "6365",
            "ovtm_untp_bidp1": "15800",
            "ovtm_untp_shnu_rsqn": "1930",
            "ovtm_untp_vol": "93555",
            "ovtm_vrss_acml_vol_rlim": "18.30",
            "stck_prpr": "15430",
            "acml_vol": "511314",
            "bidp": "15430",
            "askp": "15470"
        },
        {
            "mksc_shrn_iscd": "215380",
            "hts_kor_isnm": "우정바이오",
            "ovtm_untp_prpr": "1783",
            "ovtm_untp_prdy_vrss": "127",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "7.67",
            "ovtm_untp_askp1": "1787",
            "ovtm_untp_seln_rsqn": "5766",
            "ovtm_untp_bidp1": "1600",
            "ovtm_untp_shnu_rsqn": "500",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "1630",
            "acml_vol": "28468",
            "bidp": "1625",
            "askp": "1629"
        },
        {
            "mksc_shrn_iscd": "001130",
            "hts_kor_isnm": "대한제분",
            "ovtm_untp_prpr": "139000",
            "ovtm_untp_prdy_vrss": "9500",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "7.34",
            "ovtm_untp_askp1": "138900",
            "ovtm_untp_seln_rsqn": "6",
            "ovtm_untp_bidp1": "129700",
            "ovtm_untp_shnu_rsqn": "8",
            "ovtm_untp_vol": "7",
            "ovtm_vrss_acml_vol_rlim": "0.94",
            "stck_prpr": "131200",
            "acml_vol": "741",
            "bidp": "130000",
            "askp": "131000"
        },
        {
            "mksc_shrn_iscd": "003780",
            "hts_kor_isnm": "진양산업",
            "ovtm_untp_prpr": "6880",
            "ovtm_untp_prdy_vrss": "460",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "7.17",
            "ovtm_untp_askp1": "6900",
            "ovtm_untp_seln_rsqn": "1544",
            "ovtm_untp_bidp1": "6310",
            "ovtm_untp_shnu_rsqn": "1396",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "6580",
            "acml_vol": "20468",
            "bidp": "6560",
            "askp": "6580"
        },
        {
            "mksc_shrn_iscd": "456490",
            "hts_kor_isnm": "교보14호스팩",
            "ovtm_untp_prpr": "2390",
            "ovtm_untp_prdy_vrss": "155",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.94",
            "ovtm_untp_askp1": "2390",
            "ovtm_untp_seln_rsqn": "7226",
            "ovtm_untp_bidp1": "2040",
            "ovtm_untp_shnu_rsqn": "6697",
            "ovtm_untp_vol": "9",
            "ovtm_vrss_acml_vol_rlim": "3.15",
            "stck_prpr": "2255",
            "acml_vol": "286",
            "bidp": "2240",
            "askp": "2255"
        },
        {
            "mksc_shrn_iscd": "051630",
            "hts_kor_isnm": "진양화학",
            "ovtm_untp_prpr": "3800",
            "ovtm_untp_prdy_vrss": "235",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.59",
            "ovtm_untp_askp1": "3695",
            "ovtm_untp_seln_rsqn": "7469",
            "ovtm_untp_bidp1": "3570",
            "ovtm_untp_shnu_rsqn": "1053",
            "ovtm_untp_vol": "36",
            "ovtm_vrss_acml_vol_rlim": "0.37",
            "stck_prpr": "3590",
            "acml_vol": "9742",
            "bidp": "3570",
            "askp": "3590"
        },
        {
            "mksc_shrn_iscd": "049120",
            "hts_kor_isnm": "파인디앤씨",
            "ovtm_untp_prpr": "1420",
            "ovtm_untp_prdy_vrss": "87",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.53",
            "ovtm_untp_askp1": "1418",
            "ovtm_untp_seln_rsqn": "387",
            "ovtm_untp_bidp1": "1325",
            "ovtm_untp_shnu_rsqn": "31266",
            "ovtm_untp_vol": "10",
            "ovtm_vrss_acml_vol_rlim": "1.10",
            "stck_prpr": "1368",
            "acml_vol": "906",
            "bidp": "1356",
            "askp": "1368"
        },
        {
            "mksc_shrn_iscd": "083470",
            "hts_kor_isnm": "이엠앤아이",
            "ovtm_untp_prpr": "2060",
            "ovtm_untp_prdy_vrss": "125",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.46",
            "ovtm_untp_askp1": "2055",
            "ovtm_untp_seln_rsqn": "972",
            "ovtm_untp_bidp1": "1841",
            "ovtm_untp_shnu_rsqn": "777",
            "ovtm_untp_vol": "26",
            "ovtm_vrss_acml_vol_rlim": "0.10",
            "stck_prpr": "1896",
            "acml_vol": "26871",
            "bidp": "1884",
            "askp": "1896"
        },
        {
            "mksc_shrn_iscd": "388420",
            "hts_kor_isnm": "KBSTAR 비메모리반도체액티브",
            "ovtm_untp_prpr": "14750",
            "ovtm_untp_prdy_vrss": "885",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.38",
            "ovtm_untp_askp1": "13870",
            "ovtm_untp_seln_rsqn": "1434",
            "ovtm_untp_bidp1": "12685",
            "ovtm_untp_shnu_rsqn": "220",
            "ovtm_untp_vol": "70",
            "ovtm_vrss_acml_vol_rlim": "0.02",
            "stck_prpr": "13415",
            "acml_vol": "377764",
            "bidp": "13400",
            "askp": "13415"
        },
        {
            "mksc_shrn_iscd": "133820",
            "hts_kor_isnm": "화인베스틸",
            "ovtm_untp_prpr": "1365",
            "ovtm_untp_prdy_vrss": "81",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.31",
            "ovtm_untp_askp1": "1365",
            "ovtm_untp_seln_rsqn": "8677",
            "ovtm_untp_bidp1": "1284",
            "ovtm_untp_shnu_rsqn": "242",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "1285",
            "acml_vol": "20397",
            "bidp": "1285",
            "askp": "1293"
        },
        {
            "mksc_shrn_iscd": "049800",
            "hts_kor_isnm": "우진플라임",
            "ovtm_untp_prpr": "2870",
            "ovtm_untp_prdy_vrss": "170",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.30",
            "ovtm_untp_askp1": "2875",
            "ovtm_untp_seln_rsqn": "2633",
            "ovtm_untp_bidp1": "2680",
            "ovtm_untp_shnu_rsqn": "1305",
            "ovtm_untp_vol": "798",
            "ovtm_vrss_acml_vol_rlim": "9.24",
            "stck_prpr": "2695",
            "acml_vol": "8638",
            "bidp": "2685",
            "askp": "2690"
        },
        {
            "mksc_shrn_iscd": "045340",
            "hts_kor_isnm": "토탈소프트",
            "ovtm_untp_prpr": "5140",
            "ovtm_untp_prdy_vrss": "300",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.20",
            "ovtm_untp_askp1": "5150",
            "ovtm_untp_seln_rsqn": "4025",
            "ovtm_untp_bidp1": "5140",
            "ovtm_untp_shnu_rsqn": "8098",
            "ovtm_untp_vol": "5565",
            "ovtm_vrss_acml_vol_rlim": "4.73",
            "stck_prpr": "5030",
            "acml_vol": "117599",
            "bidp": "5000",
            "askp": "5030"
        },
        {
            "mksc_shrn_iscd": "300080",
            "hts_kor_isnm": "플리토",
            "ovtm_untp_prpr": "27550",
            "ovtm_untp_prdy_vrss": "1600",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.17",
            "ovtm_untp_askp1": "27550",
            "ovtm_untp_seln_rsqn": "5049",
            "ovtm_untp_bidp1": "27250",
            "ovtm_untp_shnu_rsqn": "712",
            "ovtm_untp_vol": "446",
            "ovtm_vrss_acml_vol_rlim": "1.30",
            "stck_prpr": "27000",
            "acml_vol": "34396",
            "bidp": "26950",
            "askp": "27000"
        },
        {
            "mksc_shrn_iscd": "359090",
            "hts_kor_isnm": "씨엔알리서치",
            "ovtm_untp_prpr": "2130",
            "ovtm_untp_prdy_vrss": "120",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "5.97",
            "ovtm_untp_askp1": "2130",
            "ovtm_untp_seln_rsqn": "495757",
            "ovtm_untp_bidp1": "2125",
            "ovtm_untp_shnu_rsqn": "129722",
            "ovtm_untp_vol": "1822458",
            "ovtm_vrss_acml_vol_rlim": "7.89",
            "stck_prpr": "2265",
            "acml_vol": "23096436",
            "bidp": "2265",
            "askp": "2270"
        },
        {
            "mksc_shrn_iscd": "442580",
            "hts_kor_isnm": "ARIRANG 글로벌D램반도체iSelect",
            "ovtm_untp_prpr": "19810",
            "ovtm_untp_prdy_vrss": "1080",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "5.77",
            "ovtm_untp_askp1": "0",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_bidp1": "0",
            "ovtm_untp_shnu_rsqn": "0",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.02",
            "stck_prpr": "18365",
            "acml_vol": "4438",
            "bidp": "18300",
            "askp": "18365"
        },
        {
            "mksc_shrn_iscd": "368970",
            "hts_kor_isnm": "오에스피",
            "ovtm_untp_prpr": "4665",
            "ovtm_untp_prdy_vrss": "225",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "5.07",
            "ovtm_untp_askp1": "4565",
            "ovtm_untp_seln_rsqn": "1134",
            "ovtm_untp_bidp1": "4360",
            "ovtm_untp_shnu_rsqn": "1418",
            "ovtm_untp_vol": "21",
            "ovtm_vrss_acml_vol_rlim": "0.32",
            "stck_prpr": "4420",
            "acml_vol": "6585",
            "bidp": "4410",
            "askp": "4420"
        },
        {
            "mksc_shrn_iscd": "079950",
            "hts_kor_isnm": "인베니아",
            "ovtm_untp_prpr": "1150",
            "ovtm_untp_prdy_vrss": "55",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "5.02",
            "ovtm_untp_askp1": "1150",
            "ovtm_untp_seln_rsqn": "8268",
            "ovtm_untp_bidp1": "1095",
            "ovtm_untp_shnu_rsqn": "2322",
            "ovtm_untp_vol": "109",
            "ovtm_vrss_acml_vol_rlim": "0.77",
            "stck_prpr": "1084",
            "acml_vol": "14193",
            "bidp": "1084",
            "askp": "1090"
        },
        {
            "mksc_shrn_iscd": "214260",
            "hts_kor_isnm": "라파스",
            "ovtm_untp_prpr": "13970",
            "ovtm_untp_prdy_vrss": "650",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "4.88",
            "ovtm_untp_askp1": "13960",
            "ovtm_untp_seln_rsqn": "618",
            "ovtm_untp_bidp1": "13330",
            "ovtm_untp_shnu_rsqn": "468",
            "ovtm_untp_vol": "2",
            "ovtm_vrss_acml_vol_rlim": "0.05",
            "stck_prpr": "13460",
            "acml_vol": "4348",
            "bidp": "13350",
            "askp": "13450"
        },
        {
            "mksc_shrn_iscd": "126640",
            "hts_kor_isnm": "화신정공",
            "ovtm_untp_prpr": "1502",
            "ovtm_untp_prdy_vrss": "69",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "4.82",
            "ovtm_untp_askp1": "1499",
            "ovtm_untp_seln_rsqn": "2789",
            "ovtm_untp_bidp1": "1435",
            "ovtm_untp_shnu_rsqn": "5500",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "1445",
            "acml_vol": "32541",
            "bidp": "1445",
            "askp": "1450"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시간외거래량순위 [국내주식-139]

REST

국내주식 시간외거래량순위 [국내주식-139]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/overtime-volume
  • Format
     
  • Content-Type
     

개요

국내주식 시간외거래량순위 API입니다.
한국투자 HTS(eFriend Plus) > [0235] 시간외 거래량순위 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
최대 30건 확인 가능하며, 다음 조회가 불가합니다.

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 FHPST02350000
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 시장구분코드 (J: 주식)
FID_COND_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 Unique key(20235)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000(전체), 0001(코스피), 1001(코스닥)
FID_RANK_SORT_CLS_CODE 순위 정렬 구분 코드 String Y 2 0(매수잔량), 1(매도잔량), 2(거래량)
FID_INPUT_PRICE_1 입력 가격1 String Y 12 가격 ~
FID_INPUT_PRICE_2 입력 가격2 String Y 12 ~ 가격
FID_VOL_CNT 거래량 수 String Y 12 거래량 ~
FID_TRGT_CLS_CODE 대상 구분 코드 String Y 32 공백
FID_TRGT_EXLS_CLS_CODE 대상 제외 구분 코드 String Y 32 공백

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output1 응답상세 Object Y
-ovtm_untp_exch_vol 시간외 단일가 거래소 거래량 String Y 18
-ovtm_untp_exch_tr_pbmn 시간외 단일가 거래소 거래대금 String Y 18
-ovtm_untp_kosdaq_vol 시간외 단일가 KOSDAQ 거래량 String Y 18
-ovtm_untp_kosdaq_tr_pbmn 시간외 단일가 KOSDAQ 거래대금 String Y 18
output2 응답상세 Object Array Y array
-stck_shrn_iscd 주식 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-ovtm_untp_prpr 시간외 단일가 현재가 String Y 10
-ovtm_untp_prdy_vrss 시간외 단일가 전일 대비 String Y 10
-ovtm_untp_prdy_vrss_sign 시간외 단일가 전일 대비 부호 String Y 1
-ovtm_untp_prdy_ctrt 시간외 단일가 전일 대비율 String Y 82
-ovtm_untp_seln_rsqn 시간외 단일가 매도 잔량 String Y 12
-ovtm_untp_shnu_rsqn 시간외 단일가 매수 잔량 String Y 12
-ovtm_untp_vol 시간외 단일가 거래량 String Y 18
-ovtm_vrss_acml_vol_rlim 시간외 대비 누적 거래량 비중 String Y 52
-stck_prpr 주식 현재가 String Y 10
-acml_vol 누적 거래량 String Y 18
-bidp 매수호가 String Y 10
-askp 매도호가 String Y 10

Example

Request

FID_COND_MRKT_DIV_CODE:J
FID_COND_SCR_DIV_CODE:20235
FID_INPUT_ISCD:0000
FID_RANK_SORT_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_VOL_CNT:
FID_TRGT_CLS_CODE:
FID_TRGT_EXLS_CLS_CODE:

Response

{
    "output1": {
        "ovtm_untp_exch_vol": "5806628",
        "ovtm_untp_exch_tr_pbmn": "54755931392",
        "ovtm_untp_kosdaq_vol": "5204621",
        "ovtm_untp_kosdaq_tr_pbmn": "47577538957"
    },
    "output2": [
        {
            "stck_shrn_iscd": "024840",
            "hts_kor_isnm": "KBI메탈",
            "ovtm_untp_prpr": "1805",
            "ovtm_untp_prdy_vrss": "164",
            "ovtm_untp_prdy_vrss_sign": "1",
            "ovtm_untp_prdy_ctrt": "9.99",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "1518111",
            "ovtm_untp_vol": "830822",
            "ovtm_vrss_acml_vol_rlim": "5.78",
            "stck_prpr": "1641",
            "acml_vol": "14376124",
            "bidp": "1641",
            "askp": "1642"
        },
        {
            "stck_shrn_iscd": "251340",
            "hts_kor_isnm": "KODEX 코스닥150선물인버스",
            "ovtm_untp_prpr": "3480",
            "ovtm_untp_prdy_vrss": "-5",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.14",
            "ovtm_untp_seln_rsqn": "483261",
            "ovtm_untp_shnu_rsqn": "1280469",
            "ovtm_untp_vol": "271489",
            "ovtm_vrss_acml_vol_rlim": "0.76",
            "stck_prpr": "3485",
            "acml_vol": "35798171",
            "bidp": "3480",
            "askp": "3485"
        },
        {
            "stck_shrn_iscd": "Q530036",
            "hts_kor_isnm": "삼성 인버스 2X WTI원유 선물 ETN",
            "ovtm_untp_prpr": "83",
            "ovtm_untp_prdy_vrss": "-1",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-1.19",
            "ovtm_untp_seln_rsqn": "733502",
            "ovtm_untp_shnu_rsqn": "1129085",
            "ovtm_untp_vol": "500",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "84",
            "acml_vol": "14500093",
            "bidp": "83",
            "askp": "84"
        },
        {
            "stck_shrn_iscd": "900110",
            "hts_kor_isnm": "이스트아시아홀딩스",
            "ovtm_untp_prpr": "92",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "116978",
            "ovtm_untp_shnu_rsqn": "929131",
            "ovtm_untp_vol": "3590",
            "ovtm_vrss_acml_vol_rlim": "0.33",
            "stck_prpr": "92",
            "acml_vol": "1072096",
            "bidp": "91",
            "askp": "92"
        },
        {
            "stck_shrn_iscd": "Q500027",
            "hts_kor_isnm": "신한 인버스 2X WTI원유 선물 ETN(H)",
            "ovtm_untp_prpr": "70",
            "ovtm_untp_prdy_vrss": "-1",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-1.41",
            "ovtm_untp_seln_rsqn": "146853",
            "ovtm_untp_shnu_rsqn": "736280",
            "ovtm_untp_vol": "800",
            "ovtm_vrss_acml_vol_rlim": "0.01",
            "stck_prpr": "71",
            "acml_vol": "11331167",
            "bidp": "70",
            "askp": "71"
        },
        {
            "stck_shrn_iscd": "900300",
            "hts_kor_isnm": "오가닉티코스메틱",
            "ovtm_untp_prpr": "86",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "259326",
            "ovtm_untp_shnu_rsqn": "542857",
            "ovtm_untp_vol": "2054",
            "ovtm_vrss_acml_vol_rlim": "0.03",
            "stck_prpr": "86",
            "acml_vol": "6493528",
            "bidp": "85",
            "askp": "86"
        },
        {
            "stck_shrn_iscd": "252670",
            "hts_kor_isnm": "KODEX 200선물인버스2X",
            "ovtm_untp_prpr": "2075",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "1095223",
            "ovtm_untp_shnu_rsqn": "487107",
            "ovtm_untp_vol": "385969",
            "ovtm_vrss_acml_vol_rlim": "0.29",
            "stck_prpr": "2075",
            "acml_vol": "131543542",
            "bidp": "2075",
            "askp": "2080"
        },
        {
            "stck_shrn_iscd": "900280",
            "hts_kor_isnm": "골든센츄리",
            "ovtm_untp_prpr": "105",
            "ovtm_untp_prdy_vrss": "1",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "0.96",
            "ovtm_untp_seln_rsqn": "305981",
            "ovtm_untp_shnu_rsqn": "297740",
            "ovtm_untp_vol": "112558",
            "ovtm_vrss_acml_vol_rlim": "0.90",
            "stck_prpr": "104",
            "acml_vol": "12494891",
            "bidp": "104",
            "askp": "105"
        },
        {
            "stck_shrn_iscd": "241770",
            "hts_kor_isnm": "메카로",
            "ovtm_untp_prpr": "11050",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "218703",
            "ovtm_untp_vol": "14328",
            "ovtm_vrss_acml_vol_rlim": "0.54",
            "stck_prpr": "11050",
            "acml_vol": "2660105",
            "bidp": "11050",
            "askp": "0"
        },
        {
            "stck_shrn_iscd": "039740",
            "hts_kor_isnm": "한국정보공학",
            "ovtm_untp_prpr": "3705",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "212928",
            "ovtm_untp_vol": "8904",
            "ovtm_vrss_acml_vol_rlim": "0.32",
            "stck_prpr": "3705",
            "acml_vol": "2745049",
            "bidp": "3705",
            "askp": "0"
        },
        {
            "stck_shrn_iscd": "443670",
            "hts_kor_isnm": "에스피소프트",
            "ovtm_untp_prpr": "19110",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "200228",
            "ovtm_untp_vol": "8728",
            "ovtm_vrss_acml_vol_rlim": "0.10",
            "stck_prpr": "19110",
            "acml_vol": "8933701",
            "bidp": "19110",
            "askp": "0"
        },
        {
            "stck_shrn_iscd": "114800",
            "hts_kor_isnm": "KODEX 인버스",
            "ovtm_untp_prpr": "4180",
            "ovtm_untp_prdy_vrss": "-5",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.12",
            "ovtm_untp_seln_rsqn": "113209",
            "ovtm_untp_shnu_rsqn": "132778",
            "ovtm_untp_vol": "19807",
            "ovtm_vrss_acml_vol_rlim": "0.08",
            "stck_prpr": "4185",
            "acml_vol": "23680596",
            "bidp": "4180",
            "askp": "4185"
        },
        {
            "stck_shrn_iscd": "Q550043",
            "hts_kor_isnm": "QV 인버스 레버리지 WTI원유 선물 ETN(H)",
            "ovtm_untp_prpr": "65",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "0",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "9499",
            "ovtm_untp_shnu_rsqn": "121250",
            "ovtm_untp_vol": "0",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "65",
            "acml_vol": "857825",
            "bidp": "64",
            "askp": "65"
        },
        {
            "stck_shrn_iscd": "032800",
            "hts_kor_isnm": "판타지오",
            "ovtm_untp_prpr": "293",
            "ovtm_untp_prdy_vrss": "-3",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-1.01",
            "ovtm_untp_seln_rsqn": "23665",
            "ovtm_untp_shnu_rsqn": "114241",
            "ovtm_untp_vol": "243174",
            "ovtm_vrss_acml_vol_rlim": "0.60",
            "stck_prpr": "296",
            "acml_vol": "40758423",
            "bidp": "295",
            "askp": "296"
        },
        {
            "stck_shrn_iscd": "900120",
            "hts_kor_isnm": "씨엑스아이",
            "ovtm_untp_prpr": "114",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "51602",
            "ovtm_untp_shnu_rsqn": "97874",
            "ovtm_untp_vol": "6",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "114",
            "acml_vol": "585089",
            "bidp": "113",
            "askp": "114"
        },
        {
            "stck_shrn_iscd": "006345",
            "hts_kor_isnm": "대원전선우",
            "ovtm_untp_prpr": "4425",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "73543",
            "ovtm_untp_vol": "53",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "4425",
            "acml_vol": "2444147",
            "bidp": "4425",
            "askp": "0"
        },
        {
            "stck_shrn_iscd": "152550",
            "hts_kor_isnm": "한국ANKOR유전",
            "ovtm_untp_prpr": "370",
            "ovtm_untp_prdy_vrss": "1",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "0.27",
            "ovtm_untp_seln_rsqn": "66842",
            "ovtm_untp_shnu_rsqn": "67407",
            "ovtm_untp_vol": "48762",
            "ovtm_vrss_acml_vol_rlim": "1.29",
            "stck_prpr": "369",
            "acml_vol": "3781036",
            "bidp": "368",
            "askp": "369"
        },
        {
            "stck_shrn_iscd": "036630",
            "hts_kor_isnm": "세종텔레콤",
            "ovtm_untp_prpr": "627",
            "ovtm_untp_prdy_vrss": "-2",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.32",
            "ovtm_untp_seln_rsqn": "794",
            "ovtm_untp_shnu_rsqn": "53745",
            "ovtm_untp_vol": "1660",
            "ovtm_vrss_acml_vol_rlim": "0.97",
            "stck_prpr": "629",
            "acml_vol": "171476",
            "bidp": "629",
            "askp": "630"
        },
        {
            "stck_shrn_iscd": "018470",
            "hts_kor_isnm": "조일알미늄",
            "ovtm_untp_prpr": "2375",
            "ovtm_untp_prdy_vrss": "150",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "6.74",
            "ovtm_untp_seln_rsqn": "84458",
            "ovtm_untp_shnu_rsqn": "49908",
            "ovtm_untp_vol": "1243060",
            "ovtm_vrss_acml_vol_rlim": "12.24",
            "stck_prpr": "2225",
            "acml_vol": "10159482",
            "bidp": "2225",
            "askp": "2230"
        },
        {
            "stck_shrn_iscd": "004410",
            "hts_kor_isnm": "서울식품",
            "ovtm_untp_prpr": "176",
            "ovtm_untp_prdy_vrss": "1",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "0.57",
            "ovtm_untp_seln_rsqn": "68739",
            "ovtm_untp_shnu_rsqn": "49034",
            "ovtm_untp_vol": "2",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "175",
            "acml_vol": "648132",
            "bidp": "175",
            "askp": "176"
        },
        {
            "stck_shrn_iscd": "015590",
            "hts_kor_isnm": "KIB플러그에너지",
            "ovtm_untp_prpr": "438",
            "ovtm_untp_prdy_vrss": "1",
            "ovtm_untp_prdy_vrss_sign": "2",
            "ovtm_untp_prdy_ctrt": "0.23",
            "ovtm_untp_seln_rsqn": "9286",
            "ovtm_untp_shnu_rsqn": "45672",
            "ovtm_untp_vol": "10598",
            "ovtm_vrss_acml_vol_rlim": "0.30",
            "stck_prpr": "437",
            "acml_vol": "3556231",
            "bidp": "437",
            "askp": "438"
        },
        {
            "stck_shrn_iscd": "011930",
            "hts_kor_isnm": "신성이엔지",
            "ovtm_untp_prpr": "2275",
            "ovtm_untp_prdy_vrss": "-5",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.22",
            "ovtm_untp_seln_rsqn": "14814",
            "ovtm_untp_shnu_rsqn": "45606",
            "ovtm_untp_vol": "24996",
            "ovtm_vrss_acml_vol_rlim": "0.88",
            "stck_prpr": "2280",
            "acml_vol": "2824930",
            "bidp": "2280",
            "askp": "2285"
        },
        {
            "stck_shrn_iscd": "001620",
            "hts_kor_isnm": "케이비아이동국실업",
            "ovtm_untp_prpr": "591",
            "ovtm_untp_prdy_vrss": "-1",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.17",
            "ovtm_untp_seln_rsqn": "6526",
            "ovtm_untp_shnu_rsqn": "43357",
            "ovtm_untp_vol": "10",
            "ovtm_vrss_acml_vol_rlim": "0.01",
            "stck_prpr": "592",
            "acml_vol": "180490",
            "bidp": "591",
            "askp": "592"
        },
        {
            "stck_shrn_iscd": "403490",
            "hts_kor_isnm": "우듬지팜",
            "ovtm_untp_prpr": "2220",
            "ovtm_untp_prdy_vrss": "-5",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.22",
            "ovtm_untp_seln_rsqn": "0",
            "ovtm_untp_shnu_rsqn": "39260",
            "ovtm_untp_vol": "785",
            "ovtm_vrss_acml_vol_rlim": "0.59",
            "stck_prpr": "2225",
            "acml_vol": "132387",
            "bidp": "2225",
            "askp": "2230"
        },
        {
            "stck_shrn_iscd": "461030",
            "hts_kor_isnm": "아이엠비디엑스",
            "ovtm_untp_prpr": "20500",
            "ovtm_untp_prdy_vrss": "-200",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.97",
            "ovtm_untp_seln_rsqn": "2804",
            "ovtm_untp_shnu_rsqn": "34783",
            "ovtm_untp_vol": "14490",
            "ovtm_vrss_acml_vol_rlim": "0.54",
            "stck_prpr": "20700",
            "acml_vol": "2705963",
            "bidp": "20650",
            "askp": "20700"
        },
        {
            "stck_shrn_iscd": "012170",
            "hts_kor_isnm": "아센디오",
            "ovtm_untp_prpr": "1059",
            "ovtm_untp_prdy_vrss": "-5",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.47",
            "ovtm_untp_seln_rsqn": "2520",
            "ovtm_untp_shnu_rsqn": "34715",
            "ovtm_untp_vol": "7166",
            "ovtm_vrss_acml_vol_rlim": "0.35",
            "stck_prpr": "1064",
            "acml_vol": "2070608",
            "bidp": "1063",
            "askp": "1064"
        },
        {
            "stck_shrn_iscd": "177350",
            "hts_kor_isnm": "베셀",
            "ovtm_untp_prpr": "425",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "11404",
            "ovtm_untp_shnu_rsqn": "33089",
            "ovtm_untp_vol": "5185",
            "ovtm_vrss_acml_vol_rlim": "0.15",
            "stck_prpr": "425",
            "acml_vol": "3365030",
            "bidp": "425",
            "askp": "426"
        },
        {
            "stck_shrn_iscd": "017040",
            "hts_kor_isnm": "광명전기",
            "ovtm_untp_prpr": "2735",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "17827",
            "ovtm_untp_shnu_rsqn": "33064",
            "ovtm_untp_vol": "45996",
            "ovtm_vrss_acml_vol_rlim": "0.31",
            "stck_prpr": "2735",
            "acml_vol": "14823773",
            "bidp": "2735",
            "askp": "2740"
        },
        {
            "stck_shrn_iscd": "377220",
            "hts_kor_isnm": "프롬바이오",
            "ovtm_untp_prpr": "2170",
            "ovtm_untp_prdy_vrss": "0",
            "ovtm_untp_prdy_vrss_sign": "3",
            "ovtm_untp_prdy_ctrt": "0.00",
            "ovtm_untp_seln_rsqn": "1471",
            "ovtm_untp_shnu_rsqn": "30408",
            "ovtm_untp_vol": "1",
            "ovtm_vrss_acml_vol_rlim": "0.00",
            "stck_prpr": "2170",
            "acml_vol": "220931",
            "bidp": "2170",
            "askp": "2190"
        },
        {
            "stck_shrn_iscd": "005320",
            "hts_kor_isnm": "국동",
            "ovtm_untp_prpr": "613",
            "ovtm_untp_prdy_vrss": "-4",
            "ovtm_untp_prdy_vrss_sign": "5",
            "ovtm_untp_prdy_ctrt": "-0.65",
            "ovtm_untp_seln_rsqn": "3",
            "ovtm_untp_shnu_rsqn": "29101",
            "ovtm_untp_vol": "23",
            "ovtm_vrss_acml_vol_rlim": "0.04",
            "stck_prpr": "617",
            "acml_vol": "56414",
            "bidp": "616",
            "askp": "617"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

HTS조회상위20종목 [국내주식-214]

REST

HTS조회상위20종목 [국내주식-214]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/ranking/hts-top-view
  • Format
     
  • Content-Type
     

개요

HTS조회상위20종목 API입니다.
한국투자 HTS(eFriend Plus) > [0158] 조회종목상위 화면의 "종목명", "종목코드" 표시 기능을 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 HHMCM000100C0
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해야 함

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output1 응답상세 Object Y
-mrkt_div_cls_code 시장구분 String Y 9 J : 코스피, Q : 코스닥
-mksc_shrn_iscd 종목코드 String Y 2 종목코드

Example

Request

없음

Response

{
    "output1": [
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "005930"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "233740"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "458650"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "042660"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "251340"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "000660"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "196170"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "475560"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "163280"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "001470"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "272210"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "017860"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "475960"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "000100"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "035420"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "460930"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "066970"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "378800"
        },
        {
            "mrkt_div_cls_code": "J",
            "mksc_shrn_iscd": "373220"
        },
        {
            "mrkt_div_cls_code": "Q",
            "mksc_shrn_iscd": "255220"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}