KIS Developers menu

API 문서 HOME API 문서 [국내주식] 시세분석


[국내주식] 시세분석

국내기관_외국인 매매종목가집계[국내주식-037]

REST

국내기관_외국인 매매종목가집계[국내주식-037]

기본정보

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

개요

국내기관_외국인 매매종목가집계 API입니다.
증권사 직원이 장중에 집계/입력한 자료를 단순 누계한 수치로서,
입력시간은 외국인 09:30, 11:20, 13:20, 14:30 / 기관종합 10:00, 11:20, 13:20, 14: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 FHPTJ04400000
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 V(Default)
FID_COND_SCR_DIV_CODE 조건 화면 분류 코드 String Y 5 16449(Default)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000:전체, 0001:코스피, 1001:코스닥
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조)
FID_DIV_CLS_CODE 분류 구분 코드 String Y 2 0: 수량정열, 1: 금액정열
FID_RANK_SORT_CLS_CODE 순위 정렬 구분 코드 String Y 2 0: 순매수상위, 1: 순매도상위
FID_ETC_CLS_CODE 기타 구분 정렬 String Y 2 0:전체 1:외국인 2:기관계 3:기타

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 응답상세1 Object Y
-hts_kor_isnm HTS 한글 종목명 String Y 40
-mksc_shrn_iscd 유가증권 단축 종목코드 String Y 9
-ntby_qty 순매수 수량 String Y 18
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_vrss 전일 대비 String Y 10
-prdy_ctrt 전일 대비율 String Y 8
-acml_vol 누적 거래량 String Y 18
-frgn_ntby_qty 외국인 순매수 수량 String Y 12
-orgn_ntby_qty 기관계 순매수 수량 String Y 18
-ivtr_ntby_qty 투자신탁 순매수 수량 String Y 12
-bank_ntby_qty 은행 순매수 수량 String Y 12
-insu_ntby_qty 보험 순매수 수량 String Y 12
-mrbn_ntby_qty 종금 순매수 수량 String Y 12
-fund_ntby_qty 기금 순매수 수량 String Y 12
-etc_orgt_ntby_vol 기타 단체 순매수 거래량 String Y 18
-etc_corp_ntby_vol 기타 법인 순매수 거래량 String Y 18
-frgn_ntby_tr_pbmn 외국인 순매수 거래 대금 String Y 18 frgn_ntby_tr_pbmn ~ etc_corp_ntby_tr_pbmn
(단위 : 백만원, 수량*현재가)
-orgn_ntby_tr_pbmn 기관계 순매수 거래 대금 String Y 18
-ivtr_ntby_tr_pbmn 투자신탁 순매수 거래 대금 String Y 18
-bank_ntby_tr_pbmn 은행 순매수 거래 대금 String Y 18
-insu_ntby_tr_pbmn 보험 순매수 거래 대금 String Y 18
-mrbn_ntby_tr_pbmn 종금 순매수 거래 대금 String Y 18
-fund_ntby_tr_pbmn 기금 순매수 거래 대금 String Y 18
-etc_orgt_ntby_tr_pbmn 기타 단체 순매수 거래 대금 String Y 18
-etc_corp_ntby_tr_pbmn 기타 법인 순매수 거래 대금 String Y 18

종목조건검색 목록조회[국내주식-038]

REST

종목조건검색 목록조회[국내주식-038]

기본정보

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

개요

HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API입니다.
종목조건검색 목록조회 API(/uapi/domestic-stock/v1/quotations/psearch-title)의 output인 'seq'을 종목조건검색조회 API(/uapi/domestic-stock/v1/quotations/psearch-result)의 input으로 사용하시면 됩니다.

※ 시스템 안정성을 위해 API로 제공되는 조건검색 결과의 경우 조건당 100건으로 제한을 둔 점 양해 부탁드립니다.

※ [0110] 화면의 '대상변경' 설정사항은 HTS [0110] 사용자 조건검색 화면에만 적용됨에 유의 부탁드립니다.

※ '조회가 계속 됩니다. (다음을 누르십시오.)' 오류 발생 시 해결방법
→ HTS(efriend Plus) [0110] 조건검색 화면에서 조건을 등록하신 후, 왼쪽 하단의 "사용자조건 서버저장" 클릭하셔서 등록한 조건들을 서버로 보낸 후 다시 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 HHKST03900300
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
user_id 사용자 HTS ID String Y 40

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
output2 응답상세 Object Array Y Array
-user_id HTS ID String Y 40
-seq 조건키값 String Y 10 해당 값을 종목조건검색조회 API의 input으로 사용
(0번부터 시작)
-grp_nm 그룹명 String Y 40 HTS(eFriend Plus) [0110] "사용자조건검색"화면을 통해
등록한 사용자조건 그룹
-condition_nm 조건명 String Y 40 등록한 사용자 조건명

Example

Request

{
"user_id":"abcd9876"
}

Response

