KONEX종가

KONEX시장의 종목 리스트, 종목 마스터 등 종가 정보를 제공한다.

Syntax

HTTP methods | GET

Authentication | API Key

KONEX 주식 종목 리스트 API

  • 제공시간 : AM 06:30

/v3/market/closed/konex/lists

GET https://{APIGWAddr}/v3/market/closed/konex/lists

종목리스트

{
    "trdDd": "20220603",
    "mktEndTm": "1540",
    "isuLists": [
        {
            "isuSrtCd": "000020",
            "isuCd": "KR7000020008",
            "isuKorNm": "동화약품",
            "isuKorAbbr": "동화약품",
            "map_to": "000020*001"
        },
        {
            "isuSrtCd": "000040",
            "isuCd": "KR7000040006",
            "isuKorNm": "KR모터스",
            "isuKorAbbr": "KR모터스",
            "map_to": "000040*001"
        }
    ]
}

Response Parameters

Name

Type

Description

trdDd

String(8)

체결일자, 거래일자, 매매일자

YYYYMMDD

isuLists

Array(4)

종목리스트

데이터 개수

isuCd

String(12)

종목코드

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

isuKorNm

String(80)

종목한글명

isuKorAbbrv

String(40)

종목한글약명

가나다

Request Example 

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/lists'

Response Example

{
    "trdDd": "20220603",
    "mktEndTm": "1540",
    "isuLists": [
        {
            "isuSrtCd": "000020",
            "isuCd": "KR7000020008",
            "isuKorNm": "동화약품",
            "isuKorAbbr": "동화약품",
            "map_to": "000020*001"
        },
        {
            "isuSrtCd": "000040",
            "isuCd": "KR7000040006",
            "isuKorNm": "KR모터스",
            "isuKorAbbr": "KR모터스",
            "map_to": "000040*001"
        }
    ]
}

KOSPI 주식종목 마스터 API

  • 제공시간 : AM 06:30

/v3/market/closed/kospi/{issuecode}/master

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/master

Path Parameters

Name
Type
Description

issuecode*

string

종목코드 ex)005930

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "005930",
     "prevddClsprc": 2650000,
     "prevddAccTrdvol": 0,
     "prevddAccTrdval": 0,
     "prevddNav": 0,
     "BzDd": 20180504,
     "acntclsMm": "12",
     "acntclsCd": "000000000001",
     "eps": 5997,
     "bps": 28126,
     "per": 8.67,
     "pbr": 1.85,
     "divYd": 0,
     "basPrc": 53000,
     "arrantrdYn": "N",
     "isuKorAbbrv": "삼성전자",
     "isuCd": "KR7005930003",
     "listDd": 19750611,
     "idxIndUpclssCd": 13,
     "idxIndMidclssCd": 13,
     "idxIndLwclssCd": 13,
     "mfindYn": "Y",
     "kospi100Yn": "N",
     "kospi50Yn": "N",
     "parval": 100,
     "dps": 850,
     "admisuYn": "N",
     "mktWarnTpCd": "00",
     "haltYn": "N",
     "isuPrc": 0,
     "uplmtprc": 68900,
     "lwlmtprc": 37100,
     "sbPrc": 41340,
     "listShrs": 6419324700,
     "regulssQtyUnit": 1,
     "mktcapScaleCd": 2,
     "kospiYn": "N",
     "invstcautnRemndIsuYn": "N",
     "srttrmOverheatIsuTpCd": "0",
     "secugrpId": "ST",
     "smeYn": "N",
     "isuTrdvol": "Y",
     "creditOrdPosblYn": "N",
     "adjStkprcCalcYn": "Y" 
  } 
}

Response Parameters

Name

Type

Description

​

trdDd

string(8)

체결일자, 거래일자, 매매일자

YYYYMMDD

isuCd

string(12)

종목코드

​

isuSrtCd

string(9)

종목단축코드

예) KR7000660001 → 000660

isuKorAbbrv

string(40)

종목한글약명

가나다

isuEngNm

