# 주식실시간종가A
주식시장(유가증권)의 종목 리스트, 종목 마스터 등 종가 정보를 제공한다.
## Syntax
HTTP methods | **GET**
Authentication | **API Key**
## KOSPI 주식 종목 리스트 API
* 제공시간 : AM 06:30
## /v3/market/closed/kospi/lists
`GET` `https://{APIGWAddr}/v3/market/closed/kospi/lists`
종목리스트
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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"
}
]
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/lists'
```
#### Response Example
```yaml
{
"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 |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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"
}
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/master'
```
#### Response Example
```yaml
{
"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 |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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"
}
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/selectivemaster'
```
#### Response Example
```yaml
{
"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 |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"jsonrpc": "2.0",
"result": {
"isuSrtCd": "005930",
"trdPrc": 66700,
"cmpprevddTpCd": "5",
"opnprc": 66600,
"hgprc": 67000,
"lwprc": 66400,
"accTrdvol": 13866071,
"accTrdval": 923783719900,
"cmpprevddPrc": -700
}
}
```
{% endtab %}
{% tab title="400 " %}
```
{
"error": "당일 종가 제공 시간이 아닙니다."
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/closeprice'
```
#### Response Example
```yaml
{
"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`
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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
}
}
```
{% endtab %}
{% endtabs %}
#### **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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/index'
```
#### Response Example
```yaml
{
"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 | 조회종료일자 |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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
}
]
}
}
```
{% endtab %}
{% endtabs %}
**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
```bash
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/closed/kospi/005930/shortsell?inqStrtDd=20181001&inqEndDd=20181231'
```
#### Response Example
```yaml
{
"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건) |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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
}
]
}
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
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
```yaml
{
"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건) |
{% tabs %}
{% tab title="200 " %}
```yaml
{
"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
}
]
}
}
```
{% endtab %}
{% endtabs %}
#### 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
```bash
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
```bash
{
"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
}
]
}
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://koscom.gitbook.io/open-api/api/marketv3/stocks/closeda.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.