부가서비스 (2024년 6월30일 종료)

Syntax

HTTP methods | GET

Authentication | API Key

ETF 구성종목 정보 API

• ETF 종목코드를 이용한 구성종목정보 제공

• 종목명 기준으로 ETF구성종목 정보를 편리하게 수신할수 있는 ETF PDF 파일 가공 서비스

• 제공시간 : AM 06:30

/v3/market/extra/stocks/{marketcode}/{issuecode}/pdf

GET https://{APIGWAddr}/v3/market/extra/stocks/{marketcode}/{issuecode}/pdf

Path Parameters

Name	Type	Description
marketcode*	String	ex) kospi | kosdaq
issuecode*	String	ex) 069500

200

{
    "Cnt": "200",
    "InqDd": "20220603",
    "Lists": [
        {
            "isuCd": "KR7000070003",
            "Unit": 6,
            "isuNm": "삼양홀딩스",
            "SetAmt": 483600,
            "ratio": 0.02
        },
        {
            "isuCd": "KR7000080002",
            "Unit": 49,
            "isuNm": "하이트진로",
            "SetAmt": 1781150,
            "ratio": 0.10
        }
    ]
}

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/extra/stocks/kospi/069500/pdf'

Response Example

{
    "Cnt": "200",
    "InqDd": "20220603",
    "Lists": [
        {
            "isuCd": "KR7000070003",
            "Unit": 6,
            "isuNm": "삼양홀딩스",
            "SetAmt": 483600,
            "ratio": 0.02
        },
        {
            "isuCd": "KR7000080002",
            "Unit": 49,
            "isuNm": "하이트진로",
            "SetAmt": 1781150,
            "ratio": 0.10
        }
    ]
}

ETF 종목 nav 조회 API

• ETF 종목코드를 이용한 nav(순자산가치) 현재가 조회

• 제공시간 : 실시간

/v3/market/extra/stocks/{marketcode}/{issuecode}/nav

GET https://{APIGWAddr}/v3/market/extra/stocks/{marketcode}/{issuecode}/nav

Path Parameters

Name	Type	Description
marketcode*	String	ex) kospi | kosdaq
issuecode*	String	ex) 069500

200

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "069500",
        "nav": 35255.08,
        "cmpprevddNav": 138.33
    }
}

Response Parameters

Name	Type	Description
isuSrtCd	string(9)	종목단축코드
nav	number(11)	순자산가치	당일 NAV (ETF종목만 존재, 소수점 2자리)
cmpprevddNav	number(11)	전일대비 순자산가치

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/extra/stocks/kospi/069500/nav'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "069500",
        "nav": 35255.08,
        "cmpprevddNav": 138.33
    }
}

ETF 종목 nav 히스토리 API

• ETF 종목 일별 과거 nav(순자산가치) 데이터 제공

• 제공시간 : AM 06:30

/v3/market/extra/stocks/{marketcode}/{issuecode}/navhistory

GET https://{APIGWAddr}/v3/market/extra/stocks/{marketcode}/{issuecode}/navhistory

Path Parameters

Name	Type	Description
marketcode*	String	ex) kospi | kosdaq
issuecode*	String	ex) 069500

Query Parameters

Name	Type	Description
trnsmCycleTpCd*	String	전송주기구분코드 [D:일, W:주, M:월] 해당기간의 마지막영업일 기준 시세임. 예) W:주-금요일, M:월-31일
inqStrtDd*	String	조회시작일자 YYYYMMDD
inqEndDd*	String	조회종료일자 YYYYMMDD
reqCnt	String	요청건수 (최대 100건)

200

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "069500",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 35290,
                "nav": 35398.24,
                "cmpprevddNav": -70.74
            },
            {
                "trdDd": 20220502,
                "trdPrc": 35375,
                "nav": 35468.98,
                "cmpprevddNav": -105.6
            }
        ]
    }
}

Response Parameters

Name	Type	Description
isuSrtCd	string(9)	종목단축코드
hisLists	Array(4)	과거리스트
trdDd	string(8)	체결일자,거래일자,매매일자	YYYYMMDD
nav	number(11)	순자산가치	당일 NAV (ETF종목만 존재, 소수점 2자리)
cmpprevddNav	number(11)	전일대비 순자산가치

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/extra/stocks/kospi/069500/navhistory?trnsmCycleTpCd=D&inqStrtDd=20220501&inqEndDd=20220503&reqCnt=2'

Response Example

{
    "jsonrpc": "2.0",
    "result": {
        "isuSrtCd": "069500",
        "hisLists": [
            {
                "trdDd": 20220503,
                "trdPrc": 35290,
                "nav": 35398.24,
                "cmpprevddNav": -70.74
            },
            {
                "trdDd": 20220502,
                "trdPrc": 35375,
                "nav": 35468.98,
                "cmpprevddNav": -105.6
            }
        ]
    }
}

국가별 휴장일 정보 API

• 국가별 현재일 이후의 휴장일 정보 (부정기 갱신으로 항시 데이터 변경 가능성 존재)

• 제공시간 : 실시간(부정기갱신)

/v3/market/extra/stocks/{nationcode}/holiday

GET https://{APIGWAddr}/v3/market/extra/stocks/{nationcode}/holiday

Path Parameters

Name	Type	Description
nationcode*	String	ex) KR

200

{
    "marketCd": "KR",
    "lists": [
        "20220606",
        "20220815",
        "20220909",
        "20220912",
        "20221003",
        "20221010",
        "20221230"
    ]
}

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://testoap.k-mydata.org/v3/market/extra/stocks/KR/holiday'

Response Example

{
    "marketCd": "KR",
    "lists": [
        "20220606",
        "20220815",
        "20220909",
        "20220912",
        "20221003",
        "20221010",
        "20221230"
    ]
}