string(80)

종목명(영문)

secugrpId

string(2)

증권그룹ID

ST:주권, MF:증권투자회사, RT:부동산투자회사, SC:선박투자회사,IF:사회간접자본투융자회사, DR:주식예탁증서, EW:ELW, EF:ETF,SW:신주인수권증권, SR:신주인수권증서, BC:수익증권, FE:해외ETF, FS:외국주권, EN:ETN

mktWarnTpCd

string(2)

시장경보구분코드

00:해당없음(시장경보가 지정될 수 있는 종목에 대해서 지정된 바가 없음을 의미), 01:투자주의, 02:투자경고, 03:투자위험

admisuYn

string(1)

관리종목여부

Y:관리 N:일반

haltYn

string(1)

거래정지여부

Y, N

idxIndMidclssCd

string(3)

지수업종중분류코드

업종분류, 상세코드는 코드표(업종) 참고

mktcapScaleCd

string(1)

시가총액규모코드

유가 (0:제외 1:대 2:중 3:소) / 코스닥 (0:제외 1:KOSDAQ100 2:KOSDAQmid300 3:KOSDAQsmall)

mfindYn

string(1)

제조업여부

Y, N (유가)제조업여부

smeYn

string(1)

중소기업여부

Y, N (코스닥)중소기업여부

krx100IsuYn

string(1)

KRX100종목여부

Y, N

kospiYn

string(1)

KOSPI여부

Y,N (유가)KOSPI100여부 (코스닥)프리미어여부

kospi100Yn

string(1)

KOSPI100여부

Y, N (유가)KOSPI여부

kospi50Yn

string(1)

KOSPI50여부

Y, N (유가)KOSPI50여부

basPrc

number(11)

기준가격,기준가액

prevddClsprc

number(11)

전일종가

prevddAccTrdvol

number(12)

전일누적거래량

prevddAccTrdval

number(22)

전일누적거래대금

uplmtprc

number(11)

상한가

lwlmtprc

number(11)

하한가

sbPrc

number(11)

대용가격

ST,FS,DR,MF,RT,SC,IF,ET,FE,BC,EN 만 해당

parval

number(11)

액면가

외국주권일 경우 소숫점셋째자리까지 표현가능/코스닥의 각국의 최소화폐단위 표시는 유가기준으로 통일 ※ST,FS,RT,SC,BC만 해당

isuPrc

number(11)

발행가격

ELW, 신주인수권증서 포함

listDd

string(8)

상장일자

YYYYMMDD

listShrs

number(16)

상장주식수,상장증권수

arrantrdYn

string(1)

정리매매여부

creditOrdPosblYn

string(1)

신용주문가능여부

Y, N

regulssQtyUnit

number(6)

정규장매매수량단위

invstcautnRemndIsuYn

string(1)

투자주의환기종목여부

Y, N

srttrmOverheatIsuTpCd

string(1)

단기과열종목구분코드

0: 해당없음, 1: 지정예고, 2: 지정, 3: 지정연장(해제연기)

eps

number(11)

주당순이익

per

number(11)

주가수익률

bps

number(11)

주당순자산가치

pbr

number(11)

주당순자산비율

dps

number(11)

주당배당금액

divYd

number(11)

배당수익율

acntclsCd

string(12)

결산월구분

월별 Map 구조 (001001001001 => 3,6,9,12 월)

adjStkprcCalcYn

string(1)

수정주가산출여부

Y, N

prevddNav

number(22)

전일순자산가치

ETF종목일 경우 소수점 2자리로 표현, 일반종목은 0

