코스콤 오픈API플랫폼
  • 코스콤 오픈API플랫폼
  • 이용절차 안내
    • 오픈API플랫폼 이용절차
      • 이용 대상 및 수수료 안내
    • API 테스트 절차
  • API 서비스
    • 시세 서비스 v2 (종료)
      • 주식 시세
        • 요구형항목
      • 선물 시세
      • 옵션 시세
      • 업종 지수
      • 주식 시세표
      • 코드표(시세)
    • 시세 서비스 v3 (라이센스별)
      • 주식
        • 주식실시간종가A
        • 주식실시간종가B
        • KONEX종가
        • 주식실시간A
        • 주식실시간B
      • 파생
        • 파생실시간종가A
        • 파생실시간A
      • 업종
        • KRX업종실시간종가
        • KRX업종실시간
      • 기타
        • 유가종목별투자자
        • 코스닥종목별투자자
        • 부가서비스 (2024년 6월30일 종료)
      • 코드표(시세)
    • 재무정보 서비스
      • NICE-기업정보
  • Error Code
  • Rate Limiting
  • FAQ
    • 오픈API플랫폼
    • API 사용절차
    • 시세 서비스
  • 문의사항
  • 개정내역
Powered by GitBook
On this page
  • Syntax
  • 현재가 시세표
  • /v2/market/multiquote/stocks/{marketcode}/lists
  • Request Example
  • Response Example
  • 시고저종 시세표
  • /v2/market/multiquote/stocks/{marketcode}/ohlclists
  • Request Example
  • Response Example
  • 복수종목 현재가 시세표 API
  • /v2/market/multiquote/stocks/{marketcode}/price
  • Request Example
  • Response Example
  • 복수종목 호가잔량 시세표 API
  • /v2/market/list/{marketcode}/orderbook
  • Request Example
  • Response Example
  1. API 서비스
  2. 시세 서비스 v2 (종료)

주식 시세표

시세라이센스 정책에 따라 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)

{
   "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)

{
   "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

{
   "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

{
   "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" 
      } 
    ] 
  } 
}
Previous업종 지수Next코드표(시세)

Last updated 3 years ago