주식 시세표

시세라이센스 정책에 따라 API v3으로 업데이트되었으니 참고해주시길 바랍니다.

개별 종목기준 현재가 조회 대비 조회 빈도를 줄일수 있는 방식의 조회로 시장기준/복수종목기준 방식을 제공

Syntax

HTTP methods | GET

Authentication | API Key

별도의 시세표 라이센스 필요

현재가 시세표

API

시장기준으로 1회 조회 요청 시 전종목의 현재가(1초주기)를 리스트 형식으로 제공

현재가 | 현재가, 누적거래량, 누적거래대금 제공시장 | 유가증권, 코스닥시장

/v2/market/multiquote/stocks/{marketcode}/lists

GET https://{APIGWAddr}/v2/market/multiquote/stocks/{marketcode}/lists

Path Parameters

Name	Type	Description
marketcode	string	시장구분(kospi | kosdaq)

200

{
   "trdDd": "20180508",
   "trdTm": "134447",
   "isuLists": [ 
    {
       "isuSrtCd": "000020",
       "trdPrc": 11250,
       "accTrdvol": 55286,
       "accTrdval": 625032300 
    },
    {
       "isuSrtCd": "000030",
       "trdPrc": 15450,
       "accTrdvol": 769087,
       "accTrdval": 11899058650 
    },
       ...이하 생략...
    ]
 }

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/multiquote/stocks/kospi/lists'

Response Example

{
   "trdDd": "20181228",
   "trdTm": "104933",
   "isuLists": [ 
    {
       "isuSrtCd": "000020",
       "trdPrc": 9120,
       "accTrdvol": 7772,
       "accTrdval": 70890330 
    },

    {
       "isuSrtCd": "000030",
       "trdPrc": 15750,
       "accTrdvol": 234925,
       "accTrdval": 3700559100 
    },

    {
       "isuSrtCd": "000040",
       "trdPrc": 498,
       "accTrdvol": 73493,
       "accTrdval": 36459950 
    },

    {
       "isuSrtCd": "000050",
       "trdPrc": 10900,
       "accTrdvol": 161,
       "accTrdval": 1756450 
    },

    {
       "isuSrtCd": "000060",
       "trdPrc": 21550,
       "accTrdvol": 20064,
       "accTrdval": 432862000 
    },
    .
    .
    .
    {
       "isuSrtCd": "590012",
       "trdPrc": 9560,
       "accTrdvol": 0,
       "accTrdval": 0 
    },

    {
       "isuSrtCd": "900140",
       "trdPrc": 2320,
       "accTrdvol": 53976,
       "accTrdval": 123595365 
    } 
  ] 
}

시고저종 시세표

API

시장기준으로 1회 조회 요청 시 시고저종을 리스트 형식으로 제공

시고저종 | 시가, 고가, 저가, 종가(현재가) 제공시장 | 유가증권, 코스닥시장

/v2/market/multiquote/stocks/{marketcode}/ohlclists

GET https://{APIGWAddr}/v2/market/multiquote/stocks/{marketcode}/ohlclists

Path Parameters

Name	Type	Description
marketcode	string	시장구분(kospi | kosdaq)

200

{
   "trdDd": "20180508",
   "trdTm": "134932",
   "isuLists": [ 
    {
       "isuSrtCd": "000020",
       "opnprc": 11550,
       "hgprc": 11550,
       "lwprc": 11200,
       "trdPrc": 11200 
    },

    {
       "isuSrtCd": "000030",
       "opnprc": 15350,
       "hgprc": 15600,
       "lwprc": 15350,
       "trdPrc": 15450 
    },
    ...이하 생략...
  ]
}

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/multiquote/stocks/kospi/ohlclists'

Response Example

