# 시세 서비스 v3 (라이센스별)

## 시세 서비스 이용 안내

샌드박스 환경에서 제공되는 시세 데이터는 개발 지원용으로만 제공되므로 데이터 정합성이 맞지 않을 수 있습니다. 

코스콤에서 제공되는 실시간 제공 시세와 자료가 상이할 수 있으며, 제공되는 서비스는 시스템 점검등으로 별도 고지 없이 중단될 수 있습니다. 

개발 지원용 시세 데이터라 할지라도 데이터의 가공 또는 축적을 위해서는 코스콤의 정보시세 라이센스가 필요한 것으로써 계약이 수반되어야 시세 데이터의 가공 또는 축적이 가능합니다.

오픈API플랫폼 '정보시세 라이센스' 관련 문의는 코스콤 시장데이터영업팀 (E : <fintechdata@koscom.co.kr>, T : 02-767-7583)에게 문의 하시면 신속하게 답변 드리겠습니다.&#x20;

자세한 안내는 아래 링크를 참조하세요.

{% content-ref url="/pages/-LTMFJfpx26cNXb6r\_FX" %}
[이용 대상 및 수수료 안내](/open-api/how-to-use/procedure/charge.md)
{% endcontent-ref %}

## Open API 시세 데이터 정보

다양한 금융시장정보의 실시간 및  과거데이터를 이용하기 편한 **Restful API** 서비스로 제공

자세한 설명은 아래 문서를 참조 하세요.

{% file src="/files/Yo9k5dYZOB7sepTQLAzL" %}

## API  URI