Request Example 

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/master'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "prevddClsprc": 67400,
        "prevddAccTrdvol": 24365002,
        "prevddAccTrdval": 1637773742750,
        "prevddNav": 0,
        "trdDd": 20220602,
        "acntclsMm": "12",
        "acntclsCd": "000000000001",
        "eps": 5777,
        "bps": 43611,
        "per": 11.53,
        "pbr": 1.53,
        "divYd": 2.1,
        "basPrc": 67400,
        "arrantrdYn": "N",
        "isuKorAbbrv": "삼성전자",
        "isuEngNm": "SamsungElec",
        "isuCd": "KR7005930003",
        "listDd": 19750611,
        "mfindYn": "Y",
        "kospi100Yn": "Y",
        "kospi50Yn": "Y",
        "parval": 100,
        "dps": 1444,
        "admisuYn": "N",
        "mktWarnTpCd": "00",
        "haltYn": "N",
        "isuPrc": 0,
        "uplmtprc": 87600,
        "lwlmtprc": 47200,
        "sbPrc": 53920,
        "listShrs": 5969782550,
        "regulssQtyUnit": 1,
        "mktcapScaleCd": 2,
        "kospiYn": "Y",
        "invstcautnRemndIsuYn": " -",
        "srttrmOverheatIsuTpCd": "0",
        "secugrpId": "ST",
        "smeYn": "N",
        "krx100IsuYn": "Y",
        "creditOrdPosblYn": "N",
        "adjStkprcCalcYn": "N",
        "idxIndMidclssCd": 13
    }
}

KOSPI 주식종목 마스터(요구형) API

  • 주식 종목별 마스터(배치) 정보에 대해 종목별 요청한 데이타 항목만 조회결과로 전송

  • 주식종목마스터(master) 대비 다양한 종목기본정보를 제공 등 최고가, 대차, 이동평균등 총 85개 항목 제공

  • 고객 추가 요구사항 발생시 API 변경을 최소화하여 추가 데이타 제공

  • 사용 방법 예) 삼성전자 전일종가와 52주최고가격만 조회하고자 할 경우 GET /v3/market/closed/kospi/005930/selectivemaster?prevddClsprc&wk52HgstPrc

  • 제공시간 : AM 06:30

/v3/market/closed/kospi/{issuecode}/selectivemaster

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/selectivemaster

Path Parameters

Name
Type
Description

issuecode*

string

종목코드 ex)005930

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isuSrtCd": "005930",
     "prevddClsprc": 2650000,
     "prevddAccTrdvol": 0,
     "prevddAccTrdval": 0,
     "prevddNav": 0,
     "BzDd": 20180504,
     "acntclsMm": "12",
     "acntclsCd": "000000000001",
     "eps": 5997,
     "bps": 28126,
     "per": 8.67,
     "pbr": 1.85,
     "divYd": 0,
     "basPrc": 53000,
     "arrantrdYn": "N",
     "isuKorAbbrv": "삼성전자",
     "isuCd": "KR7005930003",
     "listDd": 19750611,
     "idxIndUpclssCd": 13,
     "idxIndMidclssCd": 13,
     "idxIndLwclssCd": 13,
     "mfindYn": "Y",
     "kospi100Yn": "N",
     "kospi50Yn": "N",
     "parval": 100,
     "dps": 850,
     "admisuYn": "N",
     "mktWarnTpCd": "00",
     "haltYn": "N",
     "isuPrc": 0,
     "uplmtprc": 68900,
     "lwlmtprc": 37100,
     "sbPrc": 41340,
     "listShrs": 6419324700,
     "regulssQtyUnit": 1,
     "mktcapScaleCd": 2,
     "kospiYn": "N",
     "invstcautnRemndIsuYn": "N",
     "srttrmOverheatIsuTpCd": "0",
     "secugrpId": "ST",
     "smeYn": "N",
     "isuTrdvol": "Y",
     "creditOrdPosblYn": "N",
     "adjStkprcCalcYn": "Y" 
  } 
}

Response Parameters

Name

Type

Description

제공구분

trdDd

string(8)

체결일자,거래일자,매매일자

~/master, ~/selectivemaster

isuCd

string(12)

종목코드

표준코드

~/master, ~/selectivemaster

isuSrtCd

string(9)

종목단축코드

예) KR7000660001 → 000660

~/master, ~/selectivemaster

isuKorAbbrv

string(40)

종목한글약명

가나다

~/master, ~/selectivemaster