{
   "trdDd": "20181228",
   "trdTm": "104933",
   "isuLists": [ 
    {
       "isuSrtCd": "000020",
       "opnprc": 9080,
       "hgprc": 9170,
       "lwprc": 9030,
       "trdPrc": 9120 
    },

    {
       "isuSrtCd": "000030",
       "opnprc": 15700,
       "hgprc": 15850,
       "lwprc": 15600,
       "trdPrc": 15750 
    },

    {
       "isuSrtCd": "000040",
       "opnprc": 501,
       "hgprc": 502,
       "lwprc": 490,
       "trdPrc": 498 
    },

    {
       "isuSrtCd": "000050",
       "opnprc": 10900,
       "hgprc": 10950,
       "lwprc": 10900,
       "trdPrc": 10900 
    },

    {
       "isuSrtCd": "000060",
       "opnprc": 21250,
       "hgprc": 21700,
       "lwprc": 21250,
       "trdPrc": 21550 
    },

    {
       "isuSrtCd": "000070",
       "opnprc": 77400,
       "hgprc": 79100,
       "lwprc": 77400,
       "trdPrc": 78100 
    },

    {
       "isuSrtCd": "000075",
       "opnprc": 47200,
       "hgprc": 47450,
       "lwprc": 47200,
       "trdPrc": 47450 
    },

    {
       "isuSrtCd": "000080",
       "opnprc": 16950,
       "hgprc": 16950,
       "lwprc": 16600,
       "trdPrc": 16600 
    },
    .
    .
    .
    {
       "isuSrtCd": "590012",
       "opnprc": 0,
       "hgprc": 0,
       "lwprc": 0,
       "trdPrc": 9560 
    },

    {
       "isuSrtCd": "900140",
       "opnprc": 2300,
       "hgprc": 2345,
       "lwprc": 2220,
       "trdPrc": 2320 
    } 
  ] 
}

복수종목 현재가 시세표 API

현재가 실시간조회를 최대 20개의 임의의 종목에 대해 일괄적으로 조회

복수종목 리스트간 구분자는 쉼표(,) 임

제공시장 | 유가증권 , 코스닥 시장

/v2/market/multiquote/stocks/{marketcode}/price

GET https://{APIGWAddr}/v2/market/multiquote/stocks/{marketcode}/price

Path Parameters

Name	Type	Description
marketcode	string	시장구분(kospi | kosdaq)

Query Parameters

Name	Type	Description
isuCd	string	종목코드 ex) 005930,000660

200

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isulist": [ 
      {
         "trdPrc": 52700,
         "cmpprevddTpCd": "2",
         "opnprc": 52600,
         "hgprc": 53200,
         "lwprc": 51900,
         "accTrdvol": 17128652,
         "trdTm": 13352600,
         "trdvol": 100,
         "accTrdval": 904326766200,
         "cmpprevddPrc": 800,
         "isuSrtCd": "005930",
         "bidordPrc_1": 52700,
         "askordPrc_1": 52800,
         "lstAskbidTpCd": 1 
      },

      {
         "trdPrc": 84200,
         "cmpprevddTpCd": "2",
         "opnprc": 84500,
         "hgprc": 85300,
         "lwprc": 84200,
         "accTrdvol": 2127450,
         "trdTm": 13352800,
         "trdvol": 6,
         "accTrdval": 180271767300,
         "cmpprevddPrc": 1200,
         "isuSrtCd": "000660",
         "bidordPrc_1": 84200,
         "askordPrc_1": 84300,
         "lstAskbidTpCd": 1 
      } 
    ] 
  } 
}

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/multiquote/stocks/kospi/price?isuCd=005930%2C000660'

Response Example

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isulist": [ 
      {
         "trdPrc": 38700,
         "cmpprevddTpCd": "2",
         "opnprc": 38250,
         "hgprc": 38900,
         "lwprc": 38200,
         "accTrdvol": 4832473,
         "trdTm": 13204100,
         "trdvol": 12,
         "accTrdval": 186363258400,
         "cmpprevddPrc": 450,
         "isuSrtCd": "005930",
         "bidordPrc_1": 38650,
         "askordPrc_1": 38700,
         "lstAskbidTpCd": 2 
      },

      {
         "trdPrc": 60900,
         "cmpprevddTpCd": "5",
         "opnprc": 61700,
         "hgprc": 62300,
         "lwprc": 60700,
         "accTrdvol": 851506,
         "trdTm": 13204200,
         "trdvol": 5,
         "accTrdval": 52243877100,
         "cmpprevddPrc": -700,
         "isuSrtCd": "000660",
         "bidordPrc_1": 60900,
         "askordPrc_1": 61000,
         "lstAskbidTpCd": 1 
      } 
    ] 
  } 
}

복수종목 호가잔량 시세표 API

호가잔량 실시간조회를 최대 20개의 임의의 종목에 대해 일괄적으로 조회

복수종목 리스트간 구분자는 쉼표(,) 임

제공시장 | 유가증권 , 코스닥 시장

/v2/market/list/{marketcode}/orderbook

GET https://{APIGWAddr}/v2/market/multiquote/stocks/{marketcode}/orderbook

Path Parameters

Name	Type	Description
marketcode	string	시장구분(kospi | kosdaq)

Query Parameters

Name	Type	Description
isuCd	string	종목코드 ex) 005930,000660