<table data-header-hidden><thead><tr><th width="150">대분류</th><th width="150">구분</th><th width="150">Name</th><th>URI</th></tr></thead><tbody><tr><td><strong>대분</strong></td><td><strong>시세 라이센스 구분</strong></td><td><strong>API Name</strong></td><td><strong>API URI</strong></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 종목 리스트</td><td><code>/v3/market/closed/kospi/lists</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 종목 마스터</td><td><code>/v3/market/closed/kospi/{issuecode}/master</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 종목 마스터(요구형)</td><td><code>/v3/market/closed/kospi/{issuecode}/selectivemaster</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 종목 종가</td><td><code>/v3/market/closed/kospi/{issuecode}/closeprice</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI지수</td><td><code>/v3/market/closed/kospi/index</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 공매도 일별조회</td><td><code>/v3/market/closed/kospi/{issucode}/shortsell</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 외국인 보유율 히스토리</td><td><code>/v3/market/closed/kospi/{issucode}/foreignhistory</code></td></tr><tr><td>주식</td><td>주식실시간종가A</td><td>KOSPI 주식 종목 히스토리</td><td><code>/v3/market/closed/kospi/{issuecode}/history</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 종목 리스트</td><td><code>/v3/market/closed/kosdaq/lists</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>
KOSDAQ 주식 종목 마스터</td><td><code>/v3/market/closed/kosdaq/{issuecode}/master</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 종목 마스터 (요구형)</td><td><code>/v3/market/closed/kosdaq/{issuecode}/selectivemaster</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 종목 종가</td><td><code>/v3/market/closed/kosdaq/{issuecode}/closeprice</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 지수</td><td><code>/v3/market/closed/kosdaq/index</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 공매도 일별조회</td><td><code>/v3/market/closed/kosdaq/{issucode}/shortsell</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 외국인 보유율 히스토리</td><td><code>/v3/market/closed/kosdaq/{issucode}/foreignhistory</code></td></tr><tr><td>주식</td><td>주식실시간종가B</td><td>KOSDAQ 주식 종목 히스토리</td><td><code>/v3/market/closed/kosdaq/{issuecode}/history</code></td></tr><tr><td>주식</td><td>주식실시간종가C</td><td>주식종목(ETF) 장마감후 순자산가치</td><td><code>/v3/market/closed/etf/{marketcode}/{issuecode}/closenav</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 현재가 리스트</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/lists</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 시고저종 리스트</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/ohlclists</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 시장별 시간외단일가 시고저종 리스트</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/ahtohlclists</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 호가/잔량 리스트</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/quotelists</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 복수종목 현재가</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/price</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>(시세표)KOSPI 주식 복수종목 호가잔량</td><td><code>/v3/market/realtime/kospi/multiquote/stocks/orderbook</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>KOSPI 주식 종목 체결</td><td><code>/v3/market/realtime/kospi/stocks/{issuecode}/price</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>KOSPI 주식 종목 호가잔량(LP호가제외)</td><td><code>/v3/market/realtime/kospi/stocks/{issuecode}/orderbook</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>KOSPI 주식 종목 일중</td><td><code>/v3/market/realtime/kospi/stocks/{issuecode}/intraday</code></td></tr><tr><td>주식</td><td>주식실시간A</td><td>KOSPI 주식 거래상위 회원사 정보</td><td><code>/v3/market/realtime/kospi/stocks/{issuecode}/traderanking</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식 현재가 리스트</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/lists</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식 시고저종 리스트</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/ohlclists</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식시간외단일가 시고저종 리스트</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/ahtohlclists</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식 호가/잔량 리스트</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/quotelists</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식 복수종목 현재가</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/price</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>(시세표)KOSDAQ주식 복수종목 호가잔량</td><td><code>/v3/market/realtime/kosdaq/multiquote/stocks/orderbook</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>KOSDAQ주식 종목 체결</td><td><code>/v3/market/realtime/kosdaq/{issuecode}/price</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>KOSDAQ주식 종목 호가잔량(LP호가제외)</td><td><code>/v3/market/realtime/kosdaq/{issuecode}/orderbook</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>KOSDAQ주식 종목 일중</td><td><code>/v3/market/realtime/kosdaq/{issuecode}/intraday</code></td></tr><tr><td>주식</td><td>주식실시간B</td><td>KOSDAQ주식 거래상위 회원사 정보</td><td><code>/v3/market/realtime/kosdaq/{issuecode}/traderanking</code></td></tr><tr><td>기타</td><td>유가종목별투자자</td><td>KOSPI 주식 종목별 투자자별 매매동향 (종가)</td><td><code>/v3/market/investors/kospi/{issucode}/investors</code></td></tr><tr><td>기타</td><td>유가종목별투자자</td><td>KOSPI지수 투자자 마감정보</td><td><code>/v3/market/investors/kospi/investors</code></td></tr><tr><td>기타</td><td>코스닥종목별투자자</td><td>KOSDAQ주식 종목별 투자자별 매매동향 (종가)</td><td><code>/v3/market/investors/kosdaq/{issuecode}/investors</code></td></tr><tr><td>기타</td><td>코스닥종목별투자자</td><td>KOSDAQ지수 투자자 마감정보</td><td><code>/v3/market/investors/kosdaq/investors</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 선물 종목 리스트</td><td><code>/v3/market/closed/derivative/futures/{marketcode}/lists</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 선물 종목 마스터</td><td><code>/v3/market/closed/derivative/futures/{marketcode}/l{issucode}/master</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 선물 종목 종가</td><td><code>/v3/market/closed/derivative/futures/{marketcode}/{issucode}/closeprice</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 선물 종목 히스토리</td><td><code>/v3/market/closed/derivative/futures/{marketcode}/{issucode}/history</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 옵션 종목 리스트</td><td><code>/v3/market/closed/derivative/options/{marketcode}/lists</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 옵션 종목 마스터</td><td><code>/v3/market/closed/derivative/options/{marketcode}/{issucode}/master</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 옵션 종목 종가</td><td><code>/v3/market/closed/derivative/options/{marketcode}/{issucode}/closeprice</code></td></tr><tr><td>파생</td><td>파생실시간종가A</td><td>상품/지수 옵션 종목 히스토리</td><td><code>/v3/market/closed/derivative/options/{marketcode}/{issucode}/history</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 선물_체결</td><td><code>/v3/market/realtime/derivative/futures/{marketcode}/{issuecode}/price</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 선물_우선호가</td><td><code>/v3/market/realtime/derivative/futures/{marketcode}/{issuecode}/orderbook</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 선물 투자자별 매매동향</td><td><code>/v3/market/realtime/derivative/futures/{marketcode}/market/investors</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 선물 일중</td><td><code>/v3/market/realtime/derivative/futures/{marketcode}/{issuecode}/intraday</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 옵션_체결</td><td><code>/v3/market/realtime/derivative/options/{marketcode}/{issuecode}/price</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 옵션_우선호가</td><td><code>/v3/market/realtime/derivative/options/{marketcode}/{issuecode}/oederbook</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 옵션 투자자별 매매동향</td><td><code>/v3/market/realtime/derivative/options/{marketcode}/market/investors</code></td></tr><tr><td>파생</td><td>파생실시간A</td><td>상품/지수 옵션 일중</td><td><code>/v3/market/realtime/derivative/options/{marketcode}/{issuecode}/intraday</code></td></tr><tr><td>업종</td><td>KRX업종실시간종가</td><td>업종 종가</td><td><code>/v3/market/closed/index/{marketcode}/{issuecode}/closeindex</code></td></tr><tr><td>업종</td><td>KRX업종실시간종가</td><td>업종 히스토리</td><td><code>/v3/market/closed/index/{marketcode}/{issuecode}/history</code></td></tr><tr><td>업종</td><td>KRX업종 실시간</td><td>업종 시가총액</td><td><code>/v3/market/realtime/index/{marketcode}/{issucode}/marketcap</code></td></tr><tr><td>업종</td><td>KRX업종 실시간</td><td>업종 예상지수</td><td><code>/v3/market/realtime/index/{marketcode}/{issucode}/prospectindex</code></td></tr><tr><td>업종</td><td>KRX업종 실시간</td><td>업종 일중</td><td><code>/v3/market/realtime/index/{marketcode}/{issucode}/intraday</code></td></tr><tr><td>업종</td><td>KRX업종 실시간</td><td>업종 지수</td><td><code>/v3/market/realtime/index/{marketcode}/{issucode}/index</code></td></tr><tr><td>업종</td><td>KRX업종 실시간</td><td>업종 투자자별 매매동향</td><td><code>/v3/market/realtime/index/{marketcode}/{issucode}/investors</code></td></tr></tbody></table>

##


---

# 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.md?ask=<question>
```

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.