secugrpId

string(2)

증권그룹ID

ST:주권 MF:증권투자회사 RT:부동산투자회사 SC:선박투자회사 IF:사회간접자본투융자회사 DR:주식예탁증서 EW:ELW EF:ETF SW:신주인수권증권 SR:신주인수권증서 BC:수익증권 FE:해외ETF FS:외국주권 EN:ETN 2014.11.17

~/master, ~/selectivemaster

mktWarnTpCd

string(2)

시장경보구분코드

00:해당없음(시장경보가 지정될 수 있는 종목에 대해서 지정된 바가 없음을 의미) 01:투자주의 02:투자경고 03:투자위험

~/master, ~/selectivemaster

admisuYn

string(1)

관리종목여부

Y:관리 N:일반

~/master, ~/selectivemaster

haltYn

string(1)

거래정지여부

Y, N

~/master, ~/selectivemaster

idxIndMidclssCd

string(3)

지수업종중분류코드

업종분류, 상세코드는 업종코드표 참고

~/master, ~/selectivemaster

mktcapScaleCd

string(1)

시가총액규모코드

유가(0:제외 1:대 2:중 3:소) 코스닥(0:제외 1:KOSDAQ100 2:KOSDAQmid300 3:KOSDAQsmall)

~/master, ~/selectivemaster

mfindYn

string(1)

제조업여부

Y, N (유가)제조업여부

~/master, ~/selectivemaster

smeYn

string(1)

중소기업여부

Y, N (코스닥)중소기업여부

~/master, ~/selectivemaster

krx100IsuYn

string(1)

KRX100종목여부

Y, N

~/master, ~/selectivemaster

kospiYn

string(1)

KOSPI여부

Y, N (유가)KOSPI100여부,(코스닥)프리미어여부, 프리미어여부 추가 2009.11.16

~/master, ~/selectivemaster

kospi100Yn

string(1)

KOSPI100여부

Y, N (유가)KOSPI여부

~/master, ~/selectivemaster

kospi50Yn

string(1)

KOSPI50여부

Y, N (유가)KOSPI50여부

~/master, ~/selectivemaster

basPrc

number(11)

기준가격,기준가액

~/master, ~/selectivemaster

prevddClsprc

number(11)

전일종가

~/master, ~/selectivemaster

prevddAccTrdvol

number(11)

상장중최저가일자

~/master, ~/selectivemaster

prevddAccTrdval

number(22)

전일누적거래대금

~/master, ~/selectivemaster

uplmtprc

number(11)

상한가

~/master, ~/selectivemaster

lwlmtprc

number(11)

하한가

~/master, ~/selectivemaster

sbPrc

number(11)

대용가격

ST,FS,DR,MF,RT,SC,IF,ET,FE,BC,EN 만 해당 2014.11.17

~/master, ~/selectivemaster

parval

number(11)

액면가

9(9)V9(3) 외국주권일 경우 소숫점셋째자리까지 표현가능 / 코스닥의 각국의 최소화폐단위 표시는 유가기준으로 통일 / ※ST,FS,RT,SC,BC만 해당"

~/master, ~/selectivemaster

isuPrc

number(11)

발행가격

신주인수권증서 포함

~/master, ~/selectivemaster

listDd

string(8)

상장일자

YYYYMMDD

~/master, ~/selectivemaster

listShrs

number(16)

상장주식수,상장증권수

~/master, ~/selectivemaster

arrantrdYn

string(1)

정리매매여부

~/master, ~/selectivemaster

creditOrdPosblYn

string(1)

신용주문가능여부

Y, N

~/master, ~/selectivemaster

regulssQtyUnit

number(6)

정규장매매수량단위

~/master, ~/selectivemaster

invstcautnRemndIsuYn

string(1)

투자주의환기종목여부

Y, N

~/master, ~/selectivemaster

srttrmOverheatIsuTpCd

string(1)

단기과열종목구분코드

0:해당없음 /1:지정예고 /2:지정 /3:지정연장(해제연기) 2012.11.05 추가