200

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isulist": [ 
      {
         "askStep1BstordPrc": 52900,
         "askStep2BstordPrc": 53000,
         "askStep3BstordPrc": 53100,
         "askStep4BstordPrc": 53200,
         "askStep5BstordPrc": 53300,
         "askStep6BstordPrc": 53400,
         "askStep7BstordPrc": 53500,
         "askStep8BstordPrc": 53600,
         "askStep9BstordPrc": 53700,
         "askStep10BstordPrc": 53800,
         "askStep1BstordRqty": 139074,
         "askStep2BstordRqty": 281770,
         "askStep3BstordRqty": 212990,
         "askStep5BstordRqty": 184279,
         "askStep6BstordRqty": 193079,
         "askStep7BstordRqty": 345397,
         "askStep8BstordRqty": 105715,
         "askStep9BstordRqty": 120527,
         "askStep10BstordRqty": 185815,
         "bidStep1BstordPrc": 52800,
         "bidStep2BstordPrc": 52700,
         "bidStep3BstordPrc": 52600,
         "bidStep4BstordPrc": 52500,
         "bidStep5BstordPrc": 52400,
         "bidStep6BstordPrc": 52300,
         "bidStep7BstordPrc": 52200,
         "bidStep8BstordPrc": 52100,
         "bidStep9BstordPrc": 52000,
         "bidStep10BstordPrc": 51900,
         "bidStep1BstordRqty": 62413,
         "bidStep2BstordRqty": 111228,
         "bidStep3BstordRqty": 146574,
         "bidStep4BstordRqty": 218182,
         "bidStep5BstordRqty": 62703,
         "bidStep6BstordRqty": 66254,
         "bidStep7BstordRqty": 62890,
         "bidStep8BstordRqty": 104846,
         "bidStep9BstordRqty": 262768,
         "bidStep10BstordRqty": 105522,
         "askordTotRqty": 2046762,
         "bidordTotRqty": 1203380,
         "pstoffhrAskTotOrdRqty": 0,
         "pstoffhrBidTotOrdRqty": 0,
         "accTrdvol": 17218791,
         "deemTrdPrc": 52600,
         "deemTrdvol": 439,
         "deemAccTrdvol": 2122875,
         "isuSrtCd": "005930" 
      },

      {
         "askStep1BstordPrc": 84300,
         "askStep2BstordPrc": 84400,
         "askStep3BstordPrc": 84500,
         "askStep4BstordPrc": 84600,
         "askStep5BstordPrc": 84700,
         "askStep6BstordPrc": 84800,
         "askStep7BstordPrc": 84900,
         "askStep8BstordPrc": 85000,
         "askStep9BstordPrc": 85100,
         "askStep10BstordPrc": 85200,
         "askStep1BstordRqty": 931,
         "askStep2BstordRqty": 7927,
         "askStep3BstordRqty": 10981,
         "askStep5BstordRqty": 16667,
         "askStep6BstordRqty": 18654,
         "askStep7BstordRqty": 18917,
         "askStep8BstordRqty": 49922,
         "askStep9BstordRqty": 21772,
         "askStep10BstordRqty": 31247,
         "bidStep1BstordPrc": 84200,
         "bidStep2BstordPrc": 84100,
         "bidStep3BstordPrc": 84000,
         "bidStep4BstordPrc": 83900,
         "bidStep5BstordPrc": 83800,
         "bidStep6BstordPrc": 83700,
         "bidStep7BstordPrc": 83600,
         "bidStep8BstordPrc": 83500,
         "bidStep9BstordPrc": 83400,
         "bidStep10BstordPrc": 83300,
         "bidStep1BstordRqty": 9106,
         "bidStep2BstordRqty": 10650,
         "bidStep3BstordRqty": 13948,
         "bidStep4BstordRqty": 5696,
         "bidStep5BstordRqty": 6064,
         "bidStep6BstordRqty": 4824,
         "bidStep7BstordRqty": 3514,
         "bidStep8BstordRqty": 9080,
         "bidStep9BstordRqty": 3684,
         "bidStep10BstordRqty": 11752,
         "askordTotRqty": 185835,
         "bidordTotRqty": 78318,
         "pstoffhrAskTotOrdRqty": 0,
         "pstoffhrBidTotOrdRqty": 0,
         "accTrdvol": 2141561,
         "deemTrdPrc": 84500,
         "deemTrdvol": 0,
         "deemAccTrdvol": 164843,
         "isuSrtCd": "000660" 
      } 
    ] 
  } 
}

Request Example

curl --include --header "apikey:l7xx230ef2235e3xxxxxc982eb192ac98e206" \
--request GET \
'https://sandbox-apigw.koscom.co.kr/v2/market/multiquote/stocks/kospi/orderbook?isuCd=005930%2C000660'

