주식시장(코스닥)의 종목 리스트, 종목 마스터 등 종가 정보를 제공한다.
Syntax
HTTP methods | GET
Authentication | API Key
KOSDAQ 주식 종목 리스트 API
/v3/market/closed/kosdaq/lists
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/lists
종목리스트
200
Copy {
"trdDd" : "20220602" ,
"mktEndTm" : "1540" ,
"isuLists" : [
{
"isuSrtCd" : "900110" ,
"isuCd" : "HK0000057197" ,
"isuKorNm" : "이스트아시아홀딩스" ,
"isuKorAbbr" : "이스트아시아홀딩스" ,
"map_to" : "900110*003"
} ,
...
{
"isuSrtCd" : "900100" ,
"isuCd" : "USU652221081" ,
"isuKorNm" : "애머릿지" ,
"isuKorAbbr" : "애머릿지" ,
"map_to" : "900100*003"
}
]
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/lists'
Response Example
Copy {
"trdDd" : "20220602" ,
"mktEndTm" : "1540" ,
"isuLists" : [
{
"isuSrtCd" : "900110" ,
"isuCd" : "HK0000057197" ,
"isuKorNm" : "이스트아시아홀딩스" ,
"isuKorAbbr" : "이스트아시아홀딩스" ,
"map_to" : "900110*003"
} ,
...
{
"isuSrtCd" : "900100" ,
"isuCd" : "USU652221081" ,
"isuKorNm" : "애머릿지" ,
"isuKorAbbr" : "애머릿지" ,
"map_to" : "900100*003"
}
]
}
KOSDAQ 주식종목 마스터 API
/v3/market/closed/kosdaq/{issuecode}/master
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/master
Path Parameters
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"prevddClsprc" : 505000 ,
"prevddAccTrdvol" : 244181 ,
"prevddAccTrdval" : 122258221700 ,
"prevddNav" : 0 ,
"trdDd" : 20220602 ,
"acntclsMm" : "12" ,
"acntclsCd" : "000000000001" ,
"eps" : 4599 ,
"bps" : 23807 ,
"per" : 109.31 ,
"pbr" : 21.12 ,
"divYd" : 0.2 ,
"basPrc" : 505000 ,
"arrantrdYn" : "N" ,
"isuKorAbbrv" : "에코프로비엠" ,
"isuEngNm" : "ECOPROBM" ,
"isuCd" : "KR7247540008" ,
"listDd" : 20190305 ,
"mfindYn" : "N" ,
"kospi100Yn" : "0" ,
"kospi50Yn" : " -" ,
"parval" : 500 ,
"dps" : 920 ,
"admisuYn" : "N" ,
"mktWarnTpCd" : "00" ,
"haltYn" : "N" ,
"isuPrc" : null ,
"uplmtprc" : 656500 ,
"lwlmtprc" : 353500 ,
"sbPrc" : 353500 ,
"listShrs" : 22919466 ,
"regulssQtyUnit" : 1 ,
"mktcapScaleCd" : 2 ,
"kospiYn" : "N" ,
"invstcautnRemndIsuYn" : "N" ,
"srttrmOverheatIsuTpCd" : "0" ,
"secugrpId" : "ST" ,
"smeYn" : "N" ,
"krx100IsuYn" : "Y" ,
"creditOrdPosblYn" : "N" ,
"adjStkprcCalcYn" : "N" ,
"idxIndMidclssCd" : 72
}
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/master'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"prevddClsprc" : 505000 ,
"prevddAccTrdvol" : 244181 ,
"prevddAccTrdval" : 122258221700 ,
"prevddNav" : 0 ,
"trdDd" : 20220602 ,
"acntclsMm" : "12" ,
"acntclsCd" : "000000000001" ,
"eps" : 4599 ,
"bps" : 23807 ,
"per" : 109.31 ,
"pbr" : 21.12 ,
"divYd" : 0.2 ,
"basPrc" : 505000 ,
"arrantrdYn" : "N" ,
"isuKorAbbrv" : "에코프로비엠" ,
"isuEngNm" : "ECOPROBM" ,
"isuCd" : "KR7247540008" ,
"listDd" : 20190305 ,
"mfindYn" : "N" ,
"kospi100Yn" : "0" ,
"kospi50Yn" : " -" ,
"parval" : 500 ,
"dps" : 920 ,
"admisuYn" : "N" ,
"mktWarnTpCd" : "00" ,
"haltYn" : "N" ,
"isuPrc" : null ,
"uplmtprc" : 656500 ,
"lwlmtprc" : 353500 ,
"sbPrc" : 353500 ,
"listShrs" : 22919466 ,
"regulssQtyUnit" : 1 ,
"mktcapScaleCd" : 2 ,
"kospiYn" : "N" ,
"invstcautnRemndIsuYn" : "N" ,
"srttrmOverheatIsuTpCd" : "0" ,
"secugrpId" : "ST" ,
"smeYn" : "N" ,
"krx100IsuYn" : "Y" ,
"creditOrdPosblYn" : "N" ,
"adjStkprcCalcYn" : "N" ,
"idxIndMidclssCd" : 72
}
}
KOSDAQ 주식종목 마스터(요구형) API
주식 종목별 마스터(배치) 정보에 대해 종목별 요청한 데이타 항목만 조회결과로 전송
주식종목마스터(master) 대비 다양한 종목기본정보를 제공 등
최고가, 대차, 이동평균등 총 85개 항목 제공
고객 추가 요구사항 발생시 API 변경을 최소화하여 추가 데이타 제공
사용 방법 예) 에코프로비엠 전일종가와 52주최고가격만 조회하고자 할 경우 GET /v3/market/closed/kosdaq/247540/selectivemaster?prevddClsprc&wk52HgstPrc
/v3/market/closed/kosdaq/{issuecode}/selectivemaster
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/selectivemaster
Path Parameters
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"prevddClsprc" : 505000
}
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/selectivemaster'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"prevddClsprc" : 505000
}
}
KOSDAQ 주식종목 종가 API
/v3/market/closed/kosdaq/{issuecode}/closeprice
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/closeprice
종목 당일 종가제공
Path Parameters
200 400
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"trdPrc" : 503200 ,
"cmpprevddTpCd" : "5" ,
"opnprc" : 500700 ,
"hgprc" : 505100 ,
"lwprc" : 496100 ,
"accTrdvol" : 100002 ,
"accTrdval" : 50129874200 ,
"cmpprevddPrc" : -1800
}
}
Copy {
"error": "당일 종가 제공 시간이 아닙니다."
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/closeprice'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"trdPrc" : 503200 ,
"cmpprevddTpCd" : "5" ,
"opnprc" : 500700 ,
"hgprc" : 505100 ,
"lwprc" : 496100 ,
"accTrdvol" : 100002 ,
"accTrdval" : 50129874200 ,
"cmpprevddPrc" : -1800
}
}
KOSDAQ 지수
/v3/market/closed/kosdaq/index
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/index
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "Q1" ,
"isuCnt" : 1556 ,
"trdPrc" : 890.11 ,
"cmpprevddTpCd" : "5" ,
"opnprc" : 890.47 ,
"hgprc" : 892.98 ,
"lwprc" : 888.45 ,
"accTrdvol" : 1052988 ,
"accTrdval" : 5777766 ,
"mktcap" : 394085835 ,
"cmpprevddPrc" : -3.25 ,
"listShrs" : 46123757
}
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/index'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "Q1" ,
"isuCnt" : 1556 ,
"trdPrc" : 890.11 ,
"cmpprevddTpCd" : "5" ,
"opnprc" : 890.47 ,
"hgprc" : 892.98 ,
"lwprc" : 888.45 ,
"accTrdvol" : 1052988 ,
"accTrdval" : 5777766 ,
"mktcap" : 394085835 ,
"cmpprevddPrc" : -3.25 ,
"listShrs" : 46123757
}
}
KOSDAQ 주식 공매도 일별조회 API
/v3/market/closed/kosdaq/{issucode}/shortsell
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/shortsell
Path Parameters
Query Parameters
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"trdDd" : 20220503 ,
"lendBalQty" : 2398180 ,
"lendBalAmt" : 1225469980 ,
"srtsellBal" : 588890 ,
"srtsellTrdVol" : 17491 ,
"srtsellTrdAmt" : 8872884900
} ,
{
"trdDd" : 20220502 ,
"lendBalQty" : 2439030 ,
"lendBalAmt" : 1195124700 ,
"srtsellBal" : 562224 ,
"srtsellTrdVol" : 26917 ,
"srtsellTrdAmt" : 13038232800
}
]
}
}
Response Parameter
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/shortsell?inqStrtDd=20181001&inqEndDd=20181231'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"trdDd" : 20220503 ,
"lendBalQty" : 2398180 ,
"lendBalAmt" : 1225469980 ,
"srtsellBal" : 588890 ,
"srtsellTrdVol" : 17491 ,
"srtsellTrdAmt" : 8872884900
} ,
{
"trdDd" : 20220502 ,
"lendBalQty" : 2439030 ,
"lendBalAmt" : 1195124700 ,
"srtsellBal" : 562224 ,
"srtsellTrdVol" : 26917 ,
"srtsellTrdAmt" : 13038232800
}
]
}
}
KOSDAQ 주식 외국인 보유율 히스토리 API
/v3/market/closed/kosdaq/{issucode}/foreignhistory
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/foreignhistory
최대 100건 까지만 조회 가능
Path Parameters
Query Parameters
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"FornHdVol" : 2340232 ,
"cmpprevddFornHdVol" : -8698 ,
"FornHdVolRt" : 10.21 ,
"trdDd" : 20220503
} ,
{
"FornHdVol" : 2348930 ,
"cmpprevddFornHdVol" : 9281 ,
"FornHdVolRt" : 10.25 ,
"trdDd" : 20220502
}
]
}
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/foreignhistory?inqStrtDd=20181001&inqEndDd=20181231&reqCnt=20'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"FornHdVol" : 2340232 ,
"cmpprevddFornHdVol" : -8698 ,
"FornHdVolRt" : 10.21 ,
"trdDd" : 20220503
} ,
{
"FornHdVol" : 2348930 ,
"cmpprevddFornHdVol" : 9281 ,
"FornHdVolRt" : 10.25 ,
"trdDd" : 20220502
}
]
}
}
KOSDAQ 주식 종목 히스토리 API
/v3/market/closed/kosdaq/{issuecode}/history
GET
https://{APIGWAddr}/v3/market/closed/kosdaq/{issuecode}/history
Path Parameters
Query Parameters
200
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"trdDd" : 20220503 ,
"trdPrc" : 503619 ,
"cmpprevddTpCd" : "2" ,
"opnprc" : 488934 ,
"hgprc" : 504999 ,
"lwprc" : 488836 ,
"accTrdvol" : 337130 ,
"accTrdval" : 170866691500 ,
"cmpprevddPrc" : 20696
} ,
{
"trdDd" : 20220502 ,
"trdPrc" : 482922 ,
"cmpprevddTpCd" : "2" ,
"opnprc" : 465971 ,
"hgprc" : 484203 ,
"lwprc" : 464098 ,
"accTrdvol" : 265195 ,
"accTrdval" : 128353745900 ,
"cmpprevddPrc" : 13403
}
]
}
}
Response Parameters
Request Example
Copy curl --include --header "apikey:l7xx230ef2235e34448c982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kosdaq/247540/history?trnsmCycleTpCd=D&inqStrtDd=20181001&inqEndDd=20181231&reqCnt=5'
Response Example
Copy {
"jsonrpc" : "2.0" ,
"result" : {
"isuSrtCd" : "247540" ,
"hisLists" : [
{
"trdDd" : 20220503,
"trdPrc" : 503619,
"cmpprevddTpCd" : "2" ,
"opnprc" : 488934,
"hgprc" : 504999,
"lwprc" : 488836,
"accTrdvol" : 337130,
"accTrdval" : 170866691500,
"cmpprevddPrc" : 20696
},
{
"trdDd" : 20220502,
"trdPrc" : 482922,
"cmpprevddTpCd" : "2" ,
"opnprc" : 465971,
"hgprc" : 484203,
"lwprc" : 464098,
"accTrdvol" : 265195,
"accTrdval" : 128353745900,
"cmpprevddPrc" : 13403
}
]
}
}