~/master, ~/selectivemaster

eps

number(11)

주당순이익

~/master, ~/selectivemaster

per

number(11)

주가수익률

~/master, ~/selectivemaster

bps

number(11)

주당순자산가치

~/master, ~/selectivemaster

pbr

number(11)

주당순자산비율

~/master, ~/selectivemaster

dps

number(11)

주당배당금액

~/master, ~/selectivemaster

divYd

number(11)

배당수익율

~/master, ~/selectivemaster

acntclsCd

string(12)

결산월구분

월별 Map 구조 (001001001001 => 3,6,9,12 월)

~/master, ~/selectivemaster

adjStkprcCalcYn

string(1)

수정주가산출여부

Y, N

~/master, ~/selectivemaster

prevddNav

number(22)

전일순자산가치

ETF종목일 경우 소수점 2자리로 표현, 일반종목은 0

~/master, ~/selectivemaster

srtsellTrdVol

number(11)

공매도거래량

공매도거래량(주식수, 전일기준)

~/shortsell,~/selectivemaster

srtsellTrdAmt

number(11)

공매도거래금액

공매도거래금액(주식수, 전일기준)

~/shortsell,~/selectivemaster

lendBalQty

number(11)

대차잔고수량

대차잔고수량(주식수, 전일기준)

~/shortsell,~/selectivemaster

lendBalAmt

number(11)

대차잔고금액

단위 1,000 원

~/shortsell,~/selectivemaster

srtsellOverheatDd

number(8)

공매도과열종목지정일

공매도 과열종목일 경우 값을 가짐

~/selectivemaster 요구형만 제공

dd3AvgPrc

number(11)

전일가격3일이동평균

개별종목

~/selectivemaster 요구형만 제공

dd5AvgPrc

number(11)

전일가격5일이동평균

개별종목, 지수

~/selectivemaster 요구형만 제공

dd10AvgPrc

number(11)

전일가격10일이동평균

개별종목, 지수

~/selectivemaster 요구형만 제공

dd20AvgPrc

number(11)

전일가격20일이동평균

개별종목, 지수

~/selectivemaster 요구형만 제공

dd40AvgPrc

number(11)

전일가격40일이동평균

개별종목

~/selectivemaster 요구형만 제공

dd60AvgPrc

number(11)

전일가격60일이동평균

개별종목, 지수

~/selectivemaster 요구형만 제공

dd120AvgPrc

number(11)

전일가격120일이동평균

개별종목, 지수

~/selectivemaster 요구형만 제공

dd250AvgPrc

number(11)

전일가격250일이동평균

개별종목

~/selectivemaster 요구형만 제공

dd3AvgTrdVol

number(11)

전일거래량3일이동평균

~/selectivemaster 요구형만 제공

dd5AvgTrdVol

number(11)

전일거래량5일이동평균

~/selectivemaster 요구형만 제공

dd10AvgTrdVol

number(11)

전일거래량10일이동평균

~/selectivemaster 요구형만 제공

dd20AvgTrdVol

number(11)

전일거래량20일이동평균

~/selectivemaster 요구형만 제공

dd40AvgTrdVol

number(11)

전일거래량40일이동평균

~/selectivemaster 요구형만 제공

dd60AvgTrdVol

number(11)

전일거래량60일이동평균

~/selectivemaster 요구형만 제공

dd120AvgTrdVol

number(11)

전일거래량120일이동평균

~/selectivemaster 요구형만 제공

dd250AvgTrdVol

number(11)

전일거래량250일이동평균

~/selectivemaster 요구형만 제공

dd3AvgTrdAmt

number(11)

전일거래대금3일이동평균

~/selectivemaster 요구형만 제공

dd5AvgTrdAmt

number(11)

전일거래대금5일이동평균

~/selectivemaster 요구형만 제공

dd10AvgTrdAmt

number(11)

전일거래대금10일이동평균

~/selectivemaster 요구형만 제공

dd20AvgTrdAmt

number(11)