{
    "output2": [
        {
            "user_id": "abcd9876",
            "seq": "0",
            "grp_nm": "임시그룹",
            "condition_nm": "RSI전략1_14_9_PER_부채비율"
        },
        {
            "user_id": "abcd9876",
            "seq": "1",
            "grp_nm": "임시그룹",
            "condition_nm": "모멘텀전략1_5_3_PER_부채비율"
        },
        {
            "user_id": "abcd9876",
            "seq": "2",
            "grp_nm": "임시그룹",
            "condition_nm": "외국계거래량_10000이상_PER_부채비율"
        },
        {
            "user_id": "abcd9876",
            "seq": "3",
            "grp_nm": "임시그룹",
            "condition_nm": "이평전략1_5_20_PER_부채비율"
        },
        {
            "user_id": "abcd9876",
            "seq": "4",
            "grp_nm": "임시그룹",
            "condition_nm": "이평전략2_5_20_PER_부채비율"
        },
        {
            "user_id": "abcd9876",
            "seq": "5",
            "grp_nm": "임시그룹",
            "condition_nm": "테스트3"
        },
        {
            "user_id": "abcd9876",
            "seq": "6",
            "grp_nm": "임시그룹",
            "condition_nm": "테트스"
        },
        {
            "user_id": "abcd9876",
            "seq": "7",
            "grp_nm": "임시그룹",
            "condition_nm": "테트스2"
        },
        {
            "user_id": "abcd9876",
            "seq": "8",
            "grp_nm": "임시그룹",
            "condition_nm": "투자경고제외"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

종목조건검색조회 [국내주식-039]

REST

종목조건검색조회 [국내주식-039]

기본정보

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

개요

HTS(efriend Plus) [0110] 조건검색에서 등록 및 서버저장한 나의 조건 목록을 확인할 수 있는 API입니다.
종목조건검색 목록조회 API(/uapi/domestic-stock/v1/quotations/psearch-title)의 output인 'seq'을 종목조건검색조회 API(/uapi/domestic-stock/v1/quotations/psearch-result)의 input으로 사용하시면 됩니다.

※ 시스템 안정성을 위해 API로 제공되는 조건검색 결과의 경우 조건당 100건으로 제한을 둔 점 양해 부탁드립니다.

※ [0110] 화면의 '대상변경' 설정사항은 HTS [0110] 사용자 조건검색 화면에만 적용됨에 유의 부탁드립니다.

※ '조회가 계속 됩니다. (다음을 누르십시오.)' 오류 발생 시 해결방법
→ HTS(efriend Plus) [0110] 조건검색 화면에서 조건을 등록하신 후, 왼쪽 하단의 "사용자조건 서버저장" 클릭하셔서 등록한 조건들을 서버로 보낸 후 다시 API 호출 시도 부탁드립니다.

※ {"rt_cd":"1","msg_cd":"MCA05918","msg1":"종목코드 오류입니다."} 메시지 발생 이유
→ 조건검색 결과 검색된 종목이 0개인 경우 위 응답값을 수신하게 됩니다.

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 HHKST03900400
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
user_id 사용자 HTS ID String Y 40
seq 사용자조건 키값 String Y 10 종목조건검색 목록조회 API의 output인 'seq'을 이용
(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
output2 응답상세 Object Array Y Array
-code 종목코드 String Y 6
-name 종목명 String Y 20
-daebi 전일대비부호 String Y 1 1. 상한 2. 상승 3. 보합 4. 하한 5. 하락
-price 현재가 String Y 16
-chgrate 등락율 String Y 16
-acml_vol 거래량 String Y 16
-trade_amt 거래대금 String Y 16
-change 전일대비 String Y 16
-cttr 체결강도 String Y 16
-open 시가 String Y 16
-high 고가 String Y 16
-low 저가 String Y 16
-high52 52주최고가 String Y 16
-low52 52주최저가 String Y 16
-expprice 예상체결가 String Y 16
-expchange 예상대비 String Y 16
-expchggrate 예상등락률 String Y 16
-expcvol 예상체결수량 String Y 16
-chgrate2 전일거래량대비율 String Y 16
-expdaebi 예상대비부호 String Y 1
-recprice 기준가 String Y 16
-uplmtprice 상한가 String Y 16
-dnlmtprice 하한가 String Y 16
-stotprice 시가총액 String Y 16

Example

Request

{
"user_id":"abcd4321",
"seq":"0"
}

Response

{
    "output2": [
        {
            "code": "000120",
            "name": "CJ대한통운",
            "daebi": "0",
            "price": "00000138600.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "     148600.0000",
            "low52": "      69000.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "     138600.0000",
            "uplmtprice": "     180100.0000",
            "dnlmtprice": "      97100.0000",
            "stotprice": "      31617.9088"
        },
        {
            "code": "002320",
            "name": "한진",
            "daebi": "0",
            "price": "00000024350.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      27300.0000",
            "low52": "      18010.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      24350.0000",
            "uplmtprice": "      31650.0000",
            "dnlmtprice": "      17050.0000",
            "stotprice": "       3639.7474"
        },
        {
            "code": "002680",
            "name": "한탑",
            "daebi": "0",
            "price": "00000001234.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       2275.0000",
            "low52": "       1125.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       1234.0000",
            "uplmtprice": "       1604.0000",
            "dnlmtprice": "        864.0000",
            "stotprice": "        398.7893"
        },
        {
            "code": "004710",
            "name": "한솔테크닉스",
            "daebi": "0",
            "price": "00000007070.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       8390.0000",
            "low52": "       5230.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       7070.0000",
            "uplmtprice": "       9190.0000",
            "dnlmtprice": "       4950.0000",
            "stotprice": "       2270.1684"
        },
        {
            "code": "005300",
            "name": "롯데칠성",
            "daebi": "0",
            "price": "00000127600.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "     174900.0000",
            "low52": "     117300.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "     127600.0000",
            "uplmtprice": "     165800.0000",
            "dnlmtprice": "      89400.0000",
            "stotprice": "      11839.8560"
        },
        {
            "code": "009070",
            "name": "KCTC",
            "daebi": "0",
            "price": "00000004145.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5390.0000",
            "low52": "       3550.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       4145.0000",
            "uplmtprice": "       5380.0000",
            "dnlmtprice": "       2905.0000",
            "stotprice": "       1243.5000"
        },
        {
            "code": "010420",
            "name": "한솔PNS",
            "daebi": "0",
            "price": "00000001221.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       1750.0000",
            "low52": "       1181.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       1221.0000",
            "uplmtprice": "       1587.0000",
            "dnlmtprice": "        855.0000",
            "stotprice": "        250.2197"
        },
        {
            "code": "015260",
            "name": "에이엔피",
            "daebi": "0",
            "price": "00000001052.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       2620.0000",
            "low52": "       1034.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       1052.0000",
            "uplmtprice": "       1367.0000",
            "dnlmtprice": "        737.0000",
            "stotprice": "        474.6297"
        },
        {
            "code": "015360",
            "name": "예스코홀딩스",
            "daebi": "0",
            "price": "00000037000.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      37750.0000",
            "low52": "      30400.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      37000.0000",
            "uplmtprice": "      48100.0000",
            "dnlmtprice": "      25900.0000",
            "stotprice": "       2220.0000"
        },
        {
            "code": "036460",
            "name": "한국가스공사",
            "daebi": "0",
            "price": "00000026800.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      32250.0000",
            "low52": "      22750.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      26800.0000",
            "uplmtprice": "      34800.0000",
            "dnlmtprice": "      18800.0000",
            "stotprice": "      24739.8840"
        },
        {
            "code": "036710",
            "name": "심텍홀딩스",
            "daebi": "0",
            "price": "00000002900.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       4190.0000",
            "low52": "       2380.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       2900.0000",
            "uplmtprice": "       3770.0000",
            "dnlmtprice": "       2030.0000",
            "stotprice": "       1402.1542"
        },
        {
            "code": "036800",
            "name": "나이스정보통신",
            "daebi": "0",
            "price": "00000022350.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      29500.0000",
            "low52": "      19910.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      22350.0000",
            "uplmtprice": "      29050.0000",
            "dnlmtprice": "      15650.0000",
            "stotprice": "       2235.0000"
        },
        {
            "code": "053050",
            "name": "지에스이",
            "daebi": "0",
            "price": "00000003525.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5570.0000",
            "low52": "       2810.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       3525.0000",
            "uplmtprice": "       4580.0000",
            "dnlmtprice": "       2470.0000",
            "stotprice": "       1057.0628"
        },
        {
            "code": "053450",
            "name": "세코닉스",
            "daebi": "0",
            "price": "00000008000.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       9960.0000",
            "low52": "       5370.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       8000.0000",
            "uplmtprice": "      10400.0000",
            "dnlmtprice": "       5600.0000",
            "stotprice": "       1183.4242"
        },
        {
            "code": "058850",
            "name": "KTcs",
            "daebi": "0",
            "price": "00000003800.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5920.0000",
            "low52": "       2790.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       3800.0000",
            "uplmtprice": "       4940.0000",
            "dnlmtprice": "       2660.0000",
            "stotprice": "       1622.0300"
        },
        {
            "code": "058860",
            "name": "KTis",
            "daebi": "0",
            "price": "00000003080.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5230.0000",
            "low52": "       2695.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       3080.0000",
            "uplmtprice": "       4000.0000",
            "dnlmtprice": "       2160.0000",
            "stotprice": "       1071.9016"
        },
        {
            "code": "063570",
            "name": "한국전자금융",
            "daebi": "0",
            "price": "00000006610.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       7520.0000",
            "low52": "       4665.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       6610.0000",
            "uplmtprice": "       8590.0000",
            "dnlmtprice": "       4630.0000",
            "stotprice": "       2257.1648"
        },
        {
            "code": "069640",
            "name": "한세엠케이",
            "daebi": "0",
            "price": "00000002095.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       4170.0000",
            "low52": "       1960.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       2095.0000",
            "uplmtprice": "       2720.0000",
            "dnlmtprice": "       1470.0000",
            "stotprice": "        630.7312"
        },
        {
            "code": "071670",
            "name": "에이테크솔루션",
            "daebi": "0",
            "price": "00000010860.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      15200.0000",
            "low52": "       9500.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      10860.0000",
            "uplmtprice": "      14110.0000",
            "dnlmtprice": "       7610.0000",
            "stotprice": "       1086.0000"
        },
        {
            "code": "085660",
            "name": "차바이오텍",
            "daebi": "0",
            "price": "00000018010.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      23100.0000",
            "low52": "      11790.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      18010.0000",
            "uplmtprice": "      23400.0000",
            "dnlmtprice": "      12610.0000",
            "stotprice": "      10142.2312"
        },
        {
            "code": "092300",
            "name": "현우산업",
            "daebi": "0",
            "price": "00000004315.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       6850.0000",
            "low52": "       3570.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       4315.0000",
            "uplmtprice": "       5600.0000",
            "dnlmtprice": "       3025.0000",
            "stotprice": "        805.7320"
        },
        {
            "code": "111110",
            "name": "호전실업",
            "daebi": "0",
            "price": "00000007740.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       9100.0000",
            "low52": "       7290.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       7740.0000",
            "uplmtprice": "      10060.0000",
            "dnlmtprice": "       5420.0000",
            "stotprice": "        754.6488"
        },
        {
            "code": "115530",
            "name": "씨엔플러스",
            "daebi": "0",
            "price": "00000000325.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "        650.0000",
            "low52": "        301.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "        325.0000",
            "uplmtprice": "        422.0000",
            "dnlmtprice": "        228.0000",
            "stotprice": "        220.8798"
        },
        {
            "code": "128820",
            "name": "대성산업",
            "daebi": "0",
            "price": "00000004000.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5000.0000",
            "low52": "       3405.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       4000.0000",
            "uplmtprice": "       5200.0000",
            "dnlmtprice": "       2800.0000",
            "stotprice": "       1809.4191"
        },
        {
            "code": "145210",
            "name": "다이나믹디자인",
            "daebi": "0",
            "price": "00000005720.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      12630.0000",
            "low52": "       2780.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       5720.0000",
            "uplmtprice": "       7430.0000",
            "dnlmtprice": "       4010.0000",
            "stotprice": "        989.6225"
        },
        {
            "code": "210120",
            "name": "빅텐츠",
            "daebi": "0",
            "price": "00000016170.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      45700.0000",
            "low52": "       9050.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      16170.0000",
            "uplmtprice": "      21000.0000",
            "dnlmtprice": "      11320.0000",
            "stotprice": "        508.4834"
        },
        {
            "code": "214680",
            "name": "디알텍",
            "daebi": "0",
            "price": "00000003990.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       7590.0000",
            "low52": "       1513.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       3990.0000",
            "uplmtprice": "       5180.0000",
            "dnlmtprice": "       2795.0000",
            "stotprice": "       2921.4692"
        },
        {
            "code": "216050",
            "name": "인크로스",
            "daebi": "0",
            "price": "00000011110.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "      20550.0000",
            "low52": "       9690.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "      11110.0000",
            "uplmtprice": "      14440.0000",
            "dnlmtprice": "       7780.0000",
            "stotprice": "       1426.8820"
        },
        {
            "code": "221840",
            "name": "하이즈항공",
            "daebi": "0",
            "price": "00000002420.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       3835.0000",
            "low52": "       2385.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       2420.0000",
            "uplmtprice": "       3145.0000",
            "dnlmtprice": "       1695.0000",
            "stotprice": "        452.5536"
        },
        {
            "code": "278650",
            "name": "HLB바이오스텝",
            "daebi": "0",
            "price": "00000003870.0000",
            "chgrate": "          0.0000",
            "acml_vol": "          0.0000",
            "trade_amt": "          0.0000",
            "change": "          0.0000",
            "cttr": "          0.0000",
            "open": "          0.0000",
            "high": "          0.0000",
            "low": "          0.0000",
            "high52": "       5380.0000",
            "low52": "       2430.0000",
            "expprice": "00000000000.0000",
            "expchange": "          0.0000",
            "expchggrate": "       -100.0000",
            "expcvol": "          0.0000",
            "chgrate2": "          0.0000",
            "expdaebi": "5",
            "recprice": "       3870.0000",
            "uplmtprice": "       5030.0000",
            "dnlmtprice": "       2710.0000",
            "stotprice": "       3106.5775"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

종목별 프로그램매매추이(체결)[v1_국내주식-044]

REST

종목별 프로그램매매추이(체결)[v1_국내주식-044]

기본정보

  • Method
    GET
  • 실전 Domain
    https://openapi.koreainvestment.com:9443
  • 모의 Domain
    모의투자 미지원
  • URL
    /uapi/domestic-stock/v1/quotations/program-trade-by-stock
  • Format
    JSON
  • Content-Type
    application/octet-stream

개요

국내주식 종목별 프로그램매매추이(체결) API입니다.

한국투자 HTS(eFriend Plus) > [0465] 종목별 프로그램 매매추이 화면(혹은 한국투자 MTS > 국내 현재가 > 기타수급 > 프로그램) 의 기능을 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 FHPPG04650100
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 입력 종목코드 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
Output1 응답상세 Object Array Y Array
-bsop_hour 영업 시간 String Y 6
-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_smtn_seln_vol 전체 합계 매도 거래량 String Y 18
-whol_smtn_shnu_vol 전체 합계 매수2 거래량 String Y 18
-whol_smtn_ntby_qty 전체 합계 순매수 수량 String Y 18
-whol_smtn_seln_tr_pbmn 전체 합계 매도 거래 대금 String Y 18
-whol_smtn_shnu_tr_pbmn 전체 합계 매수2 거래 대금 String Y 18
-whol_smtn_ntby_tr_pbmn 전체 합계 순매수 거래 대금 String Y 18
-whol_ntby_vol_icdc 전체 순매수 거래량 증감 String Y 10
-whol_ntby_tr_pbmn_icdc 전체 순매수 거래 대금 증감 String Y 10

종목별 외인기관 추정가집계[v1_국내주식-046]

REST

종목별 외인기관 추정가집계[v1_국내주식-046]

기본정보

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

개요

국내주식 종목별 외국인, 기관 추정가집계 API입니다.

한국투자 MTS > 국내 현재가 > 투자자 > 투자자동향 탭 > 왼쪽구분을 '추정(주)'로 선택 시 확인 가능한 데이터를 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.

증권사 직원이 장중에 집계/입력한 자료를 단순 누계한 수치로서,
입력시간은 외국인 09:30, 11:20, 13:20, 14:30 / 기관종합 10:00, 11:20, 13:20, 14: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 HHPTJ04160200
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
MKSC_SHRN_ISCD 종목코드 String Y 12 종목코드

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-bsop_hour_gb 입력구분 String Y 1 1: 09시 30분 입력
2: 10시 00분 입력
3: 11시 20분 입력
4: 13시 20분 입력
5: 14시 30분 입력
-frgn_fake_ntby_qty 외국인수량(가집계) String Y 18
-orgn_fake_ntby_qty 기관수량(가집계) String Y 18
-sum_fake_ntby_qty 합산수량(가집계) String Y 18

Example

Request

{
   "MKSC_SHRN_ISCD":"000660"
}

Response

{
    "output2": [
        {
            "bsop_hour_gb": "5",
            "frgn_fake_ntby_qty": "-00000000000030000",
            "orgn_fake_ntby_qty": "000000000000121000",
            "sum_fake_ntby_qty": "000000000000091000"
        },
        {
            "bsop_hour_gb": "4",
            "frgn_fake_ntby_qty": "-00000000000093000",
            "orgn_fake_ntby_qty": "000000000000130000",
            "sum_fake_ntby_qty": "000000000000037000"
        },
        {
            "bsop_hour_gb": "3",
            "frgn_fake_ntby_qty": "-00000000000026000",
            "orgn_fake_ntby_qty": "000000000000037000",
            "sum_fake_ntby_qty": "000000000000011000"
        },
        {
            "bsop_hour_gb": "2",
            "frgn_fake_ntby_qty": "-00000000000038000",
            "orgn_fake_ntby_qty": "000000000000022000",
            "sum_fake_ntby_qty": "-00000000000016000"
        },
        {
            "bsop_hour_gb": "1",
            "frgn_fake_ntby_qty": "-00000000000023000",
            "orgn_fake_ntby_qty": "000000000000000000",
            "sum_fake_ntby_qty": "-00000000000023000"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

종목별일별매수매도체결량 [v1_국내주식-056]

REST

종목별일별매수매도체결량 [v1_국내주식-056]

기본정보

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

개요

종목별일별매수매도체결량 API입니다. 실전계좌의 경우, 한 번의 호출에 최대 100건까지 확인 가능합니다.
국내주식 종목의 일별 매수체결량, 매도체결량 데이터를 확인할 수 있습니다.

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 FHKST03010800
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 FID 조건 시장 분류 코드 String Y 2 J
FID_INPUT_ISCD FID 입력 종목코드 String Y 12 005930
FID_INPUT_DATE_1 FID 입력 날짜1 String Y 10 from
FID_INPUT_DATE_2 FID 입력 날짜2 String Y 10 to
FID_PERIOD_DIV_CODE FID 기간 분류 코드 String Y 32 D

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
-shnu_cnqn_smtn 매수 체결량 합계 String Y 18 당일 매수체결량 합계
-seln_cnqn_smtn 매도 체결량 합계 String Y 18 당일 매도체결량 합계
output2 응답상세2 Object Array Y array
-stck_bsop_date 주식 영업 일자 String Y 8
-total_seln_qty 총 매도 수량 String Y 18
-total_shnu_qty 총 매수 수량 String Y 18

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_input_date_1":"20240101",
"fid_input_date_2":"20240126",
"fid_period_div_code":"D"
}

Response

{
    "output1": {
        "shnu_cnqn_smtn": "4520816",
        "seln_cnqn_smtn": "5285722"
    },
    "output2": [
        {
            "stck_bsop_date": "20240126",
            "total_seln_qty": "5285722",
            "total_shnu_qty": "4520816"
        },
        {
            "stck_bsop_date": "20240125",
            "total_seln_qty": "5610781",
            "total_shnu_qty": "4008095"
        },
        {
            "stck_bsop_date": "20240124",
            "total_seln_qty": "7001409",
            "total_shnu_qty": "4628223"
        },
        {
            "stck_bsop_date": "20240123",
            "total_seln_qty": "6929612",
            "total_shnu_qty": "6221072"
        },
        {
            "stck_bsop_date": "20240122",
            "total_seln_qty": "9304203",
            "total_shnu_qty": "8269298"
        },
        {
            "stck_bsop_date": "20240119",
            "total_seln_qty": "7937786",
            "total_shnu_qty": "12024544"
        },
        {
            "stck_bsop_date": "20240118",
            "total_seln_qty": "7130130",
            "total_shnu_qty": "8051305"
        },
        {
            "stck_bsop_date": "20240117",
            "total_seln_qty": "12448352",
            "total_shnu_qty": "7781842"
        },
        {
            "stck_bsop_date": "20240116",
            "total_seln_qty": "7231456",
            "total_shnu_qty": "5660392"
        },
        {
            "stck_bsop_date": "20240115",
            "total_seln_qty": "5146657",
            "total_shnu_qty": "6242907"
        },
        {
            "stck_bsop_date": "20240112",
            "total_seln_qty": "6112124",
            "total_shnu_qty": "5706461"
        },
        {
            "stck_bsop_date": "20240111",
            "total_seln_qty": "10835895",
            "total_shnu_qty": "10905905"
        },
        {
            "stck_bsop_date": "20240110",
            "total_seln_qty": "12367976",
            "total_shnu_qty": "6256368"
        },
        {
            "stck_bsop_date": "20240109",
            "total_seln_qty": "16376304",
            "total_shnu_qty": "7458947"
        },
        {
            "stck_bsop_date": "20240108",
            "total_seln_qty": "5318849",
            "total_shnu_qty": "4631085"
        },
        {
            "stck_bsop_date": "20240105",
            "total_seln_qty": "4907468",
            "total_shnu_qty": "5219184"
        },
        {
            "stck_bsop_date": "20240104",
            "total_seln_qty": "6041013",
            "total_shnu_qty": "7038798"
        },
        {
            "stck_bsop_date": "20240103",
            "total_seln_qty": "12066549",
            "total_shnu_qty": "7713276"
        },
        {
            "stck_bsop_date": "20240102",
            "total_seln_qty": "5855872",
            "total_shnu_qty": "9333762"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

시장별 투자자매매동향(시세)[v1_국내주식-074]

REST

시장별 투자자매매동향(시세)[v1_국내주식-074]

기본정보

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

개요

시장별 투자자매매동향(시세성) API입니다.
한국투자 HTS(eFriend Plus) > [0403] 시장별 시간동향 의 상단 표 기능을 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 FHPTJ04030000
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 업종구분 String Y 8 - fid_input_iscd: KSP(코스피) 혹은 KSQ(코스닥)인 경우
코스피(0001_종합, .…0027_제조업 )
코스닥(1001_종합, …. 1041_IT부품)
...
포탈 (FAQ : 종목정보 다운로드(국내) - 업종코드 참조)

- fid_input_iscd가 K2I인 경우
F001(선물)
OC01(콜옵션)
OP01(풋옵션)

- fid_input_iscd가 999인 경우
S001(주식선물)

- fid_input_iscd가 ETF인 경우
T000(ETF)

- fid_input_iscd가 ELW인 경우
W000(ELW)

- fid_input_iscd가 ETN인 경우
E199(ETN)

- fid_input_iscd가 MKI인 경우
F004(미니선물)
OC02(미니콜옵션)
OP02(미니풋옵션)

- fid_input_iscd가 WKM인 경우
OC05(위클리콜(월))
OP05(위클리풋(월))

- fid_input_iscd가 WKI인 경우
OC04(위클리콜(목))
OP04(위클리풋(목))

- fid_input_iscd가 KQI인 경우
F002(코스닥150선물)
OC03(코스닥150콜옵션)
OP03(코스닥150풋옵션)
fid_input_iscd 시장구분 String Y 12 코스피: KSP, 코스닥:KSQ,
선물,콜옵션,풋옵션 : K2I, 주식선물:999,
ETF: ETF, ELW:ELW, ETN: ETN,
미니: MKI, 위클리월 : WKM, 위클리목: WKI
코스닥150: KQI

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 Y
-frgn_seln_vol 외국인 매도 거래량 String Y 18
-frgn_shnu_vol 외국인 매수2 거래량 String Y 18
-frgn_ntby_qty 외국인 순매수 수량 String Y 12
-frgn_seln_tr_pbmn 외국인 매도 거래 대금 String Y 18
-frgn_shnu_tr_pbmn 외국인 매수2 거래 대금 String Y 18
-frgn_ntby_tr_pbmn 외국인 순매수 거래 대금 String Y 18
-prsn_seln_vol 개인 매도 거래량 String Y 18
-prsn_shnu_vol 개인 매수2 거래량 String Y 18
-prsn_ntby_qty 개인 순매수 수량 String Y 12
-prsn_seln_tr_pbmn 개인 매도 거래 대금 String Y 18
-prsn_shnu_tr_pbmn 개인 매수2 거래 대금 String Y 18
-prsn_ntby_tr_pbmn 개인 순매수 거래 대금 String Y 18
-orgn_seln_vol 기관계 매도 거래량 String Y 18
-orgn_shnu_vol 기관계 매수2 거래량 String Y 18
-orgn_ntby_qty 기관계 순매수 수량 String Y 18
-orgn_seln_tr_pbmn 기관계 매도 거래 대금 String Y 18
-orgn_shnu_tr_pbmn 기관계 매수2 거래 대금 String Y 18
-orgn_ntby_tr_pbmn 기관계 순매수 거래 대금 String Y 18
-scrt_seln_vol 증권 매도 거래량 String Y 18
-scrt_shnu_vol 증권 매수2 거래량 String Y 18
-scrt_ntby_qty 증권 순매수 수량 String Y 12
-scrt_seln_tr_pbmn 증권 매도 거래 대금 String Y 18
-scrt_shnu_tr_pbmn 증권 매수2 거래 대금 String Y 18
-scrt_ntby_tr_pbmn 증권 순매수 거래 대금 String Y 18
-ivtr_seln_vol 투자신탁 매도 거래량 String Y 18
-ivtr_shnu_vol 투자신탁 매수2 거래량 String Y 18
-ivtr_ntby_qty 투자신탁 순매수 수량 String Y 12
-ivtr_seln_tr_pbmn 투자신탁 매도 거래 대금 String Y 18
-ivtr_shnu_tr_pbmn 투자신탁 매수2 거래 대금 String Y 18
-ivtr_ntby_tr_pbmn 투자신탁 순매수 거래 대금 String Y 18
-pe_fund_seln_tr_pbmn 사모 펀드 매도 거래 대금 String Y 18
-pe_fund_seln_vol 사모 펀드 매도 거래량 String Y 18
-pe_fund_ntby_vol 사모 펀드 순매수 거래량 String Y 18
-pe_fund_shnu_tr_pbmn 사모 펀드 매수2 거래 대금 String Y 18
-pe_fund_shnu_vol 사모 펀드 매수2 거래량 String Y 18
-pe_fund_ntby_tr_pbmn 사모 펀드 순매수 거래 대금 String Y 18
-bank_seln_vol 은행 매도 거래량 String Y 18
-bank_shnu_vol 은행 매수2 거래량 String Y 18
-bank_ntby_qty 은행 순매수 수량 String Y 12
-bank_seln_tr_pbmn 은행 매도 거래 대금 String Y 18
-bank_shnu_tr_pbmn 은행 매수2 거래 대금 String Y 18
-bank_ntby_tr_pbmn 은행 순매수 거래 대금 String Y 18
-insu_seln_vol 보험 매도 거래량 String Y 18
-insu_shnu_vol 보험 매수2 거래량 String Y 18
-insu_ntby_qty 보험 순매수 수량 String Y 12
-insu_seln_tr_pbmn 보험 매도 거래 대금 String Y 18
-insu_shnu_tr_pbmn 보험 매수2 거래 대금 String Y 18
-insu_ntby_tr_pbmn 보험 순매수 거래 대금 String Y 18
-mrbn_seln_vol 종금 매도 거래량 String Y 18
-mrbn_shnu_vol 종금 매수2 거래량 String Y 18
-mrbn_ntby_qty 종금 순매수 수량 String Y 12
-mrbn_seln_tr_pbmn 종금 매도 거래 대금 String Y 18
-mrbn_shnu_tr_pbmn 종금 매수2 거래 대금 String Y 18
-mrbn_ntby_tr_pbmn 종금 순매수 거래 대금 String Y 18
-fund_seln_vol 기금 매도 거래량 String Y 18
-fund_shnu_vol 기금 매수2 거래량 String Y 18
-fund_ntby_qty 기금 순매수 수량 String Y 12
-fund_seln_tr_pbmn 기금 매도 거래 대금 String Y 18
-fund_shnu_tr_pbmn 기금 매수2 거래 대금 String Y 18
-fund_ntby_tr_pbmn 기금 순매수 거래 대금 String Y 18
-etc_orgt_seln_vol 기타 단체 매도 거래량 String Y 18
-etc_orgt_shnu_vol 기타 단체 매수2 거래량 String Y 18
-etc_orgt_ntby_vol 기타 단체 순매수 거래량 String Y 18
-etc_orgt_seln_tr_pbmn 기타 단체 매도 거래 대금 String Y 18
-etc_orgt_shnu_tr_pbmn 기타 단체 매수2 거래 대금 String Y 18
-etc_orgt_ntby_tr_pbmn 기타 단체 순매수 거래 대금 String Y 18
-etc_corp_seln_vol 기타 법인 매도 거래량 String Y 18
-etc_corp_shnu_vol 기타 법인 매수2 거래량 String Y 18
-etc_corp_ntby_vol 기타 법인 순매수 거래량 String Y 18
-etc_corp_seln_tr_pbmn 기타 법인 매도 거래 대금 String Y 18
-etc_corp_shnu_tr_pbmn 기타 법인 매수2 거래 대금 String Y 18
-etc_corp_ntby_tr_pbmn 기타 법인 순매수 거래 대금 String Y 18

Example

Request

{
"FID_INPUT_ISCD":"KSP",
"FID_INPUT_ISCD_2":"0001"
}

Response

{
    "output": [
        {
            "frgn_seln_vol": "75588",
            "frgn_shnu_vol": "70298",
            "frgn_ntby_qty": "-5290",
            "frgn_seln_tr_pbmn": "2818983",
            "frgn_shnu_tr_pbmn": "2967639",
            "frgn_ntby_tr_pbmn": "148656",
            "prsn_seln_vol": "294375",
            "prsn_shnu_vol": "300449",
            "prsn_ntby_qty": "6074",
            "prsn_seln_tr_pbmn": "5131230",
            "prsn_shnu_tr_pbmn": "5020361",
            "prsn_ntby_tr_pbmn": "-110869",
            "orgn_seln_vol": "36911",
            "orgn_shnu_vol": "37631",
            "orgn_ntby_qty": "720",
            "orgn_seln_tr_pbmn": "2110371",
            "orgn_shnu_tr_pbmn": "2054839",
            "orgn_ntby_tr_pbmn": "-55532",
            "scrt_seln_vol": "8493",
            "scrt_shnu_vol": "12126",
            "scrt_ntby_qty": "3633",
            "scrt_seln_tr_pbmn": "384357",
            "scrt_shnu_tr_pbmn": "472598",
            "scrt_ntby_tr_pbmn": "88241",
            "ivtr_seln_vol": "4086",
            "ivtr_shnu_vol": "3964",
            "ivtr_ntby_qty": "-122",
            "ivtr_seln_tr_pbmn": "177374",
            "ivtr_shnu_tr_pbmn": "165434",
            "ivtr_ntby_tr_pbmn": "-11940",
            "pe_fund_seln_tr_pbmn": "213413",
            "pe_fund_seln_vol": "4833",
            "pe_fund_ntby_vol": "-1804",
            "pe_fund_shnu_tr_pbmn": "115551",
            "pe_fund_shnu_vol": "3029",
            "pe_fund_ntby_tr_pbmn": "-97861",
            "bank_seln_vol": "245",
            "bank_shnu_vol": "51",
            "bank_ntby_qty": "-193",
            "bank_seln_tr_pbmn": "13382",
            "bank_shnu_tr_pbmn": "2873",
            "bank_ntby_tr_pbmn": "-10509",
            "insu_seln_vol": "1653",
            "insu_shnu_vol": "1050",
            "insu_ntby_qty": "-603",
            "insu_seln_tr_pbmn": "79782",
            "insu_shnu_tr_pbmn": "50378",
            "insu_ntby_tr_pbmn": "-29404",
            "mrbn_seln_vol": "230",
            "mrbn_shnu_vol": "310",
            "mrbn_ntby_qty": "80",
            "mrbn_seln_tr_pbmn": "10393",
            "mrbn_shnu_tr_pbmn": "11896",
            "mrbn_ntby_tr_pbmn": "1502",
            "fund_seln_vol": "17372",
            "fund_shnu_vol": "17101",
            "fund_ntby_qty": "-271",
            "fund_seln_tr_pbmn": "1231671",
            "fund_shnu_tr_pbmn": "1236109",
            "fund_ntby_tr_pbmn": "4439",
            "etc_orgt_seln_vol": "0",
            "etc_orgt_shnu_vol": "0",
            "etc_orgt_ntby_vol": "0",
            "etc_orgt_seln_tr_pbmn": "0",
            "etc_orgt_shnu_tr_pbmn": "0",
            "etc_orgt_ntby_tr_pbmn": "0",
            "etc_corp_seln_vol": "5061",
            "etc_corp_shnu_vol": "3558",
            "etc_corp_ntby_vol": "-1503",
            "etc_corp_seln_tr_pbmn": "95856",
            "etc_corp_shnu_tr_pbmn": "113601",
            "etc_corp_ntby_tr_pbmn": "17745"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 신용잔고 일별추이[국내주식-110]

REST

국내주식 신용잔고 일별추이[국내주식-110]

기본정보

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

개요

국내주식 신용잔고 일별추이 API입니다.
한국투자 HTS(eFriend Plus) > [0476] 국내주식 신용잔고 일별추이 화면의 기능을 API로 개발한 사항으로, 해당 화면을 참고하시면 기능을 이해하기 쉽습니다.
한 번의 호출에 최대 30건 확인 가능하며, fid_input_date_1 을 입력하여 다음 조회가 가능합니다.

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 FHPST04760000
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_mrkt_div_code 조건 화면 분류 코드 String Y 5 Unique key(20476)
fid_cond_scr_div_code 입력 종목코드 String Y 12 종목코드 (ex 005930)
fid_input_iscd 옵션 String Y 10 결제일자 (ex 20240313)

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
-deal_date 매매 일자 String Y 8
-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
-stlm_date 결제 일자 String Y 8
-whol_loan_new_stcn 전체 융자 신규 주수 String Y 18
-whol_loan_rdmp_stcn 전체 융자 상환 주수 String Y 18
-whol_loan_rmnd_stcn 전체 융자 잔고 주수 String Y 18
-whol_loan_new_amt 전체 융자 신규 금액 String Y 18
-whol_loan_rdmp_amt 전체 융자 상환 금액 String Y 18
-whol_loan_rmnd_amt 전체 융자 잔고 금액 String Y 18
-whol_loan_rmnd_rate 전체 융자 잔고 비율 String Y 84
-whol_loan_gvrt 전체 융자 공여율 String Y 82
-whol_stln_new_stcn 전체 대주 신규 주수 String Y 18
-whol_stln_rdmp_stcn 전체 대주 상환 주수 String Y 18
-whol_stln_rmnd_stcn 전체 대주 잔고 주수 String Y 18
-whol_stln_new_amt 전체 대주 신규 금액 String Y 18
-whol_stln_rdmp_amt 전체 대주 상환 금액 String Y 18
-whol_stln_rmnd_amt 전체 대주 잔고 금액 String Y 18
-whol_stln_rmnd_rate 전체 대주 잔고 비율 String Y 84
-whol_stln_gvrt 전체 대주 공여율 String Y 82
-stck_oprc 주식 시가2 String Y 10
-stck_hgpr 주식 최고가 String Y 10
-stck_lwpr 주식 최저가 String Y 10

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_cond_scr_div_code":"20476",
"fid_input_iscd":"005930",
"fid_input_date_1":"20240315"
}

Response

{
    "output": [
        {
            "deal_date": "20240313",
            "stck_prpr": "74100",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "800",
            "prdy_ctrt": "1.09",
            "acml_vol": "15243134",
            "stlm_date": "20240315",
            "whol_loan_new_stcn": "253817",
            "whol_loan_rdmp_stcn": "603451",
            "whol_loan_rmnd_stcn": "7155720",
            "whol_loan_new_amt": "1678904",
            "whol_loan_rdmp_amt": "3982732",
            "whol_loan_rmnd_amt": "47321639",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "1.65",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6861",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43104",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73700",
            "stck_hgpr": "74100",
            "stck_lwpr": "73500"
        },
        {
            "deal_date": "20240312",
            "stck_prpr": "73300",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "900",
            "prdy_ctrt": "1.24",
            "acml_vol": "13011654",
            "stlm_date": "20240314",
            "whol_loan_new_stcn": "357971",
            "whol_loan_rdmp_stcn": "429002",
            "whol_loan_rmnd_stcn": "7507526",
            "whol_loan_new_amt": "2370294",
            "whol_loan_rdmp_amt": "2871401",
            "whol_loan_rmnd_amt": "49639923",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "2.74",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6861",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43104",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72600",
            "stck_hgpr": "73500",
            "stck_lwpr": "72100"
        },
        {
            "deal_date": "20240311",
            "stck_prpr": "72400",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-900",
            "prdy_ctrt": "-1.23",
            "acml_vol": "9740504",
            "stlm_date": "20240313",
            "whol_loan_new_stcn": "395234",
            "whol_loan_rdmp_stcn": "242330",
            "whol_loan_rmnd_stcn": "7586197",
            "whol_loan_new_amt": "2579480",
            "whol_loan_rdmp_amt": "1479272",
            "whol_loan_rmnd_amt": "50194590",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "4.05",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6861",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43104",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72900",
            "stck_hgpr": "73100",
            "stck_lwpr": "72300"
        },
        {
            "deal_date": "20240308",
            "stck_prpr": "73300",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1100",
            "prdy_ctrt": "1.52",
            "acml_vol": "19271349",
            "stlm_date": "20240312",
            "whol_loan_new_stcn": "350421",
            "whol_loan_rdmp_stcn": "580071",
            "whol_loan_rmnd_stcn": "7433714",
            "whol_loan_new_amt": "2212537",
            "whol_loan_rdmp_amt": "3786566",
            "whol_loan_rmnd_amt": "49096831",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "1.81",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6861",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43104",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72800",
            "stck_hgpr": "73400",
            "stck_lwpr": "72600"
        },
        {
            "deal_date": "20240307",
            "stck_prpr": "72200",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-700",
            "prdy_ctrt": "-0.96",
            "acml_vol": "14516963",
            "stlm_date": "20240311",
            "whol_loan_new_stcn": "497407",
            "whol_loan_rdmp_stcn": "252707",
            "whol_loan_rmnd_stcn": "7666721",
            "whol_loan_new_amt": "3207234",
            "whol_loan_rdmp_amt": "1692347",
            "whol_loan_rmnd_amt": "50691156",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "3.42",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "1",
            "whol_stln_rmnd_stcn": "6861",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "7",
            "whol_stln_rmnd_amt": "43104",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73100",
            "stck_hgpr": "73300",
            "stck_lwpr": "72200"
        },
        {
            "deal_date": "20240306",
            "stck_prpr": "72900",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-800",
            "prdy_ctrt": "-1.09",
            "acml_vol": "21547905",
            "stlm_date": "20240308",
            "whol_loan_new_stcn": "619036",
            "whol_loan_rdmp_stcn": "176578",
            "whol_loan_rmnd_stcn": "7424246",
            "whol_loan_new_amt": "4069217",
            "whol_loan_rdmp_amt": "1148738",
            "whol_loan_rmnd_amt": "49189736",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "2.87",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6862",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43111",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73200",
            "stck_hgpr": "73500",
            "stck_lwpr": "72700"
        },
        {
            "deal_date": "20240305",
            "stck_prpr": "73700",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-1200",
            "prdy_ctrt": "-1.60",
            "acml_vol": "19505125",
            "stlm_date": "20240307",
            "whol_loan_new_stcn": "422627",
            "whol_loan_rdmp_stcn": "301232",
            "whol_loan_rmnd_stcn": "6981765",
            "whol_loan_new_amt": "2822363",
            "whol_loan_rdmp_amt": "1986157",
            "whol_loan_rmnd_amt": "46269511",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "2.15",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "20",
            "whol_stln_rmnd_stcn": "6862",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "139",
            "whol_stln_rmnd_amt": "43111",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74600",
            "stck_hgpr": "74800",
            "stck_lwpr": "73700"
        },
        {
            "deal_date": "20240304",
            "stck_prpr": "74900",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1500",
            "prdy_ctrt": "2.04",
            "acml_vol": "23210474",
            "stlm_date": "20240306",
            "whol_loan_new_stcn": "838785",
            "whol_loan_rdmp_stcn": "1450926",
            "whol_loan_rmnd_stcn": "6862995",
            "whol_loan_new_amt": "5536867",
            "whol_loan_rdmp_amt": "9135415",
            "whol_loan_rmnd_amt": "45449103",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "3.61",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74300",
            "stck_hgpr": "75000",
            "stck_lwpr": "74000"
        },
        {
            "deal_date": "20240229",
            "stck_prpr": "73400",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "200",
            "prdy_ctrt": "0.27",
            "acml_vol": "21176403",
            "stlm_date": "20240305",
            "whol_loan_new_stcn": "563158",
            "whol_loan_rdmp_stcn": "330265",
            "whol_loan_rmnd_stcn": "7477578",
            "whol_loan_new_amt": "3366177",
            "whol_loan_rdmp_amt": "2109787",
            "whol_loan_rmnd_amt": "49063520",
            "whol_loan_rmnd_rate": "0.12",
            "whol_loan_gvrt": "2.65",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72600",
            "stck_hgpr": "73400",
            "stck_lwpr": "72000"
        },
        {
            "deal_date": "20240228",
            "stck_prpr": "73200",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "11795859",
            "stlm_date": "20240304",
            "whol_loan_new_stcn": "506896",
            "whol_loan_rdmp_stcn": "458211",
            "whol_loan_rmnd_stcn": "7245825",
            "whol_loan_new_amt": "3059090",
            "whol_loan_rdmp_amt": "2956451",
            "whol_loan_rmnd_amt": "47813948",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "4.29",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72900",
            "stck_hgpr": "73900",
            "stck_lwpr": "72800"
        },
        {
            "deal_date": "20240227",
            "stck_prpr": "72900",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "100",
            "prdy_ctrt": "0.14",
            "acml_vol": "13201981",
            "stlm_date": "20240229",
            "whol_loan_new_stcn": "319365",
            "whol_loan_rdmp_stcn": "291088",
            "whol_loan_rmnd_stcn": "7199469",
            "whol_loan_new_amt": "2086955",
            "whol_loan_rdmp_amt": "1907718",
            "whol_loan_rmnd_amt": "47725597",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "2.41",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73100",
            "stck_hgpr": "73400",
            "stck_lwpr": "72700"
        },
        {
            "deal_date": "20240226",
            "stck_prpr": "72800",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-100",
            "prdy_ctrt": "-0.14",
            "acml_vol": "14669352",
            "stlm_date": "20240228",
            "whol_loan_new_stcn": "282018",
            "whol_loan_rdmp_stcn": "261288",
            "whol_loan_rmnd_stcn": "7171604",
            "whol_loan_new_amt": "1838364",
            "whol_loan_rdmp_amt": "1639156",
            "whol_loan_rmnd_amt": "47549260",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "1.91",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72300",
            "stck_hgpr": "73200",
            "stck_lwpr": "72200"
        },
        {
            "deal_date": "20240223",
            "stck_prpr": "72900",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-200",
            "prdy_ctrt": "-0.27",
            "acml_vol": "16225166",
            "stlm_date": "20240227",
            "whol_loan_new_stcn": "526563",
            "whol_loan_rdmp_stcn": "473526",
            "whol_loan_rmnd_stcn": "7151330",
            "whol_loan_new_amt": "3397702",
            "whol_loan_rdmp_amt": "3122338",
            "whol_loan_rmnd_amt": "47353285",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "3.23",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73600",
            "stck_hgpr": "74200",
            "stck_lwpr": "72900"
        },
        {
            "deal_date": "20240222",
            "stck_prpr": "73100",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "100",
            "prdy_ctrt": "0.14",
            "acml_vol": "15208934",
            "stlm_date": "20240226",
            "whol_loan_new_stcn": "617034",
            "whol_loan_rdmp_stcn": "362458",
            "whol_loan_rmnd_stcn": "7098784",
            "whol_loan_new_amt": "4055099",
            "whol_loan_rdmp_amt": "2420852",
            "whol_loan_rmnd_amt": "47080801",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "4.05",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73800",
            "stck_hgpr": "73900",
            "stck_lwpr": "72700"
        },
        {
            "deal_date": "20240221",
            "stck_prpr": "73000",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-300",
            "prdy_ctrt": "-0.41",
            "acml_vol": "11503495",
            "stlm_date": "20240223",
            "whol_loan_new_stcn": "181753",
            "whol_loan_rdmp_stcn": "159505",
            "whol_loan_rmnd_stcn": "6849915",
            "whol_loan_new_amt": "1154019",
            "whol_loan_rdmp_amt": "997307",
            "whol_loan_rmnd_amt": "45485001",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "1.57",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73400",
            "stck_hgpr": "73700",
            "stck_lwpr": "72900"
        },
        {
            "deal_date": "20240220",
            "stck_prpr": "73300",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-500",
            "prdy_ctrt": "-0.68",
            "acml_vol": "14681477",
            "stlm_date": "20240222",
            "whol_loan_new_stcn": "245659",
            "whol_loan_rdmp_stcn": "162302",
            "whol_loan_rmnd_stcn": "6827253",
            "whol_loan_new_amt": "1650740",
            "whol_loan_rdmp_amt": "1053242",
            "whol_loan_rmnd_amt": "45325256",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "1.66",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "100",
            "whol_stln_rmnd_stcn": "6882",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "699",
            "whol_stln_rmnd_amt": "43251",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73700",
            "stck_hgpr": "73700",
            "stck_lwpr": "72800"
        },
        {
            "deal_date": "20240219",
            "stck_prpr": "73800",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1000",
            "prdy_ctrt": "1.37",
            "acml_vol": "12726404",
            "stlm_date": "20240221",
            "whol_loan_new_stcn": "196561",
            "whol_loan_rdmp_stcn": "395332",
            "whol_loan_rmnd_stcn": "6746234",
            "whol_loan_new_amt": "1233245",
            "whol_loan_rdmp_amt": "2617252",
            "whol_loan_rmnd_amt": "44744474",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "1.53",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "15",
            "whol_stln_rmnd_stcn": "6982",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "105",
            "whol_stln_rmnd_amt": "43950",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "72800",
            "stck_hgpr": "73900",
            "stck_lwpr": "72800"
        },
        {
            "deal_date": "20240216",
            "stck_prpr": "72800",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-200",
            "prdy_ctrt": "-0.27",
            "acml_vol": "13444781",
            "stlm_date": "20240220",
            "whol_loan_new_stcn": "353711",
            "whol_loan_rdmp_stcn": "258304",
            "whol_loan_rmnd_stcn": "6946822",
            "whol_loan_new_amt": "2336237",
            "whol_loan_rdmp_amt": "1746554",
            "whol_loan_rmnd_amt": "46141630",
            "whol_loan_rmnd_rate": "0.11",
            "whol_loan_gvrt": "2.63",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6997",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "44055",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73300",
            "stck_hgpr": "73400",
            "stck_lwpr": "72500"
        },
        {
            "deal_date": "20240215",
            "stck_prpr": "73000",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-1000",
            "prdy_ctrt": "-1.35",
            "acml_vol": "14120600",
            "stlm_date": "20240219",
            "whol_loan_new_stcn": "668521",
            "whol_loan_rdmp_stcn": "244617",
            "whol_loan_rmnd_stcn": "6851613",
            "whol_loan_new_amt": "4541397",
            "whol_loan_rdmp_amt": "1581331",
            "whol_loan_rmnd_amt": "45553486",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "4.72",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6997",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "44055",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74200",
            "stck_hgpr": "74400",
            "stck_lwpr": "73000"
        },
        {
            "deal_date": "20240214",
            "stck_prpr": "74000",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-1200",
            "prdy_ctrt": "-1.60",
            "acml_vol": "12434945",
            "stlm_date": "20240216",
            "whol_loan_new_stcn": "607994",
            "whol_loan_rdmp_stcn": "168766",
            "whol_loan_rmnd_stcn": "6428256",
            "whol_loan_new_amt": "4042856",
            "whol_loan_rdmp_amt": "1140083",
            "whol_loan_rmnd_amt": "42597320",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "4.88",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "6997",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "44055",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73700",
            "stck_hgpr": "74300",
            "stck_lwpr": "73700"
        },
        {
            "deal_date": "20240213",
            "stck_prpr": "75200",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1100",
            "prdy_ctrt": "1.48",
            "acml_vol": "21966745",
            "stlm_date": "20240215",
            "whol_loan_new_stcn": "510482",
            "whol_loan_rdmp_stcn": "766361",
            "whol_loan_rmnd_stcn": "5989340",
            "whol_loan_new_amt": "2751983",
            "whol_loan_rdmp_amt": "4536820",
            "whol_loan_rmnd_amt": "39696538",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "2.32",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "139",
            "whol_stln_rmnd_stcn": "6997",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "996",
            "whol_stln_rmnd_amt": "44055",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74800",
            "stck_hgpr": "75200",
            "stck_lwpr": "74400"
        },
        {
            "deal_date": "20240208",
            "stck_prpr": "74100",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-900",
            "prdy_ctrt": "-1.20",
            "acml_vol": "20810708",
            "stlm_date": "20240214",
            "whol_loan_new_stcn": "943012",
            "whol_loan_rdmp_stcn": "549849",
            "whol_loan_rmnd_stcn": "6247522",
            "whol_loan_new_amt": "5594562",
            "whol_loan_rdmp_amt": "2907687",
            "whol_loan_rmnd_amt": "41495520",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "4.52",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "1",
            "whol_stln_rmnd_stcn": "7136",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "6",
            "whol_stln_rmnd_amt": "45052",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "75000",
            "stck_hgpr": "75200",
            "stck_lwpr": "73600"
        },
        {
            "deal_date": "20240207",
            "stck_prpr": "75000",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "600",
            "prdy_ctrt": "0.81",
            "acml_vol": "16566445",
            "stlm_date": "20240213",
            "whol_loan_new_stcn": "252078",
            "whol_loan_rdmp_stcn": "439983",
            "whol_loan_rmnd_stcn": "5856240",
            "whol_loan_new_amt": "1614166",
            "whol_loan_rdmp_amt": "2860455",
            "whol_loan_rmnd_amt": "38821115",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "1.51",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "7137",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "45059",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74600",
            "stck_hgpr": "75500",
            "stck_lwpr": "74300"
        },
        {
            "deal_date": "20240206",
            "stck_prpr": "74400",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "100",
            "prdy_ctrt": "0.13",
            "acml_vol": "14559254",
            "stlm_date": "20240208",
            "whol_loan_new_stcn": "295323",
            "whol_loan_rdmp_stcn": "281735",
            "whol_loan_rmnd_stcn": "6045644",
            "whol_loan_new_amt": "1941262",
            "whol_loan_rdmp_amt": "1889253",
            "whol_loan_rmnd_amt": "40074751",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "2.02",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "0",
            "whol_stln_rmnd_stcn": "7137",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "0",
            "whol_stln_rmnd_amt": "45059",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74300",
            "stck_hgpr": "74700",
            "stck_lwpr": "73300"
        },
        {
            "deal_date": "20240205",
            "stck_prpr": "74300",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-900",
            "prdy_ctrt": "-1.20",
            "acml_vol": "19026021",
            "stlm_date": "20240207",
            "whol_loan_new_stcn": "580976",
            "whol_loan_rdmp_stcn": "315236",
            "whol_loan_rmnd_stcn": "6035531",
            "whol_loan_new_amt": "3882685",
            "whol_loan_rdmp_amt": "2127798",
            "whol_loan_rmnd_amt": "40047278",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "3.04",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "728",
            "whol_stln_rmnd_stcn": "7137",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "5099",
            "whol_stln_rmnd_amt": "45059",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74200",
            "stck_hgpr": "74800",
            "stck_lwpr": "73500"
        },
        {
            "deal_date": "20240202",
            "stck_prpr": "75200",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1600",
            "prdy_ctrt": "2.17",
            "acml_vol": "14955881",
            "stlm_date": "20240206",
            "whol_loan_new_stcn": "227532",
            "whol_loan_rdmp_stcn": "559999",
            "whol_loan_rmnd_stcn": "5770153",
            "whol_loan_new_amt": "1423587",
            "whol_loan_rdmp_amt": "3552220",
            "whol_loan_rmnd_amt": "38294939",
            "whol_loan_rmnd_rate": "0.08",
            "whol_loan_gvrt": "1.52",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "8",
            "whol_stln_rmnd_stcn": "7865",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "55",
            "whol_stln_rmnd_amt": "50158",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "74000",
            "stck_hgpr": "75200",
            "stck_lwpr": "73700"
        },
        {
            "deal_date": "20240201",
            "stck_prpr": "73600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "900",
            "prdy_ctrt": "1.24",
            "acml_vol": "19881033",
            "stlm_date": "20240205",
            "whol_loan_new_stcn": "340408",
            "whol_loan_rdmp_stcn": "432474",
            "whol_loan_rmnd_stcn": "6103384",
            "whol_loan_new_amt": "2222626",
            "whol_loan_rdmp_amt": "2835418",
            "whol_loan_rmnd_amt": "40428694",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "1.70",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "347",
            "whol_stln_rmnd_stcn": "7873",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "2376",
            "whol_stln_rmnd_amt": "50214",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73000",
            "stck_hgpr": "74200",
            "stck_lwpr": "72900"
        },
        {
            "deal_date": "20240131",
            "stck_prpr": "72700",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-1600",
            "prdy_ctrt": "-2.15",
            "acml_vol": "15703560",
            "stlm_date": "20240202",
            "whol_loan_new_stcn": "401245",
            "whol_loan_rdmp_stcn": "234735",
            "whol_loan_rmnd_stcn": "6207574",
            "whol_loan_new_amt": "2627294",
            "whol_loan_rdmp_amt": "1541985",
            "whol_loan_rmnd_amt": "41122407",
            "whol_loan_rmnd_rate": "0.10",
            "whol_loan_gvrt": "2.55",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "30",
            "whol_stln_rmnd_stcn": "8220",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "204",
            "whol_stln_rmnd_amt": "52590",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73400",
            "stck_hgpr": "74000",
            "stck_lwpr": "72500"
        },
        {
            "deal_date": "20240130",
            "stck_prpr": "74300",
            "prdy_vrss_sign": "5",
            "prdy_vrss": "-100",
            "prdy_ctrt": "-0.13",
            "acml_vol": "12244418",
            "stlm_date": "20240201",
            "whol_loan_new_stcn": "308957",
            "whol_loan_rdmp_stcn": "165640",
            "whol_loan_rmnd_stcn": "6042179",
            "whol_loan_new_amt": "1980096",
            "whol_loan_rdmp_amt": "1089607",
            "whol_loan_rmnd_amt": "40044649",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "2.51",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "894",
            "whol_stln_rmnd_stcn": "8250",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "5983",
            "whol_stln_rmnd_amt": "52795",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "75000",
            "stck_hgpr": "75300",
            "stck_lwpr": "73700"
        },
        {
            "deal_date": "20240129",
            "stck_prpr": "74400",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "1000",
            "prdy_ctrt": "1.36",
            "acml_vol": "13976521",
            "stlm_date": "20240131",
            "whol_loan_new_stcn": "207309",
            "whol_loan_rdmp_stcn": "415351",
            "whol_loan_rmnd_stcn": "5901536",
            "whol_loan_new_amt": "1397554",
            "whol_loan_rdmp_amt": "2745405",
            "whol_loan_rmnd_amt": "39169933",
            "whol_loan_rmnd_rate": "0.09",
            "whol_loan_gvrt": "1.47",
            "whol_stln_new_stcn": "0",
            "whol_stln_rdmp_stcn": "39",
            "whol_stln_rmnd_stcn": "9144",
            "whol_stln_new_amt": "0",
            "whol_stln_rdmp_amt": "261",
            "whol_stln_rmnd_amt": "58779",
            "whol_stln_rmnd_rate": "0.00",
            "whol_stln_gvrt": "0.00",
            "stck_oprc": "73800",
            "stck_hgpr": "75200",
            "stck_lwpr": "73500"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 예상체결가 추이[국내주식-118]

REST

국내주식 예상체결가 추이[국내주식-118]

기본정보

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

개요

국내주식 예상체결가 추이 API입니다.
한국투자 HTS(eFriend Plus) > [0184] 예상체결지수 추이 화면의 기능을 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 FHPST01810000
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_mkop_cls_code 장운영 구분 코드 String Y 12 0:전체, 4:체결량 0 제외
fid_cond_mrkt_div_code 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
fid_input_iscd 입력 종목코드 String Y 5 종목코드(ex. 005930)

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-rprs_mrkt_kor_name 대표 시장 한글 명 String Y 40
-antc_cnpr 예상 체결가 String Y 10
-antc_cntg_vrss_sign 예상 체결 대비 부호 String Y 1
-antc_cntg_vrss 예상 체결 대비 String Y 10
-antc_cntg_prdy_ctrt 예상 체결 전일 대비율 String Y 82
-antc_vol 예상 거래량 String Y 18
-antc_tr_pbmn 예상 거래대금 String Y 19
output2 응답상세 Object Array Y array
-stck_bsop_date 주식 영업 일자 String Y 8
-stck_cntg_hour 주식 체결 시간 String Y 6
-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

Example

Request

{
"fid_cond_mrkt_div_code":"J",
"fid_input_iscd":"005930",
"fid_mkop_cls_code":"0"
}

Response

{
    "output1": {
        "rprs_mrkt_kor_name": "KOSPI200",
        "antc_cnpr": "72600",
        "antc_cntg_vrss_sign": "2",
        "antc_cntg_vrss": "300",
        "antc_cntg_prdy_ctrt": "0.41",
        "antc_vol": "420303",
        "antc_tr_pbmn": "30513997800"
    },
    "output2": [
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090023",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "420303"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090023",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "420196"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090023",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "420206"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090023",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "419330"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090022",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "419131"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090022",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418134"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090022",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418123"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090021",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418123"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090020",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418123"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090019",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418123"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090019",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418120"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090018",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418120"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090017",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418120"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090017",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418121"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090016",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418121"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090016",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "418003"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090016",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417953"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090016",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417729"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090016",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417679"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417679"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417060"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "417050"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416945"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416921"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090015",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416915"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090014",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416915"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090014",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416770"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090014",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "416759"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090014",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "415059"
        },
        {
            "stck_bsop_date": "20240318",
            "stck_cntg_hour": "090013",
            "stck_prpr": "72600",
            "prdy_vrss_sign": "2",
            "prdy_vrss": "300",
            "prdy_ctrt": "0.41",
            "acml_vol": "414942"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 공매도 일별추이[국내주식-134]

REST

국내주식 공매도 일별추이[국내주식-134]

기본정보

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

개요

LAYOUT

Request

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
authorization 접근토큰 String Y 40 OAuth 토큰이 필요한 API 경우 발급한 Access token
일반고객(Access token 유효기간 1일, OAuth 2.0의 Client Credentials Grant 절차를 준용)
법인(Access token 유효기간 3개월, Refresh token 유효기간 1년, OAuth 2.0의 Authorization Code Grant 절차를 준용)
appkey 앱키 String Y 36 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
appsecret 앱시크릿키 String Y 180 한국투자증권 홈페이지에서 발급받은 appkey (절대 노출되지 않도록 주의해주세요.)
personalseckey 고객식별키 String N 180 [법인 필수] 제휴사 회원 관리를 위한 고객식별키
tr_id 거래ID String Y 13 FHPST04830000
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
N : 다음 데이터 조회 (output header의 tr_cont가 M일 경우)
custtype 고객 타입 String Y 1 B : 법인
P : 개인
seq_no 일련번호 String N 2 [법인 필수] 001
mac_address 맥주소 String N 12 법인고객 혹은 개인고객의 Mac address 값
phone_number 핸드폰번호 String N 12 [법인 필수] 제휴사APP을 사용하는 경우 사용자(회원) 핸드폰번호
ex) 01011112222 (하이픈 등 구분값 제거)
ip_addr 접속 단말 공인 IP String N 12 [법인 필수] 사용자(회원)의 IP Address
hashkey 해쉬키 String N 256 [POST API 대상] Client가 요청하는 Request Body를 hashkey api로 생성한 Hash값
* API문서 > hashkey 참조
gt_uid Global UID String N 32 [법인 필수] 거래고유번호로 사용하므로 거래별로 UNIQUE해야 함
Element 한글명 Type Required Length Description
FID_COND_MRKT_DIV_CODE 조건 시장 분류 코드 String Y 2 시장구분코드 (주식 J)
FID_INPUT_ISCD 입력 종목코드 String Y 12 종목코드
FID_INPUT_DATE_1 입력 날짜1 String Y 10 공백시 전체 (기간 ~)
FID_INPUT_DATE_2 입력 날짜2 String Y 10 ~ 누적

Response

Header

Element 한글명 Type Required Length Description
content-type 컨텐츠타입 String Y 40 application/json; charset=utf-8
tr_id 거래ID String Y 13 요청한 tr_id
tr_cont 연속 거래 여부 String N 1 공백 : 초기 조회
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
-stck_prpr 주식 현재가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 8.2
-acml_vol 누적 거래량 String Y 18
-prdy_vol 전일 거래량 String Y 18
output2 응답상세 Object Array Y array
-stck_bsop_date 주식 영업 일자 String Y 8
-stck_clpr 주식 종가 String Y 10
-prdy_vrss 전일 대비 String Y 10
-prdy_vrss_sign 전일 대비 부호 String Y 1
-prdy_ctrt 전일 대비율 String Y 8.2
-acml_vol 누적 거래량 String Y 18
-stnd_vol_smtn 기준 거래량 합계 String Y 18
-ssts_cntg_qty 공매도 체결 수량 String Y 12
-ssts_vol_rlim 공매도 거래량 비중 String Y 6.2
-acml_ssts_cntg_qty 누적 공매도 체결 수량 String Y 13
-acml_ssts_cntg_qty_rlim 누적 공매도 체결 수량 비중 String Y 7.2
-acml_tr_pbmn 누적 거래 대금 String Y 18
-stnd_tr_pbmn_smtn 기준 거래대금 합계 String Y 18
-ssts_tr_pbmn 공매도 거래 대금 String Y 18
-ssts_tr_pbmn_rlim 공매도 거래대금 비중 String Y 6.2
-acml_ssts_tr_pbmn 누적 공매도 거래 대금 String Y 19
-acml_ssts_tr_pbmn_rlim 누적 공매도 거래 대금 비중 String Y 7.2
-stck_oprc 주식 시가2 String Y 10
-stck_hgpr 주식 최고가 String Y 10
-stck_lwpr 주식 최저가 String Y 10
-avrg_prc 평균가격 String Y 11

프로그램매매 종합현황(일별)[국내주식-115]

REST

프로그램매매 종합현황(일별)[국내주식-115]

기본정보

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

개요

프로그램매매 종합현황(일별) API입니다.
한국투자 HTS(eFriend Plus) > [0460] 프로그램매매 종합현황 화면의 기능을 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 FHPPG04600000
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_MRKT_CLS_CODE 시장 구분 코드 String Y 2 K:코스피, Q:코스닥
FID_INPUT_DATE_1 검색시작일 String Y 10 일자 ~
FID_INPUT_DATE_2 검색종료일 String Y 10 ~ 일자

Response

Header

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

Body

Element 한글명 Type Required Length Description
rt_cd 성공 실패 여부 String Y 1
msg_cd 응답코드 String Y 8
msg1 응답메세지 String Y 80
output1 응답상세 Object Array Y array
-stck_bsop_date 주식 영업 일자 String Y 8
-arbt_entm_seln_vol 차익 위탁 매도 거래량 String Y 18
-arbt_entm_seln_vol_rate 차익 위탁 매도 거래량 비율 String Y 82
-arbt_entm_seln_tr_pbmn 차익 위탁 매도 거래 대금 String Y 18
-arbt_entm_seln_tr_pbmn_rate 차익 위탁 매도 거래 대금 비율 String Y 82
-arbt_onsl_seln_tr_pbmn 차익 자기 매도 거래 대금 String Y 18
-arbt_onsl_seln_tr_pbmn_rate 차익 자기 매도 거래 대금 비율 String Y 82
-arbt_onsl_seln_vol 차익 자기 매도 거래량 String Y 18
-arbt_onsl_seln_vol_rate 차익 자기 매도 거래량 비율 String Y 82
-arbt_smtn_seln_vol 차익 합계 매도 거래량 String Y 18
-arbt_smtm_seln_vol_rate 차익 합계 매도 거래량 비율 String Y 72
-arbt_smtn_seln_tr_pbmn 차익 합계 매도 거래 대금 String Y 18
-arbt_smtm_seln_tr_pbmn_rate 차익 합계 매도 거래대금 비율 String Y 72
-nabt_entm_seln_vol 비차익 위탁 매도 거래량 String Y 18
-nabt_entm_seln_tr_pbmn 비차익 위탁 매도 거래 대금 String Y 18
-nabt_entm_seln_vol_rate 비차익 위탁 매도 거래량 비율 String Y 82
-nabt_entm_seln_tr_pbmn_rate 비차익 위탁 매도 거래 대금 비 String Y 82
-nabt_onsl_seln_vol 비차익 자기 매도 거래량 String Y 18
-nabt_onsl_seln_vol_rate 비차익 자기 매도 거래량 비율 String Y 82
-nabt_onsl_seln_tr_pbmn 비차익 자기 매도 거래 대금 String Y 18
-nabt_onsl_seln_tr_pbmn_rate 비차익 자기 매도 거래 대금 비 String Y 82
-nabt_smtn_seln_vol 비차익 합계 매도 거래량 String Y 18
-nabt_smtm_seln_vol_rate 비차익 합계 매도 거래량 비율 String Y 72
-nabt_smtn_seln_tr_pbmn 비차익 합계 매도 거래 대금 String Y 18
-nabt_smtm_seln_tr_pbmn_rate 비차익 합계 매도 거래대금 비율 String Y 72
-whol_entm_seln_vol 전체 위탁 매도 거래량 String Y 18
-whol_entm_seln_tr_pbmn 전체 위탁 매도 거래 대금 String Y 18
-whol_entm_seln_vol_rate 전체 위탁 매도 거래량 비율 String Y 82
-whol_entm_seln_tr_pbmn_rate 전체 위탁 매도 거래 대금 비율 String Y 82
-whol_onsl_seln_vol 전체 자기 매도 거래량 String Y 18
-whol_onsl_seln_vol_rate 전체 자기 매도 거래량 비율 String Y 82
-whol_onsl_seln_tr_pbmn 전체 자기 매도 거래 대금 String Y 18
-whol_onsl_seln_tr_pbmn_rate 전체 자기 매도 거래 대금 비율 String Y 82
-whol_smtn_seln_vol 전체 합계 매도 거래량 String Y 18
-whol_seln_vol_rate 전체 매도 거래량 비율 String Y 72
-whol_smtn_seln_tr_pbmn 전체 합계 매도 거래 대금 String Y 18
-whol_seln_tr_pbmn_rate 전체 매도 거래대금 비율 String Y 72
-arbt_entm_shnu_vol 차익 위탁 매수2 거래량 String Y 18
-arbt_entm_shnu_vol_rate 차익 위탁 매수 거래량 비율 String Y 82
-arbt_entm_shnu_tr_pbmn 차익 위탁 매수2 거래 대금 String Y 18
-arbt_entm_shnu_tr_pbmn_rate 차익 위탁 매수 거래 대금 비율 String Y 82
-arbt_onsl_shnu_vol 차익 자기 매수2 거래량 String Y 18
-arbt_onsl_shnu_vol_rate 차익 자기 매수 거래량 비율 String Y 82
-arbt_onsl_shnu_tr_pbmn 차익 자기 매수2 거래 대금 String Y 18
-arbt_onsl_shnu_tr_pbmn_rate 차익 자기 매수 거래 대금 비율 String Y 82
-arbt_smtn_shnu_vol 차익 합계 매수2 거래량 String Y 18
-arbt_smtm_shun_vol_rate 차익 합계 매수 거래량 비율 String Y 72
-arbt_smtn_shnu_tr_pbmn 차익 합계 매수2 거래 대금 String Y 18
-arbt_smtm_shun_tr_pbmn_rate 차익 합계 매수 거래대금 비율 String Y 72
-nabt_entm_shnu_vol 비차익 위탁 매수2 거래량 String Y 18
-nabt_entm_shnu_vol_rate 비차익 위탁 매수 거래량 비율 String Y 82
-nabt_entm_shnu_tr_pbmn 비차익 위탁 매수2 거래 대금 String Y 18
-nabt_entm_shnu_tr_pbmn_rate 비차익 위탁 매수 거래 대금 비 String Y 82
-nabt_onsl_shnu_vol 비차익 자기 매수2 거래량 String Y 18
-nabt_onsl_shnu_vol_rate 비차익 자기 매수 거래량 비율 String Y 82
-nabt_onsl_shnu_tr_pbmn 비차익 자기 매수2 거래 대금 String Y 18
-nabt_onsl_shnu_tr_pbmn_rate 비차익 자기 매수 거래 대금 비 String Y 82
-nabt_smtn_shnu_vol 비차익 합계 매수2 거래량 String Y 18
-nabt_smtm_shun_vol_rate 비차익 합계 매수 거래량 비율 String Y 72
-nabt_smtn_shnu_tr_pbmn 비차익 합계 매수2 거래 대금 String Y 18
-nabt_smtm_shun_tr_pbmn_rate 비차익 합계 매수 거래대금 비율 String Y 72
-whol_entm_shnu_vol 전체 위탁 매수2 거래량 String Y 18
-whol_entm_shnu_vol_rate 전체 위탁 매수 거래량 비율 String Y 82
-whol_entm_shnu_tr_pbmn 전체 위탁 매수2 거래 대금 String Y 18
-whol_entm_shnu_tr_pbmn_rate 전체 위탁 매수 거래 대금 비율 String Y 82
-whol_onsl_shnu_vol 전체 자기 매수2 거래량 String Y 18
-whol_onsl_shnu_tr_pbmn 전체 자기 매수2 거래 대금 String Y 18
-whol_onsl_shnu_tr_pbmn_rate 전체 자기 매수 거래 대금 비율 String Y 82
-whol_onsl_shnu_vol_rate 전체 자기 매수 거래량 비율 String Y 82
-whol_smtn_shnu_vol 전체 합계 매수2 거래량 String Y 18
-whol_shun_vol_rate 전체 매수 거래량 비율 String Y 72
-whol_smtn_shnu_tr_pbmn 전체 합계 매수2 거래 대금 String Y 18
-whol_shun_tr_pbmn_rate 전체 매수 거래대금 비율 String Y 72
-arbt_entm_ntby_qty 차익 위탁 순매수 수량 String Y 18
-arbt_entm_ntby_qty_rate 차익 위탁 순매수 수량 비율 String Y 82
-arbt_entm_ntby_tr_pbmn 차익 위탁 순매수 거래 대금 String Y 18
-arbt_entm_ntby_tr_pbmn_rate 차익 위탁 순매수 거래 대금 비 String Y 82
-arbt_onsl_ntby_qty 차익 자기 순매수 수량 String Y 18
-arbt_onsl_ntby_qty_rate 차익 자기 순매수 수량 비율 String Y 82
-arbt_onsl_ntby_tr_pbmn 차익 자기 순매수 거래 대금 String Y 18
-arbt_onsl_ntby_tr_pbmn_rate 차익 자기 순매수 거래 대금 비 String Y 82
-arbt_smtn_ntby_qty 차익 합계 순매수 수량 String Y 18
-arbt_smtm_ntby_qty_rate 차익 합계 순매수 수량 비율 String Y 72
-arbt_smtn_ntby_tr_pbmn 차익 합계 순매수 거래 대금 String Y 18
-arbt_smtm_ntby_tr_pbmn_rate 차익 합계 순매수 거래대금 비율 String Y 72
-nabt_entm_ntby_qty 비차익 위탁 순매수 수량 String Y 18
-nabt_entm_ntby_qty_rate 비차익 위탁 순매수 수량 비율 String Y 82
-nabt_entm_ntby_tr_pbmn 비차익 위탁 순매수 거래 대금 String Y 18
-nabt_entm_ntby_tr_pbmn_rate 비차익 위탁 순매수 거래 대금 String Y 82
-nabt_onsl_ntby_qty 비차익 자기 순매수 수량 String Y 18
-nabt_onsl_ntby_qty_rate 비차익 자기 순매수 수량 비율 String Y 82
-nabt_onsl_ntby_tr_pbmn 비차익 자기 순매수 거래 대금 String Y 18
-nabt_onsl_ntby_tr_pbmn_rate 비차익 자기 순매수 거래 대금 String Y 82
-nabt_smtn_ntby_qty 비차익 합계 순매수 수량 String Y 18
-nabt_smtm_ntby_qty_rate 비차익 합계 순매수 수량 비율 String Y 72
-nabt_smtn_ntby_tr_pbmn 비차익 합계 순매수 거래 대금 String Y 18
-nabt_smtm_ntby_tr_pbmn_rate 비차익 합계 순매수 거래대금 비 String Y 72
-whol_entm_ntby_qty 전체 위탁 순매수 수량 String Y 18
-whol_entm_ntby_qty_rate 전체 위탁 순매수 수량 비율 String Y 82
-whol_entm_ntby_tr_pbmn 전체 위탁 순매수 거래 대금 String Y 18

Example

Request

FID_MRKT_CLS_CODE:K
FID_INPUT_DATE_1:20230301
FID_INPUT_DATE_2:20240404

Response

{
    "output": [
        {
            "stck_bsop_date": "20240404",
            "arbt_entm_seln_vol": "945",
            "arbt_entm_seln_vol_rate": "0.20",
            "arbt_entm_seln_tr_pbmn": "60184",
            "arbt_entm_seln_tr_pbmn_rate": "0.50",
            "arbt_onsl_seln_tr_pbmn": "116742",
            "arbt_onsl_seln_tr_pbmn_rate": "0.97",
            "arbt_onsl_seln_vol": "1893",
            "arbt_onsl_seln_vol_rate": "0.40",
            "arbt_smtn_seln_vol": "2839",
            "arbt_smtm_seln_vol_rate": "0.59",
            "arbt_smtn_seln_tr_pbmn": "176926",
            "arbt_smtm_seln_tr_pbmn_rate": "1.48",
            "nabt_entm_seln_vol": "72995",
            "nabt_entm_seln_tr_pbmn": "2335987",
            "nabt_entm_seln_vol_rate": "15.27",
            "nabt_entm_seln_tr_pbmn_rate": "19.50",
            "nabt_onsl_seln_vol": "335",
            "nabt_onsl_seln_vol_rate": "0.07",
            "nabt_onsl_seln_tr_pbmn": "18428",
            "nabt_onsl_seln_tr_pbmn_rate": "0.15",
            "nabt_smtn_seln_vol": "73331",
            "nabt_smtm_seln_vol_rate": "15.34",
            "nabt_smtn_seln_tr_pbmn": "2354415",
            "nabt_smtm_seln_tr_pbmn_rate": "19.66",
            "whol_entm_seln_vol": "73940",
            "whol_entm_seln_tr_pbmn": "2396171",
            "whol_entm_seln_vol_rate": "15.47",
            "whol_entm_seln_tr_pbmn_rate": "20.00",
            "whol_onsl_seln_vol": "2229",
            "whol_onsl_seln_vol_rate": "0.47",
            "whol_onsl_seln_tr_pbmn": "135170",
            "whol_onsl_seln_tr_pbmn_rate": "1.13",
            "whol_smtn_seln_vol": "76169",
            "whol_seln_vol_rate": "15.94",
            "whol_smtn_seln_tr_pbmn": "2531340",
            "whol_seln_tr_pbmn_rate": "21.13",
            "arbt_entm_shnu_vol": "798",
            "arbt_entm_shnu_vol_rate": "0.17",
            "arbt_entm_shnu_tr_pbmn": "50818",
            "arbt_entm_shnu_tr_pbmn_rate": "0.42",
            "arbt_onsl_shnu_vol": "247",
            "arbt_onsl_shnu_vol_rate": "0.05",
            "arbt_onsl_shnu_tr_pbmn": "15309",
            "arbt_onsl_shnu_tr_pbmn_rate": "0.13",
            "arbt_smtn_shnu_vol": "1045",
            "arbt_smtm_shun_vol_rate": "0.22",
            "arbt_smtn_shnu_tr_pbmn": "66127",
            "arbt_smtm_shun_tr_pbmn_rate": "0.55",
            "nabt_entm_shnu_vol": "73441",
            "nabt_entm_shnu_vol_rate": "15.37",
            "nabt_entm_shnu_tr_pbmn": "2581806",
            "nabt_entm_shnu_tr_pbmn_rate": "21.55",
            "nabt_onsl_shnu_vol": "250",
            "nabt_onsl_shnu_vol_rate": "0.05",
            "nabt_onsl_shnu_tr_pbmn": "11652",
            "nabt_onsl_shnu_tr_pbmn_rate": "0.10",
            "nabt_smtn_shnu_vol": "73691",
            "nabt_smtm_shun_vol_rate": "15.42",
            "nabt_smtn_shnu_tr_pbmn": "2593458",
            "nabt_smtm_shun_tr_pbmn_rate": "21.65",
            "whol_entm_shnu_vol": "74239",
            "whol_entm_shnu_vol_rate": "15.53",
            "whol_entm_shnu_tr_pbmn": "2632624",
            "whol_entm_shnu_tr_pbmn_rate": "21.98",
            "whol_onsl_shnu_vol": "497",
            "whol_onsl_shnu_tr_pbmn": "26961",
            "whol_onsl_shnu_tr_pbmn_rate": "0.23",
            "whol_onsl_shnu_vol_rate": "0.10",
            "whol_smtn_shnu_vol": "74736",
            "whol_shun_vol_rate": "15.64",
            "whol_smtn_shnu_tr_pbmn": "2659585",
            "whol_shun_tr_pbmn_rate": "22.20",
            "arbt_entm_ntby_qty": "-147",
            "arbt_entm_ntby_qty_rate": "-0.03",
            "arbt_entm_ntby_tr_pbmn": "-9366",
            "arbt_entm_ntby_tr_pbmn_rate": "-0.08",
            "arbt_onsl_ntby_qty": "-1646",
            "arbt_onsl_ntby_qty_rate": "-0.34",
            "arbt_onsl_ntby_tr_pbmn": "-101433",
            "arbt_onsl_ntby_tr_pbmn_rate": "-0.85",
            "arbt_smtn_ntby_qty": "-1793",
            "arbt_smtm_ntby_qty_rate": "-0.38",
            "arbt_smtn_ntby_tr_pbmn": "-110799",
            "arbt_smtm_ntby_tr_pbmn_rate": "-0.93",
            "nabt_entm_ntby_qty": "446",
            "nabt_entm_ntby_qty_rate": "0.09",
            "nabt_entm_ntby_tr_pbmn": "245819",
            "nabt_entm_ntby_tr_pbmn_rate": "2.05",
            "nabt_onsl_ntby_qty": "-85",
            "nabt_onsl_ntby_qty_rate": "-0.02",
            "nabt_onsl_ntby_tr_pbmn": "-6776",
            "nabt_onsl_ntby_tr_pbmn_rate": "-0.06",
            "nabt_smtn_ntby_qty": "361",
            "nabt_smtm_ntby_qty_rate": "0.08",
            "nabt_smtn_ntby_tr_pbmn": "239043",
            "nabt_smtm_ntby_tr_pbmn_rate": "2.00",
            "whol_entm_ntby_qty": "299",
            "whol_entm_ntby_qty_rate": "0.06",
            "whol_entm_ntby_tr_pbmn": "236453",
            "whol_entm_ntby_tr_pbmn_rate": "1.97",
            "whol_onsl_ntby_qty": "-1732",
            "whol_onsl_ntby_qty_rate": "-0.36",
            "whol_onsl_ntby_tr_pbmn": "-108209",
            "whol_onsl_ntby_tr_pbmn_rate": "-0.90",
            "whol_smtn_ntby_qty": "-1433",
            "whol_ntby_qty_rate": "-0.30",
            "whol_smtn_ntby_tr_pbmn": "128245",
            "whol_ntby_tr_pbmn_rate": "1.07",
            "bstp_nmix_prpr": "",
            "bstp_nmix_prdy_vrss": "",
            "prdy_vrss_sign": ""
        },
        {
            "stck_bsop_date": "20240403",
            "arbt_entm_seln_vol": "769",
            "arbt_entm_seln_vol_rate": "0.12",
            "arbt_entm_seln_tr_pbmn": "48480",
            "arbt_entm_seln_tr_pbmn_rate": "0.37",
            "arbt_onsl_seln_tr_pbmn": "192333",
            "arbt_onsl_seln_tr_pbmn_rate": "1.45",
            "arbt_onsl_seln_vol": "3118",
            "arbt_onsl_seln_vol_rate": "0.49",
            "arbt_smtn_seln_vol": "3887",
            "arbt_smtm_seln_vol_rate": "0.61",
            "arbt_smtn_seln_tr_pbmn": "240813",
            "arbt_smtm_seln_tr_pbmn_rate": "1.82",
            "nabt_entm_seln_vol": "94356",
            "nabt_entm_seln_tr_pbmn": "3076931",
            "nabt_entm_seln_vol_rate": "14.72",
            "nabt_entm_seln_tr_pbmn_rate": "23.21",
            "nabt_onsl_seln_vol": "3323",
            "nabt_onsl_seln_vol_rate": "0.52",
            "nabt_onsl_seln_tr_pbmn": "207163",
            "nabt_onsl_seln_tr_pbmn_rate": "1.56",
            "nabt_smtn_seln_vol": "97679",
            "nabt_smtm_seln_vol_rate": "15.24",
            "nabt_smtn_seln_tr_pbmn": "3284094",
            "nabt_smtm_seln_tr_pbmn_rate": "24.77",
            "whol_entm_seln_vol": "95125",
            "whol_entm_seln_tr_pbmn": "3125411",
            "whol_entm_seln_vol_rate": "14.84",
            "whol_entm_seln_tr_pbmn_rate": "23.58",
            "whol_onsl_seln_vol": "6440",
            "whol_onsl_seln_vol_rate": "1.01",
            "whol_onsl_seln_tr_pbmn": "399496",
            "whol_onsl_seln_tr_pbmn_rate": "3.01",
            "whol_smtn_seln_vol": "101566",
            "whol_seln_vol_rate": "15.85",
            "whol_smtn_seln_tr_pbmn": "3524908",
            "whol_seln_tr_pbmn_rate": "26.59",
            "arbt_entm_shnu_vol": "916",
            "arbt_entm_shnu_vol_rate": "0.14",
            "arbt_entm_shnu_tr_pbmn": "57765",
            "arbt_entm_shnu_tr_pbmn_rate": "0.44",
            "arbt_onsl_shnu_vol": "151",
            "arbt_onsl_shnu_vol_rate": "0.02",
            "arbt_onsl_shnu_tr_pbmn": "9682",
            "arbt_onsl_shnu_tr_pbmn_rate": "0.07",
            "arbt_smtn_shnu_vol": "1067",
            "arbt_smtm_shun_vol_rate": "0.17",
            "arbt_smtn_shnu_tr_pbmn": "67446",
            "arbt_smtm_shun_tr_pbmn_rate": "0.51",
            "nabt_entm_shnu_vol": "88098",
            "nabt_entm_shnu_vol_rate": "13.75",
            "nabt_entm_shnu_tr_pbmn": "2576437",
            "nabt_entm_shnu_tr_pbmn_rate": "19.43",
            "nabt_onsl_shnu_vol": "206",
            "nabt_onsl_shnu_vol_rate": "0.03",
            "nabt_onsl_shnu_tr_pbmn": "8168",
            "nabt_onsl_shnu_tr_pbmn_rate": "0.06",
            "nabt_smtn_shnu_vol": "88304",
            "nabt_smtm_shun_vol_rate": "13.78",
            "nabt_smtn_shnu_tr_pbmn": "2584605",
            "nabt_smtm_shun_tr_pbmn_rate": "19.50",
            "whol_entm_shnu_vol": "89014",
            "whol_entm_shnu_vol_rate": "13.89",
            "whol_entm_shnu_tr_pbmn": "2634202",
            "whol_entm_shnu_tr_pbmn_rate": "19.87",
            "whol_onsl_shnu_vol": "357",
            "whol_onsl_shnu_tr_pbmn": "17849",
            "whol_onsl_shnu_tr_pbmn_rate": "0.13",
            "whol_onsl_shnu_vol_rate": "0.06",
            "whol_smtn_shnu_vol": "89371",
            "whol_shun_vol_rate": "13.95",
            "whol_smtn_shnu_tr_pbmn": "2652051",
            "whol_shun_tr_pbmn_rate": "20.00",
            "arbt_entm_ntby_qty": "147",
            "arbt_entm_ntby_qty_rate": "0.02",
            "arbt_entm_ntby_tr_pbmn": "9284",
            "arbt_entm_ntby_tr_pbmn_rate": "0.07",
            "arbt_onsl_ntby_qty": "-2967",
            "arbt_onsl_ntby_qty_rate": "-0.46",
            "arbt_onsl_ntby_tr_pbmn": "-182651",
            "arbt_onsl_ntby_tr_pbmn_rate": "-1.38",
            "arbt_smtn_ntby_qty": "-2819",
            "arbt_smtm_ntby_qty_rate": "-0.44",
            "arbt_smtn_ntby_tr_pbmn": "-173367",
            "arbt_smtm_ntby_tr_pbmn_rate": "-1.31",
            "nabt_entm_ntby_qty": "-6259",
            "nabt_entm_ntby_qty_rate": "-0.98",
            "nabt_entm_ntby_tr_pbmn": "-500494",
            "nabt_entm_ntby_tr_pbmn_rate": "-3.78",
            "nabt_onsl_ntby_qty": "-3116",
            "nabt_onsl_ntby_qty_rate": "-0.49",
            "nabt_onsl_ntby_tr_pbmn": "-198996",
            "nabt_onsl_ntby_tr_pbmn_rate": "-1.50",
            "nabt_smtn_ntby_qty": "-9375",
            "nabt_smtm_ntby_qty_rate": "-1.46",
            "nabt_smtn_ntby_tr_pbmn": "-699489",
            "nabt_smtm_ntby_tr_pbmn_rate": "-5.28",
            "whol_entm_ntby_qty": "-6112",
            "whol_entm_ntby_qty_rate": "-0.95",
            "whol_entm_ntby_tr_pbmn": "-491210",
            "whol_entm_ntby_tr_pbmn_rate": "-3.71",
            "whol_onsl_ntby_qty": "-6083",
            "whol_onsl_ntby_qty_rate": "-0.95",
            "whol_onsl_ntby_tr_pbmn": "-381647",
            "whol_onsl_ntby_tr_pbmn_rate": "-2.88",
            "whol_smtn_ntby_qty": "-12195",
            "whol_ntby_qty_rate": "-1.90",
            "whol_smtn_ntby_tr_pbmn": "-872856",
            "whol_ntby_tr_pbmn_rate": "-6.58",
            "bstp_nmix_prpr": "",
            "bstp_nmix_prdy_vrss": "",
            "prdy_vrss_sign": ""
        },
        {
            "stck_bsop_date": "20240402",
            "arbt_entm_seln_vol": "857",
            "arbt_entm_seln_vol_rate": "0.14",
            "arbt_entm_seln_tr_pbmn": "54673",
            "arbt_entm_seln_tr_pbmn_rate": "0.42",
            "arbt_onsl_seln_tr_pbmn": "78907",
            "arbt_onsl_seln_tr_pbmn_rate": "0.60",
            "arbt_onsl_seln_vol": "1282",
            "arbt_onsl_seln_vol_rate": "0.20",
            "arbt_smtn_seln_vol": "2138",
            "arbt_smtm_seln_vol_rate": "0.34",
            "arbt_smtn_seln_tr_pbmn": "133579",
            "arbt_smtm_seln_tr_pbmn_rate": "1.02",
            "nabt_entm_seln_vol": "78391",
            "nabt_entm_seln_tr_pbmn": "2385531",
            "nabt_entm_seln_vol_rate": "12.44",
            "nabt_entm_seln_tr_pbmn_rate": "18.19",
            "nabt_onsl_seln_vol": "893",
            "nabt_onsl_seln_vol_rate": "0.14",
            "nabt_onsl_seln_tr_pbmn": "54722",
            "nabt_onsl_seln_tr_pbmn_rate": "0.42",
            "nabt_smtn_seln_vol": "79284",
            "nabt_smtm_seln_vol_rate": "12.58",
            "nabt_smtn_seln_tr_pbmn": "2440253",
            "nabt_smtm_seln_tr_pbmn_rate": "18.60",
            "whol_entm_seln_vol": "79247",
            "whol_entm_seln_tr_pbmn": "2440203",
            "whol_entm_seln_vol_rate": "12.57",
            "whol_entm_seln_tr_pbmn_rate": "18.60",
            "whol_onsl_seln_vol": "2175",
            "whol_onsl_seln_vol_rate": "0.35",
            "whol_onsl_seln_tr_pbmn": "133628",
            "whol_onsl_seln_tr_pbmn_rate": "1.02",
            "whol_smtn_seln_vol": "81422",
            "whol_seln_vol_rate": "12.92",
            "whol_smtn_seln_tr_pbmn": "2573832",
            "whol_seln_tr_pbmn_rate": "19.62",
            "arbt_entm_shnu_vol": "760",
            "arbt_entm_shnu_vol_rate": "0.12",
            "arbt_entm_shnu_tr_pbmn": "48775",
            "arbt_entm_shnu_tr_pbmn_rate": "0.37",
            "arbt_onsl_shnu_vol": "3",
            "arbt_onsl_shnu_vol_rate": "0.00",
            "arbt_onsl_shnu_tr_pbmn": "657",
            "arbt_onsl_shnu_tr_pbmn_rate": "0.01",
            "arbt_smtn_shnu_vol": "762",
            "arbt_smtm_shun_vol_rate": "0.12",
            "arbt_smtn_shnu_tr_pbmn": "49432",
            "arbt_smtm_shun_tr_pbmn_rate": "0.38",
            "nabt_entm_shnu_vol": "74157",
            "nabt_entm_shnu_vol_rate": "11.76",
            "nabt_entm_shnu_tr_pbmn": "3086213",
            "nabt_entm_shnu_tr_pbmn_rate": "23.53",
            "nabt_onsl_shnu_vol": "187",
            "nabt_onsl_shnu_vol_rate": "0.03",
            "nabt_onsl_shnu_tr_pbmn": "8119",
            "nabt_onsl_shnu_tr_pbmn_rate": "0.06",
            "nabt_smtn_shnu_vol": "74344",
            "nabt_smtm_shun_vol_rate": "11.79",
            "nabt_smtn_shnu_tr_pbmn": "3094332",
            "nabt_smtm_shun_tr_pbmn_rate": "23.59",
            "whol_entm_shnu_vol": "74916",
            "whol_entm_shnu_vol_rate": "11.88",
            "whol_entm_shnu_tr_pbmn": "3134988",
            "whol_entm_shnu_tr_pbmn_rate": "23.90",
            "whol_onsl_shnu_vol": "190",
            "whol_onsl_shnu_tr_pbmn": "8775",
            "whol_onsl_shnu_tr_pbmn_rate": "0.07",
            "whol_onsl_shnu_vol_rate": "0.03",
            "whol_smtn_shnu_vol": "75107",
            "whol_shun_vol_rate": "11.91",
            "whol_smtn_shnu_tr_pbmn": "3143764",
            "whol_shun_tr_pbmn_rate": "23.97",
            "arbt_entm_ntby_qty": "-97",
            "arbt_entm_ntby_qty_rate": "-0.02",
            "arbt_entm_ntby_tr_pbmn": "-5897",
            "arbt_entm_ntby_tr_pbmn_rate": "-0.04",
            "arbt_onsl_ntby_qty": "-1279",
            "arbt_onsl_ntby_qty_rate": "-0.20",
            "arbt_onsl_ntby_tr_pbmn": "-78250",
            "arbt_onsl_ntby_tr_pbmn_rate": "-0.60",
            "arbt_smtn_ntby_qty": "-1376",
            "arbt_smtm_ntby_qty_rate": "-0.22",
            "arbt_smtn_ntby_tr_pbmn": "-84147",
            "arbt_smtm_ntby_tr_pbmn_rate": "-0.64",
            "nabt_entm_ntby_qty": "-4234",
            "nabt_entm_ntby_qty_rate": "-0.67",
            "nabt_entm_ntby_tr_pbmn": "700682",
            "nabt_entm_ntby_tr_pbmn_rate": "5.34",
            "nabt_onsl_ntby_qty": "-706",
            "nabt_onsl_ntby_qty_rate": "-0.11",
            "nabt_onsl_ntby_tr_pbmn": "-46603",
            "nabt_onsl_ntby_tr_pbmn_rate": "-0.36",
            "nabt_smtn_ntby_qty": "-4940",
            "nabt_smtm_ntby_qty_rate": "-0.78",
            "nabt_smtn_ntby_tr_pbmn": "654079",
            "nabt_smtm_ntby_tr_pbmn_rate": "4.99",
            "whol_entm_ntby_qty": "-4331",
            "whol_entm_ntby_qty_rate": "-0.69",
            "whol_entm_ntby_tr_pbmn": "694785",
            "whol_entm_ntby_tr_pbmn_rate": "5.30",
            "whol_onsl_ntby_qty": "-1985",
            "whol_onsl_ntby_qty_rate": "-0.31",
            "whol_onsl_ntby_tr_pbmn": "-124853",
            "whol_onsl_ntby_tr_pbmn_rate": "-0.95",
            "whol_smtn_ntby_qty": "-6316",
            "whol_ntby_qty_rate": "-1.00",
            "whol_smtn_ntby_tr_pbmn": "569932",
            "whol_ntby_tr_pbmn_rate": "4.35",
            "bstp_nmix_prpr": "",
            "bstp_nmix_prdy_vrss": "",
            "prdy_vrss_sign": ""
        },...
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}

국내주식 시간외예상체결등락률 [국내주식-140]

REST

국내주식 시간외예상체결등락률 [국내주식-140]

기본정보

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

개요

국내주식 시간외예상체결등락률 API입니다.
한국투자 HTS(eFriend Plus) > [0236] 시간외 예상체결등락률 화면의 기능을 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 FHKST11860000
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(11186)
FID_INPUT_ISCD 입력 종목코드 String Y 12 0000(전체), 0001(코스피), 1001(코스닥)
FID_RANK_SORT_CLS_CODE 순위 정렬 구분 코드 String Y 2 0(상승률), 1(상승폭), 2(보합), 3(하락률), 4(하락폭)
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_INPUT_VOL_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
output1 응답상세 Object Y
-data_rank 데이터 순위 String Y 10
-iscd_stat_cls_code 종목 상태 구분 코드 String Y 3
-stck_shrn_iscd 주식 단축 종목코드 String Y 9
-hts_kor_isnm HTS 한글 종목명 String Y 40
-ovtm_untp_antc_cnpr 시간외 단일가 예상 체결가 String Y 10
-ovtm_untp_antc_cntg_vrss 시간외 단일가 예상 체결 대비 String Y 10
-ovtm_untp_antc_cntg_vrsssign 시간외 단일가 예상 체결 대비 String Y 1
-ovtm_untp_antc_cntg_ctrt 시간외 단일가 예상 체결 대비율 String Y 82
-ovtm_untp_askp_rsqn1 시간외 단일가 매도호가 잔량1 String Y 12
-ovtm_untp_bidp_rsqn1 시간외 단일가 매수호가 잔량1 String Y 12
-ovtm_untp_antc_cnqn 시간외 단일가 예상 체결량 String Y 18
-itmt_vol 장중 거래량 String Y 18
-stck_prpr 주식 현재가 String Y 10

Example

Request

FID_COND_MRKT_DIV_CODE:J
FID_COND_SCR_DIV_CODE:11186
FID_INPUT_ISCD:0000
FID_RANK_SORT_CLS_CODE:0
FID_DIV_CLS_CODE:0
FID_INPUT_PRICE_1:
FID_INPUT_PRICE_2:
FID_INPUT_VOL_1:

Response

{
    "output": [
        {
            "data_rank": "1",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "025820",
            "hts_kor_isnm": "이구산업",
            "ovtm_untp_antc_cnpr": "6270",
            "ovtm_untp_antc_cntg_vrss": "570",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "10.00",
            "ovtm_untp_askp_rsqn1": "231200",
            "ovtm_untp_bidp_rsqn1": "394",
            "ovtm_untp_antc_cnqn": "253267",
            "itmt_vol": "14355442",
            "stck_prpr": "5700"
        },
        {
            "data_rank": "2",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "024840",
            "hts_kor_isnm": "KBI메탈",
            "ovtm_untp_antc_cnpr": "1805",
            "ovtm_untp_antc_cntg_vrss": "164",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.99",
            "ovtm_untp_askp_rsqn1": "0",
            "ovtm_untp_bidp_rsqn1": "1512765",
            "ovtm_untp_antc_cnqn": "25869",
            "itmt_vol": "13518874",
            "stck_prpr": "1641"
        },
        {
            "data_rank": "3",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "097800",
            "hts_kor_isnm": "윈팩",
            "ovtm_untp_antc_cnpr": "1334",
            "ovtm_untp_antc_cntg_vrss": "121",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.98",
            "ovtm_untp_askp_rsqn1": "150248",
            "ovtm_untp_bidp_rsqn1": "300",
            "ovtm_untp_antc_cnqn": "40546",
            "itmt_vol": "1020359",
            "stck_prpr": "1213"
        },
        {
            "data_rank": "4",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "060280",
            "hts_kor_isnm": "큐렉소",
            "ovtm_untp_antc_cnpr": "13460",
            "ovtm_untp_antc_cntg_vrss": "1220",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.97",
            "ovtm_untp_askp_rsqn1": "0",
            "ovtm_untp_bidp_rsqn1": "5409",
            "ovtm_untp_antc_cnqn": "4769",
            "itmt_vol": "233482",
            "stck_prpr": "12240"
        },
        {
            "data_rank": "5",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "206650",
            "hts_kor_isnm": "유바이오로직스",
            "ovtm_untp_antc_cnpr": "13270",
            "ovtm_untp_antc_cntg_vrss": "1200",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.94",
            "ovtm_untp_askp_rsqn1": "23618",
            "ovtm_untp_bidp_rsqn1": "8",
            "ovtm_untp_antc_cnqn": "20021",
            "itmt_vol": "182132",
            "stck_prpr": "12070"
        },
        {
            "data_rank": "6",
            "iscd_stat_cls_code": "51",
            "stck_shrn_iscd": "008110",
            "hts_kor_isnm": "대동전자",
            "ovtm_untp_antc_cnpr": "7680",
            "ovtm_untp_antc_cntg_vrss": "690",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.87",
            "ovtm_untp_askp_rsqn1": "0",
            "ovtm_untp_bidp_rsqn1": "16106",
            "ovtm_untp_antc_cnqn": "238",
            "itmt_vol": "3577",
            "stck_prpr": "6990"
        },
        {
            "data_rank": "7",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "058450",
            "hts_kor_isnm": "엔터파트너즈",
            "ovtm_untp_antc_cnpr": "5910",
            "ovtm_untp_antc_cntg_vrss": "510",
            "ovtm_untp_antc_cntg_vrss_sign": "1",
            "ovtm_untp_antc_cntg_ctrt": "9.44",
            "ovtm_untp_askp_rsqn1": "607",
            "ovtm_untp_bidp_rsqn1": "10000",
            "ovtm_untp_antc_cnqn": "20026",
            "itmt_vol": "3168350",
            "stck_prpr": "5400"
        },
        {
            "data_rank": "8",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "336060",
            "hts_kor_isnm": "웨이버스",
            "ovtm_untp_antc_cnpr": "1589",
            "ovtm_untp_antc_cntg_vrss": "129",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "8.84",
            "ovtm_untp_askp_rsqn1": "3539",
            "ovtm_untp_bidp_rsqn1": "2739",
            "ovtm_untp_antc_cnqn": "3970",
            "itmt_vol": "195703",
            "stck_prpr": "1460"
        },
        {
            "data_rank": "9",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "047560",
            "hts_kor_isnm": "이스트소프트",
            "ovtm_untp_antc_cnpr": "26900",
            "ovtm_untp_antc_cntg_vrss": "2000",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "8.03",
            "ovtm_untp_askp_rsqn1": "826",
            "ovtm_untp_bidp_rsqn1": "30",
            "ovtm_untp_antc_cnqn": "9827",
            "itmt_vol": "399313",
            "stck_prpr": "24900"
        },
        {
            "data_rank": "10",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "018470",
            "hts_kor_isnm": "조일알미늄",
            "ovtm_untp_antc_cnpr": "2380",
            "ovtm_untp_antc_cntg_vrss": "155",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "6.97",
            "ovtm_untp_askp_rsqn1": "33239",
            "ovtm_untp_bidp_rsqn1": "8263",
            "ovtm_untp_antc_cnqn": "133388",
            "itmt_vol": "8895974",
            "stck_prpr": "2225"
        },
        {
            "data_rank": "11",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "012800",
            "hts_kor_isnm": "대창",
            "ovtm_untp_antc_cnpr": "1630",
            "ovtm_untp_antc_cntg_vrss": "87",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "5.64",
            "ovtm_untp_askp_rsqn1": "3999",
            "ovtm_untp_bidp_rsqn1": "5309",
            "ovtm_untp_antc_cnqn": "109013",
            "itmt_vol": "9386217",
            "stck_prpr": "1543"
        },
        {
            "data_rank": "12",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "279600",
            "hts_kor_isnm": "미디어젠",
            "ovtm_untp_antc_cnpr": "14300",
            "ovtm_untp_antc_cntg_vrss": "660",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "4.84",
            "ovtm_untp_askp_rsqn1": "1957",
            "ovtm_untp_bidp_rsqn1": "50",
            "ovtm_untp_antc_cnqn": "7",
            "itmt_vol": "8603",
            "stck_prpr": "13640"
        },
        {
            "data_rank": "13",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "102120",
            "hts_kor_isnm": "어보브반도체",
            "ovtm_untp_antc_cnpr": "17220",
            "ovtm_untp_antc_cntg_vrss": "770",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "4.68",
            "ovtm_untp_askp_rsqn1": "126",
            "ovtm_untp_bidp_rsqn1": "38",
            "ovtm_untp_antc_cnqn": "7594",
            "itmt_vol": "1243555",
            "stck_prpr": "16450"
        },
        {
            "data_rank": "14",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "217330",
            "hts_kor_isnm": "싸이토젠",
            "ovtm_untp_antc_cnpr": "13670",
            "ovtm_untp_antc_cntg_vrss": "570",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "4.35",
            "ovtm_untp_askp_rsqn1": "86",
            "ovtm_untp_bidp_rsqn1": "86",
            "ovtm_untp_antc_cnqn": "114",
            "itmt_vol": "41089",
            "stck_prpr": "13100"
        },
        {
            "data_rank": "15",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "204270",
            "hts_kor_isnm": "제이앤티씨",
            "ovtm_untp_antc_cnpr": "20300",
            "ovtm_untp_antc_cntg_vrss": "840",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "4.32",
            "ovtm_untp_askp_rsqn1": "31630",
            "ovtm_untp_bidp_rsqn1": "68",
            "ovtm_untp_antc_cnqn": "17659",
            "itmt_vol": "6038040",
            "stck_prpr": "19460"
        },
        {
            "data_rank": "16",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "049630",
            "hts_kor_isnm": "재영솔루텍",
            "ovtm_untp_antc_cnpr": "717",
            "ovtm_untp_antc_cntg_vrss": "27",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "3.91",
            "ovtm_untp_askp_rsqn1": "5419",
            "ovtm_untp_bidp_rsqn1": "1018",
            "ovtm_untp_antc_cnqn": "581",
            "itmt_vol": "356136",
            "stck_prpr": "690"
        },
        {
            "data_rank": "17",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "011300",
            "hts_kor_isnm": "성안",
            "ovtm_untp_antc_cnpr": "1295",
            "ovtm_untp_antc_cntg_vrss": "39",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "3.11",
            "ovtm_untp_askp_rsqn1": "974",
            "ovtm_untp_bidp_rsqn1": "1126",
            "ovtm_untp_antc_cnqn": "30",
            "itmt_vol": "469466",
            "stck_prpr": "1256"
        },
        {
            "data_rank": "18",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "164060",
            "hts_kor_isnm": "이루다",
            "ovtm_untp_antc_cnpr": "6390",
            "ovtm_untp_antc_cntg_vrss": "190",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "3.06",
            "ovtm_untp_askp_rsqn1": "223",
            "ovtm_untp_bidp_rsqn1": "812",
            "ovtm_untp_antc_cnqn": "146",
            "itmt_vol": "86988",
            "stck_prpr": "6200"
        },
        {
            "data_rank": "19",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "008500",
            "hts_kor_isnm": "일정실업",
            "ovtm_untp_antc_cnpr": "16300",
            "ovtm_untp_antc_cntg_vrss": "460",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.90",
            "ovtm_untp_askp_rsqn1": "11",
            "ovtm_untp_bidp_rsqn1": "825",
            "ovtm_untp_antc_cnqn": "352",
            "itmt_vol": "450888",
            "stck_prpr": "15840"
        },
        {
            "data_rank": "20",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "226330",
            "hts_kor_isnm": "신테카바이오",
            "ovtm_untp_antc_cnpr": "11350",
            "ovtm_untp_antc_cntg_vrss": "310",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.81",
            "ovtm_untp_askp_rsqn1": "116",
            "ovtm_untp_bidp_rsqn1": "100",
            "ovtm_untp_antc_cnqn": "1568",
            "itmt_vol": "150421",
            "stck_prpr": "11040"
        },
        {
            "data_rank": "21",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "313760",
            "hts_kor_isnm": "윌링스",
            "ovtm_untp_antc_cnpr": "6980",
            "ovtm_untp_antc_cntg_vrss": "180",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.65",
            "ovtm_untp_askp_rsqn1": "40",
            "ovtm_untp_bidp_rsqn1": "65",
            "ovtm_untp_antc_cnqn": "8",
            "itmt_vol": "436483",
            "stck_prpr": "6800"
        },
        {
            "data_rank": "22",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "196300",
            "hts_kor_isnm": "애니젠",
            "ovtm_untp_antc_cnpr": "15500",
            "ovtm_untp_antc_cntg_vrss": "370",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.45",
            "ovtm_untp_askp_rsqn1": "21",
            "ovtm_untp_bidp_rsqn1": "20",
            "ovtm_untp_antc_cnqn": "35",
            "itmt_vol": "66884",
            "stck_prpr": "15130"
        },
        {
            "data_rank": "23",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "003160",
            "hts_kor_isnm": "디아이",
            "ovtm_untp_antc_cnpr": "19400",
            "ovtm_untp_antc_cntg_vrss": "460",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.43",
            "ovtm_untp_askp_rsqn1": "129",
            "ovtm_untp_bidp_rsqn1": "36",
            "ovtm_untp_antc_cnqn": "10214",
            "itmt_vol": "12266019",
            "stck_prpr": "18940"
        },
        {
            "data_rank": "24",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "014910",
            "hts_kor_isnm": "성문전자",
            "ovtm_untp_antc_cnpr": "1485",
            "ovtm_untp_antc_cntg_vrss": "33",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.27",
            "ovtm_untp_askp_rsqn1": "200",
            "ovtm_untp_bidp_rsqn1": "33",
            "ovtm_untp_antc_cnqn": "1",
            "itmt_vol": "58133",
            "stck_prpr": "1452"
        },
        {
            "data_rank": "25",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "291650",
            "hts_kor_isnm": "압타머사이언스",
            "ovtm_untp_antc_cnpr": "2655",
            "ovtm_untp_antc_cntg_vrss": "55",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.12",
            "ovtm_untp_askp_rsqn1": "99",
            "ovtm_untp_bidp_rsqn1": "1",
            "ovtm_untp_antc_cnqn": "1",
            "itmt_vol": "184868",
            "stck_prpr": "2600"
        },
        {
            "data_rank": "26",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "017510",
            "hts_kor_isnm": "세명전기",
            "ovtm_untp_antc_cnpr": "3790",
            "ovtm_untp_antc_cntg_vrss": "75",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.02",
            "ovtm_untp_askp_rsqn1": "3652",
            "ovtm_untp_bidp_rsqn1": "20",
            "ovtm_untp_antc_cnqn": "7126",
            "itmt_vol": "15284327",
            "stck_prpr": "3715"
        },
        {
            "data_rank": "27",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "072770",
            "hts_kor_isnm": "율호",
            "ovtm_untp_antc_cnpr": "2530",
            "ovtm_untp_antc_cntg_vrss": "50",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "2.02",
            "ovtm_untp_askp_rsqn1": "135",
            "ovtm_untp_bidp_rsqn1": "14",
            "ovtm_untp_antc_cnqn": "800",
            "itmt_vol": "538402",
            "stck_prpr": "2480"
        },
        {
            "data_rank": "28",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "001780",
            "hts_kor_isnm": "알루코",
            "ovtm_untp_antc_cnpr": "3345",
            "ovtm_untp_antc_cntg_vrss": "65",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "1.98",
            "ovtm_untp_askp_rsqn1": "15679",
            "ovtm_untp_bidp_rsqn1": "567",
            "ovtm_untp_antc_cnqn": "3419",
            "itmt_vol": "1403435",
            "stck_prpr": "3280"
        },
        {
            "data_rank": "29",
            "iscd_stat_cls_code": "55",
            "stck_shrn_iscd": "017370",
            "hts_kor_isnm": "우신시스템",
            "ovtm_untp_antc_cnpr": "8300",
            "ovtm_untp_antc_cntg_vrss": "160",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "1.97",
            "ovtm_untp_askp_rsqn1": "160",
            "ovtm_untp_bidp_rsqn1": "6",
            "ovtm_untp_antc_cnqn": "34",
            "itmt_vol": "59584",
            "stck_prpr": "8140"
        },
        {
            "data_rank": "30",
            "iscd_stat_cls_code": "57",
            "stck_shrn_iscd": "203400",
            "hts_kor_isnm": "에이비온",
            "ovtm_untp_antc_cnpr": "5980",
            "ovtm_untp_antc_cntg_vrss": "110",
            "ovtm_untp_antc_cntg_vrss_sign": "2",
            "ovtm_untp_antc_cntg_ctrt": "1.87",
            "ovtm_untp_askp_rsqn1": "289",
            "ovtm_untp_bidp_rsqn1": "230",
            "ovtm_untp_antc_cnqn": "1",
            "itmt_vol": "128021",
            "stck_prpr": "5870"
        }
    ],
    "rt_cd": "0",
    "msg_cd": "MCA00000",
    "msg1": "정상처리 되었습니다."
}