Response Example

{
   "jsonrpc": "2.0",
   "result": 
  {
     "isulist": [ 
      {
         "askStep1BstordPrc": 38700,
         "askStep2BstordPrc": 38750,
         "askStep3BstordPrc": 38800,
         "askStep4BstordPrc": 38850,
         "askStep5BstordPrc": 38900,
         "askStep6BstordPrc": 38950,
         "askStep7BstordPrc": 39000,
         "askStep8BstordPrc": 39050,
         "askStep9BstordPrc": 39100,
         "askStep10BstordPrc": 39150,
         "askStep1BstordRqty": 96122,
         "askStep2BstordRqty": 80144,
         "askStep3BstordRqty": 68251,
         "askStep5BstordRqty": 89290,
         "askStep6BstordRqty": 89215,
         "askStep7BstordRqty": 116096,
         "askStep8BstordRqty": 30689,
         "askStep9BstordRqty": 47757,
         "askStep10BstordRqty": 25056,
         "bidStep1BstordPrc": 38650,
         "bidStep2BstordPrc": 38600,
         "bidStep3BstordPrc": 38550,
         "bidStep4BstordPrc": 38500,
         "bidStep5BstordPrc": 38450,
         "bidStep6BstordPrc": 38400,
         "bidStep7BstordPrc": 38350,
         "bidStep8BstordPrc": 38300,
         "bidStep9BstordPrc": 38250,
         "bidStep10BstordPrc": 38200,
         "bidStep1BstordRqty": 81614,
         "bidStep2BstordRqty": 106757,
         "bidStep3BstordRqty": 154892,
         "bidStep4BstordRqty": 101430,
         "bidStep5BstordRqty": 22374,
         "bidStep6BstordRqty": 25337,
         "bidStep7BstordRqty": 26714,
         "bidStep8BstordRqty": 33877,
         "bidStep9BstordRqty": 53537,
         "bidStep10BstordRqty": 45602,
         "askordTotRqty": 741550,
         "bidordTotRqty": 652134,
         "pstoffhrAskTotOrdRqty": 0,
         "pstoffhrBidTotOrdRqty": 0,
         "accTrdvol": 4838392,
         "deemTrdPrc": 0,
         "deemTrdvol": 0,
         "deemAccTrdvol": 0,
         "isuSrtCd": "005930" 
      },

      {
         "askStep1BstordPrc": 61000,
         "askStep2BstordPrc": 61100,
         "askStep3BstordPrc": 61200,
         "askStep4BstordPrc": 61300,
         "askStep5BstordPrc": 61400,
         "askStep6BstordPrc": 61500,
         "askStep7BstordPrc": 61600,
         "askStep8BstordPrc": 61700,
         "askStep9BstordPrc": 61800,
         "askStep10BstordPrc": 61900,
         "askStep1BstordRqty": 3323,
         "askStep2BstordRqty": 6651,
         "askStep3BstordRqty": 3160,
         "askStep5BstordRqty": 4927,
         "askStep6BstordRqty": 4954,
         "askStep7BstordRqty": 6674,
         "askStep8BstordRqty": 5884,
         "askStep9BstordRqty": 5425,
         "askStep10BstordRqty": 10439,
         "bidStep1BstordPrc": 60900,
         "bidStep2BstordPrc": 60800,
         "bidStep3BstordPrc": 60700,
         "bidStep4BstordPrc": 60600,
         "bidStep5BstordPrc": 60500,
         "bidStep6BstordPrc": 60400,
         "bidStep7BstordPrc": 60300,
         "bidStep8BstordPrc": 60200,
         "bidStep9BstordPrc": 60100,
         "bidStep10BstordPrc": 60000,
         "bidStep1BstordRqty": 19634,
         "bidStep2BstordRqty": 28282,
         "bidStep3BstordRqty": 12107,
         "bidStep4BstordRqty": 14040,
         "bidStep5BstordRqty": 12636,
         "bidStep6BstordRqty": 4186,
         "bidStep7BstordRqty": 6312,
         "bidStep8BstordRqty": 17335,
         "bidStep9BstordRqty": 8252,
         "bidStep10BstordRqty": 7738,
         "askordTotRqty": 56220,
         "bidordTotRqty": 130522,
         "pstoffhrAskTotOrdRqty": 0,
         "pstoffhrBidTotOrdRqty": 0,
         "accTrdvol": 852333,
         "deemTrdPrc": 0,
         "deemTrdvol": 0,
         "deemAccTrdvol": 0,
         "isuSrtCd": "000660" 
      } 
    ] 
  } 
}