전일거래대금20일이동평균

~/selectivemaster 요구형만 제공

dd40AvgTrdAmt

number(11)

전일거래대금40일이동평균

~/selectivemaster 요구형만 제공

dd60AvgTrdAmt

number(11)

전일거래대금60일이동평균

~/selectivemaster 요구형만 제공

dd120AvgTrdAmt

number(11)

전일거래대금120일이동평균

~/selectivemaster 요구형만 제공

dd250AvgTrdAmt

number(11)

전일거래대금250일이동평균

~/selectivemaster 요구형만 제공

dd5AvgDp

number(11)

전일이격도5일이동평균

~/selectivemaster 요구형만 제공

dd20AvgDp

number(11)

전일이격도20일이동평균

~/selectivemaster 요구형만 제공

dd60AvgDp

number(11)

전일이격도60일이동평균

~/selectivemaster 요구형만 제공

dd120AvgDp

number(11)

전일이격도120일이동평균

~/selectivemaster 요구형만 제공

BzDd

number(11)

영업일

시장별 최종가동일, 입회일(오늘일 경우 정상시장 가동)

~/selectivemaster 요구형만 제공

IsuEngNm

string(80)

종목명(영문)

~/selectivemaster 요구형만 제공

wk52HgstPrc

number(11)

52주최고가격

wk52LwstPrc

number(11)

52주최저가격

wk52HgstprcDd

number(8)

52주최고가일자

wk52LwstprcDd

number(8)

52주최저가일자

wk52HgstTrdvol

number(11)

52주최고거래량

wk52LwstTrdvol

number(11)

52주최저거래량

liquShrs

number(16)

유동주식수

DebtRt

number(11)

부채비율

부채비율 소수점 2자리 형태

CrdtGrd

string(64)

신용등급

Cap

number(11)

자본금

Request Example 

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/selectivemaster'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "prevddClsprc": 67400
    }
}

KOSPI 주식종목 종가 API

  • 제공시간 : 전일,당일 PM 15:40 이후

/v3/market/closed/kospi/{issuecode}/closeprice

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/closeprice

종목 당일 종가제공

Path Parameters

Name
Type
Description

issuecode*

string

종목코드 ex)005930

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "trdPrc": 66700,
        "cmpprevddTpCd": "5",
        "opnprc": 66600,
        "hgprc": 67000,
        "lwprc": 66400,
        "accTrdvol": 13866071,
        "accTrdval": 923783719900,
        "cmpprevddPrc": -700
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

cmpprevddTpCd

String(1)

전일대비구분코드

1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락

cmpprevddPrc

number(11)

전일대비가격

단위:원 / 신주인수권 증서&증권의 신규 상장 당일 : 0

opnprc

number(11)

시가

단위:원

hgprc

number(11)

고가

단위:원

lwprc

number(11)

저가

단위:원

trdPrc

number(11)

체결가격

accTrdvol

number(12)

누적체결수량,누적거래량

단위:주

accTrdval

number(22)

누적거래대금

단위:원

Request Example 

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/closeprice'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "trdPrc": 66700,
        "cmpprevddTpCd": "5",
        "opnprc": 66600,
        "hgprc": 67000,
        "lwprc": 66400,
        "accTrdvol": 13866071,
        "accTrdval": 923783719900,
        "cmpprevddPrc": -700
    }
}

KOSPI 지수

/v3/market/closed/kospi/index

GET https://{APIGWAddr}/v3/market/closed/kospi/index

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "K1",
        "isuCnt": 941,
        "trdPrc": 2657.69,
        "cmpprevddTpCd": "5",
        "opnprc": 2670.74,
        "hgprc": 2674,
        "lwprc": 2654.96,
        "accTrdvol": 426879,
        "accTrdval": 6034972,
        "mktcap": 2091375645,
        "cmpprevddPrc": -28.21,
        "listShrs": 62187655
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

예) KR7000660001 → 000660

cmpprevddTpCd

String(1)

전일대비구분코드

1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락

cmpprevddPrc

