시세라이센스 정책에 따라 API v3으로 업데이트되었으니 참고해주시길 바랍니다.
KOSPI/KOSDAQ등의 지수 예상지수 및 업종별 투자자별 거래량등을 제공한다.
Syntax
HTTP methods | GET
Authentication | API Key
업종 종가
/v2/market/index/{marketcode}/{issuecode}/closeprice
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/closeprice
Path Parameters
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"isuCnt": 891,
"trdPrc": 2409.03,
"cmpprevddTpCd": "5",
"opnprc": 2446.81,
"hgprc": 2449.88,
"lwprc": 2399.58,
"accTrdvol": 575922,
"accTrdval": 8999465,
"mktcap": 1609052294,
"cmpprevddPrc": -48.22,
"listShrs": 53713300
}
}
{
"error": "당일 종가 제공 시간이 아닙니다."
}
Response Parameters
1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락
단위:원 / 신주인수권 증서&증권의 신규 상장 당일 : 0
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/closeindex'
Response Example
{
"error": "당일 종가 제공 시간이 아닙니다."
}
업종 지수
/v2/market/index/{marketcode}/{issuecode}/index
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/index
Path Parameters
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"trdPrc": 2469.21,
"cmpprevddTpCd": "2",
"accTrdvol": 494710,
"trdTm": 13063000,
"accTrdval": 6246486,
"cmpprevddPrc": 7.83
}
}
Response Parameters
1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락
trdTm
"HHMMSSmm" 형태로 시간전송
정규장 개시전 또는 정규장 체결 발생 이전 : 0
장운영시그널, 대량체결 포함
※ 장운영시그널
정규장마감(15:00):31000000 /장종료시간외마감(15:30):41000000 /단일가마감(18:00):81000000 /일반Buy-in마감(18:00):91000007 /당일Buy-in마감(18:00):91000008
※ 대량체결시
장전대량매매체결:51000000/장중대량매매체결:61000000/장후대량매매체결:71000000"
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/index'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"trdPrc": 2040.04,
"cmpprevddTpCd": "2",
"accTrdvol": 114261,
"trdTm": 10122000,
"accTrdval": 1075046,
"cmpprevddPrc": 11.6
}
}
업종 예상지수
/v2/market/index/{marketcode}/{issuecode}/prospectindex
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/prospectindex
Path Parameters
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"deemTm": "9000000",
"deemTrdPrc": 2471.12,
"deemAccTrdvol": 15801,
"deemcmpprevddPrc": 9.74,
"deemcmpprevddTpCd": "69",
"deemAccTrdval": 298225
}
}
Response Parameters
1:상한/2:상승/3:보합/4:하한/5:하락/6:기세상한/7:기세상승/8:기세하한/9:기세하락
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/prospectindex'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"deemTm": "9000000",
"deemTrdPrc": 2029.95,
"deemAccTrdvol": 5041,
"deemcmpprevddPrc": 1.51,
"deemcmpprevddTpCd": "69",
"deemAccTrdval": 46703
}
}
업종 시가총액
/v2/market/index/{marketcode}/{issuecode}/marketcap
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/marketcap
Path Parameters
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"isuCnt": 1442,
"accTrdvol": 501479,
"accTrdval": 6323816,
"listShrs": 53642471
}
}
Response Parameters
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/marketcap'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"isuCnt": 901,
"accTrdvol": 115822,
"accTrdval": 1087268,
"mktcap": 1342909243,
"listShrs": 55522062
}
}
업종별 투자자별
/v2/market/index/{marketcode}/{issuecode}/investors
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/investors
Path Parameters
{
"jsonrpc": "2.0",
"result":
{
"Tm": "0",
"isuSrtCd": "K1",
"invstLists": [
{
"invstCd": "0",
"askTrdvol": 5907489,
"askTrdval": 302311797,
"bidTrdvol": 6739796,
"bidTrdval": 381023826
},
{
"invstCd": "0",
"askTrdvol": 2065869,
"askTrdval": 96146505,
"bidTrdvol": 2982361,
"bidTrdval": 122971912
},
... 이하생략 ...
]
}
}
Response Parameters
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/investors'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"Tm": "10143000",
"isuSrtCd": "K1",
"invstLists": [
{
"invstCd": "01",
"askTrdvol": 1807478,
"askTrdval": 83095436,
"bidTrdvol": 1075480,
"bidTrdval": 45434170
},
{
"invstCd": "02",
"askTrdvol": 122629,
"askTrdval": 6850362,
"bidTrdvol": 254701,
"bidTrdval": 11994572
},
{
"invstCd": "03",
"askTrdvol": 566249,
"askTrdval": 14767548,
"bidTrdvol": 447322,
"bidTrdval": 17725585
},
{
"invstCd": "04",
"askTrdvol": 112269,
"askTrdval": 2741904,
"bidTrdvol": 10007,
"bidTrdval": 543139
},
{
"invstCd": "05",
"askTrdvol": 2372,
"askTrdval": 156234,
"bidTrdvol": 11671,
"bidTrdval": 487228
},
{
"invstCd": "06",
"askTrdvol": 1278442,
"askTrdval": 54405488,
"bidTrdvol": 1153817,
"bidTrdval": 54565514
},
{
"invstCd": "07",
"askTrdvol": 0,
"askTrdval": 0,
"bidTrdvol": 0,
"bidTrdval": 0
},
{
"invstCd": "08",
"askTrdvol": 4246576,
"askTrdval": 181910152,
"bidTrdvol": 3331688,
"bidTrdval": 149146888
},
{
"invstCd": "09",
"askTrdvol": 1461253,
"askTrdval": 15613019,
"bidTrdvol": 497067,
"bidTrdval": 9715010
},
{
"invstCd": "10",
"askTrdvol": 99655391,
"askTrdval": 681510822,
"bidTrdvol": 99692222,
"bidTrdval": 690983059
},
{
"invstCd": "11",
"askTrdvol": 10024570,
"askTrdval": 205378931,
"bidTrdvol": 11866813,
"bidTrdval": 234567966
},
{
"invstCd": "12",
"askTrdvol": 115387790,
"askTrdval": 1084412924,
"bidTrdvol": 115387790,
"bidTrdval": 1084412923
},
{
"invstCd": "13",
"askTrdvol": 357137,
"askTrdval": 19893180,
"bidTrdvol": 378690,
"bidTrdval": 18396680
},
{
"invstCd": "14",
"askTrdvol": 9792902,
"askTrdval": 203541449,
"bidTrdvol": 11574270,
"bidTrdval": 231474813
},
{
"invstCd": "15",
"askTrdvol": 231668,
"askTrdval": 1837482,
"bidTrdvol": 292543,
"bidTrdval": 3093153
},
{
"invstCd": "16",
"askTrdvol": 1461253,
"askTrdval": 15613019,
"bidTrdvol": 497067,
"bidTrdval": 9715010
}
]
}
}
업종 일중
/v2/market/index/{marketcode}/{issuecode}/intraday
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/intraday
상품/지수선물 종목 10초/분별 데이터 제공
Path Parameters
Query Parameters
일중전송주기구분코드 구분코드 (10:10초, 60:1분, 600:10분)
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"hisLists": [
{
"inddTm": "9300000",
"inddOpnprc": 2386.7,
"inddHgprc": 2388.88,
"inddLwprc": 2385.62,
"inddClsprc": 2387.58,
"inddTrdvol": 53052
},
{
"inddTm": "9200000",
"inddOpnprc": 2387.03,
"inddHgprc": 2388.37,
"inddLwprc": 2385.86,
"inddClsprc": 2386.65,
"inddTrdvol": 42379
},
{
"inddTm": "9100000",
"inddOpnprc": 2386.76,
"inddHgprc": 2388.33,
"inddLwprc": 2383.47,
"inddClsprc": 2387.37,
"inddTrdvol": 29504
}
]
}
}
Response Parameters
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/intraday?inddCycleTpCd=600&inqStrtDd=20181228&strtTm=0900&endTm=1500'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"hisLists": [
{
"inddTm": "10154000",
"inddOpnprc": 2040.21,
"inddHgprc": 2041.08,
"inddLwprc": 2039.65,
"inddClsprc": 2039.69,
"inddTrdvol": 117477
},
{
"inddTm": "10100000",
"inddOpnprc": 2041.27,
"inddHgprc": 2041.96,
"inddLwprc": 2039.75,
"inddClsprc": 2041.31,
"inddTrdvol": 111972
},
{
"inddTm": "10000000",
"inddOpnprc": 2041.18,
"inddHgprc": 2042.91,
"inddLwprc": 2040.1,
"inddClsprc": 2042.74,
"inddTrdvol": 102781
},
{
"inddTm": "9500000",
"inddOpnprc": 2040.07,
"inddHgprc": 2041.66,
"inddLwprc": 2038.86,
"inddClsprc": 2041.37,
"inddTrdvol": 89531
},
{
"inddTm": "9400000",
"inddOpnprc": 2041.14,
"inddHgprc": 2044.03,
"inddLwprc": 2039.16,
"inddClsprc": 2039.86,
"inddTrdvol": 74108
},
{
"inddTm": "9300000",
"inddOpnprc": 2041.38,
"inddHgprc": 2041.43,
"inddLwprc": 2036.83,
"inddClsprc": 2039.94,
"inddTrdvol": 60232
},
{
"inddTm": "9200000",
"inddOpnprc": 2040.85,
"inddHgprc": 2041.71,
"inddLwprc": 2037.96,
"inddClsprc": 2041.41,
"inddTrdvol": 48078
},
{
"inddTm": "9100000",
"inddOpnprc": 2036.7,
"inddHgprc": 2043.54,
"inddLwprc": 2035.41,
"inddClsprc": 2040.32,
"inddTrdvol": 31820
}
]
}
}
업종 히스토리
/v2/market/index/{marketcode}/{issuecode}/history
GET https://{APIGWAddr}/v2/market/index/{marketcode}/{issuecode}/history
Path Parameters
Query Parameters
전송주기구분코드 (D:일별, W:주별, M:월별)
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"hisLists": [
{
"BzDd": 20170331,
"trdPrc": 2160.23,
"cmpprevddTpCd": "5",
"opnprc": 2166.62,
"hgprc": 2166.93,
"lwprc": 2159.8,
"accTrdvol": 441640,
"accTrdval": 4479971,
"cmpprevddPrc": -4.41
},
{
"BzDd": 20170330,
"trdPrc": 2164.64,
"cmpprevddTpCd": "5",
"opnprc": 2170.18,
"hgprc": 2174.16,
"lwprc": 2159.16,
"accTrdvol": 643563,
"accTrdval": 4574158,
"cmpprevddPrc": -2.34
}
]
}
}
Response Parameters
Request Example
curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/index/kospi/K1/history?trnsmCycleTpCd=D&inqStrtDd=20181001&inqEndDd=20181231&reqCnt=20'
Response Example
{
"jsonrpc": "2.0",
"result":
{
"isuSrtCd": "K1",
"hisLists": [
{
"BzDd": 20181228,
"trdPrc": 2040.19,
"cmpprevddTpCd": "2",
"opnprc": 2036.7,
"hgprc": 2044.03,
"lwprc": 2035.41,
"accTrdvol": 117954,
"accTrdval": 1105573,
"cmpprevddPrc": 11.75
},
{
"BzDd": 20181227,
"trdPrc": 2028.44,
"cmpprevddTpCd": "2",
"opnprc": 2032.09,
"hgprc": 2035.57,
"lwprc": 2021.39,
"accTrdvol": 398021,
"accTrdval": 5351003,
"cmpprevddPrc": 0.43
},
{
"BzDd": 20181226,
"trdPrc": 2028.01,
"cmpprevddTpCd": "5",
"opnprc": 2028.81,
"hgprc": 2037.83,
"lwprc": 2014.28,
"accTrdvol": 321499,
"accTrdval": 5424078,
"cmpprevddPrc": -27
},
{
"BzDd": 20181224,
"trdPrc": 1945.91,
"cmpprevddTpCd": "5",
"opnprc": 2057.35,
"hgprc": 2057.35,
"lwprc": 1878.85,
"accTrdvol": 346,
"accTrdval": 5788,
"cmpprevddPrc": -115.58
},
{
"BzDd": 20181221,
"trdPrc": 2213.93,
"cmpprevddTpCd": "2",
"opnprc": 2064.6,
"hgprc": 2222.62,
"lwprc": 2064.6,
"accTrdvol": 774,
"accTrdval": 20216,
"cmpprevddPrc": 153.81
},
{
"BzDd": 20181220,
"trdPrc": 2048.37,
"cmpprevddTpCd": "5",
"opnprc": 2063.7,
"hgprc": 2170.26,
"lwprc": 2047.52,
"accTrdvol": 1228,
"accTrdval": 28627,
"cmpprevddPrc": -30.47
},
{
"BzDd": 20181219,
"trdPrc": 2078.84,
"cmpprevddTpCd": "2",
"opnprc": 2068.95,
"hgprc": 2080.65,
"lwprc": 2063.01,
"accTrdvol": 418796,
"accTrdval": 5124894,
"cmpprevddPrc": 16.73
},
{
"BzDd": 20181218,
"trdPrc": 2062.11,
"cmpprevddTpCd": "5",
"opnprc": 2057.39,
"hgprc": 2074.31,
"lwprc": 2054.26,
"accTrdvol": 429530,
"accTrdval": 5241610,
"cmpprevddPrc": -8.98
},
{
"BzDd": 20181217,
"trdPrc": 2071.09,
"cmpprevddTpCd": "2",
"opnprc": 2071.21,
"hgprc": 2075.93,
"lwprc": 2065.51,
"accTrdvol": 444522,
"accTrdval": 4764477,
"cmpprevddPrc": 1.71
},
{
"BzDd": 20181214,
"trdPrc": 2069.38,
"cmpprevddTpCd": "5",
"opnprc": 2097.3,
"hgprc": 2188.68,
"lwprc": 1972.65,
"accTrdvol": 448237,
"accTrdval": 5784241,
"cmpprevddPrc": -26.17
},
{
"BzDd": 20181213,
"trdPrc": 2243.58,
"cmpprevddTpCd": "2",
"opnprc": 2054.69,
"hgprc": 2243.58,
"lwprc": 2007.04,
"accTrdvol": 250,
"accTrdval": 6351,
"cmpprevddPrc": 161.01
},
{
"BzDd": 20181212,
"trdPrc": 2052.64,
"cmpprevddTpCd": "5",
"opnprc": 2132.14,
"hgprc": 2229.67,
"lwprc": 1984.03,
"accTrdvol": 874,
"accTrdval": 29458,
"cmpprevddPrc": -0.33
},
{
"BzDd": 20181211,
"trdPrc": 2134.77,
"cmpprevddTpCd": "2",
"opnprc": 2076.28,
"hgprc": 2134.92,
"lwprc": 2012.37,
"accTrdvol": 764,
"accTrdval": 31708,
"cmpprevddPrc": 80.98
},
{
"BzDd": 20181210,
"trdPrc": 2027.49,
"cmpprevddTpCd": "5",
"opnprc": 2048.45,
"hgprc": 2061.78,
"lwprc": 1845.79,
"accTrdvol": 246,
"accTrdval": 12553,
"cmpprevddPrc": -48.27
},
{
"BzDd": 20181207,
"trdPrc": 1705.57,
"cmpprevddTpCd": "5",
"opnprc": 2081.68,
"hgprc": 2086.84,
"lwprc": 1704.32,
"accTrdvol": 1762,
"accTrdval": 57237,
"cmpprevddPrc": -363.12
},
{
"BzDd": 20181206,
"trdPrc": 2068.69,
"cmpprevddTpCd": "5",
"opnprc": 2094.62,
"hgprc": 2094.62,
"lwprc": 2064,
"accTrdvol": 537409,
"accTrdval": 5606457,
"cmpprevddPrc": -32.62
},
{
"BzDd": 20181205,
"trdPrc": 2101.31,
"cmpprevddTpCd": "5",
"opnprc": 2086.57,
"hgprc": 2107.69,
"lwprc": 2086.57,
"accTrdvol": 492716,
"accTrdval": 4802792,
"cmpprevddPrc": -13.04
},
{
"BzDd": 20181204,
"trdPrc": 2114.35,
"cmpprevddTpCd": "5",
"opnprc": 2125.67,
"hgprc": 2128.94,
"lwprc": 2105.45,
"accTrdvol": 507517,
"accTrdval": 5539552,
"cmpprevddPrc": -17.58
},
{
"BzDd": 20181203,
"trdPrc": 2131.93,
"cmpprevddTpCd": "2",
"opnprc": 2127.78,
"hgprc": 2136.64,
"lwprc": 2113.6,
"accTrdvol": 436588,
"accTrdval": 5571246,
"cmpprevddPrc": 35.07
},
{
"BzDd": 20181130,
"trdPrc": 2096.86,
"cmpprevddTpCd": "5",
"opnprc": 2116.83,
"hgprc": 2122.33,
"lwprc": 2093.83,
"accTrdvol": 427354,
"accTrdval": 7316750,
"cmpprevddPrc": -17.24
}
]
}
}