number(11)

전일대비가격

단위:원 / 신주인수권 증서&증권의 신규 상장 당일 : 0

opnprc

number(11)

시가

단위:원

hgprc

number(11)

고가

단위:원

lwprc

number(11)

저가

단위:원

trdPrc

number(11)

체결가격

accTrdvol

number(12)

누적체결수량,누적거래량

단위:주

accTrdval

number(22)

누적거래대금

단위:원

isuCnt

number(16)

종목수

listShrs

number(16)

상장주식수,상장증권수

업종상장주식수 단위는 천주, 그외는 1주

mktcap

number(22)

시가총액

단위: 업종-백만

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/index'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "K1",
        "isuCnt": 941,
        "trdPrc": 2657.69,
        "cmpprevddTpCd": "5",
        "opnprc": 2670.74,
        "hgprc": 2674,
        "lwprc": 2654.96,
        "accTrdvol": 426879,
        "accTrdval": 6034972,
        "mktcap": 2091375645,
        "cmpprevddPrc": -28.21,
        "listShrs": 62187655
    }
}

KOSPI 주식 공매도 일별조회 API

  • 제공시간 : 전일,당일 18:00 이후

/v3/market/closed/kospi/{issucode}/shortsell

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/shortsell

Path Parameters

Name
Type
Description

issuecode*

string

종목코드 ex)005930

Query Parameters

Name
Type
Description

inqStrtDd*

string

조회시작일자

inqEndDd*

string

조회종료일자

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "trdDd": 20220503,
                "lendBalQty": 102233597,
                "lendBalAmt": 6900767798,
                "srtsellBal": 6962010,
                "srtsellTrdVol": 304382,
                "srtsellTrdAmt": 20684272600
            },
            {
                "trdDd": 20220502,
                "lendBalQty": 101920931,
                "lendBalAmt": 6859278656,
                "srtsellBal": 6829747,
                "srtsellTrdVol": 117178,
                "srtsellTrdAmt": 7869529000
            }
        ]
    }
}

Response Parameter

Name

Type

Description

isuSrtCd

string(9)

종목단축코드

예) KR7000660001 → 000660

hisLists

Array(4)

과거리스트

trdDd

string(8)

체결일자,거래일자,매매일자

YYYYMMDD

srtsellTrdvol

number(11)

공매도거래량

공매도거래량(주식수, 전일기준)

srtsellTrdAmt

number(11)

공매도거래금액

공매도거래금액(주식수, 전일기준)

lendBalQty

number(11)

대차잔고수량

대차잔고수량(주식수, 전일기준)

lendBalAmt

number(11)

대차잔고금액

단위 1,000 원

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/shortsell?inqStrtDd=20181001&inqEndDd=20181231'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "trdDd": 20220503,
                "lendBalQty": 102233597,
                "lendBalAmt": 6900767798,
                "srtsellBal": 6962010,
                "srtsellTrdVol": 304382,
                "srtsellTrdAmt": 20684272600
            },
            {
                "trdDd": 20220502,
                "lendBalQty": 101920931,
                "lendBalAmt": 6859278656,
                "srtsellBal": 6829747,
                "srtsellTrdVol": 117178,
                "srtsellTrdAmt": 7869529000
            }
        ]
    }
}

KOSPI 주식 외국인 보유율 히스토리 API

  • 종목 외국인 보유율 과거 데이터 제공

  • 제공시간 : AM 06:30

/v3/market/closed/kospi/{issucode}/foreignhistory

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/foreignhistory

최대 100건 까지만 조회 가능

Path Parameters

Name
Type
Description

issuecode*

string

종목코드

Query Parameters

Name
Type
Description

inqStrtDd*

string

조회시작일자 (YYYYMMDD)

inqEndDd*

string

조회종료일자

reqCnt

number

요청건수 (최대100건)

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "FornHdVol": 3038107622,
                "cmpprevddFornHdVol": 462651,
                "FornHdVolRt": 50.89,
                "trdDd": 20220503
            },
            {
                "FornHdVol": 3037644971,
                "cmpprevddFornHdVol": -791919,
                "FornHdVolRt": 50.88,
                "trdDd": 20220502
            }
        ]
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(9)

종목단축코드

hisLists

Array(4)

과거리스트

trdDd

string(8)

체결일자,거래일자,매매일자

FornHdVol

number(11)

외국인보유주식수

cmpprevddFornHdVol

number(11)

외국인보유주식수전일대비

FornHdVolRt

number(5)

외국인보유율

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/foreignhistory?inqStrtDd=20181001&inqEndDd=20181231&reqCnt=20'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "FornHdVol": 3038107622,
                "cmpprevddFornHdVol": 462651,
                "FornHdVolRt": 50.89,
                "trdDd": 20220503
            },
            {
                "FornHdVol": 3037644971,
                "cmpprevddFornHdVol": -791919,
                "FornHdVolRt": 50.88,
                "trdDd": 20220502
            }
        ]
    }
}

KOSPI 주식 종목 히스토리 API

  • 종목 일별 과거 데이터 제공

  • 제공시간 : AM 06:30

/v3/market/closed/kospi/{issuecode}/history

GET https://{APIGWAddr}/v3/market/closed/kospi/{issuecode}/history

Path Parameters

Name
Type
Description

issuecode*

string

종목코드

Query Parameters

Name
Type
Description

trnsmCycleTpCd*

string

전송주기구분코드 (D:일별, W:주별, M:월별) 해당기간의 마지막영업일 기준시세. ex) W:주-금요일, M:월-31일

inqStrtDd*

string

조회시작일자 (YYYYMMDD)

inqEndDd*

string

조회종료일자 (YYYYMMDD)

reqCnt

number

요청건수 (최대 100건)

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 67500,
                "cmpprevddTpCd": "2",
                "opnprc": 67400,
                "hgprc": 68400,
                "lwprc": 67300,
                "accTrdvol": 14168875,
                "accTrdval": 962643054300,
                "cmpprevddPrc": 200
            },
            {
                "trdDd": 20220502,
                "trdPrc": 67300,
                "cmpprevddTpCd": "5",
                "opnprc": 66600,
                "hgprc": 67600,
                "lwprc": 66500,
                "accTrdvol": 14106184,
                "accTrdval": 946016270200,
                "cmpprevddPrc": -100
            }
        ]
    }
}

Response Parameters

Name

Type

Description

isuSrtCd

String(3)

종목단축코드

hisLists

Array(4)

과거리스트

trdDd

string(8)

체결일자,거래일자,매매일자

YYYYMMDD

trdPrc

number(11)

체결가격

cmpprevddTpCd

string(1)

전일대비구분코

1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락

cmpprevddPrc

number(11)

전일대비가격

단위:원 / 신주인수권 증서,증권의 신규 상장 당일 : 0

accTrdvol

number(12)

누적체결수량,누적거래량

단위:주

accTrdval

number(22)

누적거래대금

단위:원

opnprc

number(11)

시가

단위:원

hgprc

number(11)

고가

단위:원

lwprc

number(11)

저가

단위:원

Request Example

curl --include --header "apikey:l7xx230ef2235e34448c982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/history?trnsmCycleTpCd=D&inqStrtDd=20181001&inqEndDd=20181231&reqCnt=5'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "005930",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 67500,
                "cmpprevddTpCd": "2",
                "opnprc": 67400,
                "hgprc": 68400,
                "lwprc": 67300,
                "accTrdvol": 14168875,
                "accTrdval": 962643054300,
                "cmpprevddPrc": 200
            },
            {
                "trdDd": 20220502,
                "trdPrc": 67300,
                "cmpprevddTpCd": "5",
                "opnprc": 66600,
                "hgprc": 67600,
                "lwprc": 66500,
                "accTrdvol": 14106184,
                "accTrdval": 946016270200,
                "cmpprevddPrc": -100
            }
        ]
    }
}

Previous주식실시간종가BNext주식실시간A

Last updated