금융위원회_주식대차정보

주식대차정보는 주식대차 거래 종목별 순위, 업종별·참여자별 현황, 거래 주체별 대차잔고 비교 등 다양한 통계 정보를 제공하는 데이터입니다.주요 항목으로는 종목별 대차 상위 순위, 종목별 및 업종별 거래현황, 월별 대차규모, 내외국인별 잔고 및 거래량 통계 등이 포함됩니다.<데이터 조회 시 유의사항>파라미터 없이 조회 시 데이터 조회 시간이 오래걸려 timeout이 발생하게 되어 필수 파라미터를 지정하였습니다.- 파라미터 조건 : 조회 시 아래의 필수 파라미터 중 최소 1개 이상을 반드시 입력해야 합니다.- 기본값 안내 : 필수 파라미터를 입력하지 않은 경우, 기준일자(basDt)는 자동으로 가장 최신 날짜로 설정되어 조회됩니다.[서비스별 필수 파라미터 목록]- 주식업종별참여현황조회 : basDt, isinCd- 주식대차종목순위조회, 주식종목별대차거래현황조회, 월별대차거래현황조회, 내외국인대차잔고비교조회, 내외국인대차거래량조회 : 없음이 데이터는 6개 오퍼레이션으로 구성되어 있습니다.각 오퍼레이션은 다음과 같습니다.① 주식대차종목순위 조회 : 대차거래 기준 상위 종목 순위 정보를 제공합니다.② 주식종목별대차거래현황 조회 : 특정 종목에 대한 일별 대차거래 규모 및 변동 현황을 조회합니다.③ 월별대차거래현황 조회 : 전체 시장 기준 월별 대차거래 실적 통계를 조회합니다.④ 주식업종별참여현황 조회 : 업종 단위로 대차거래 참여 현황 및 집중도 정보를 제공합니다.⑤ 내외국인대차잔고비교 조회 : 내국인과 외국인의 대차잔고 규모를 비교할 수 있습니다.⑥ 내외국인대차거래량 조회 : 내국인과 외국인의 거래량 및 증감 추이를 제공합니다.※ 데이터 갱신주기는 일 1회입니다.※ 금융위원회의 모든 API는 데이터 보유기관으로부터 데이터를 연계받아 수집 후 개방하고 있습니다.금융위원회에서 제공하는 모든 서비스는 실시간이 아니며, 데이터 갱신은 기준일자로부터 영업일 하루 뒤 오후 1시 이후에 업데이트됩니다.예를 들어, 금요일 데이터는 차주 월요일에 제공됩니다. (월요일이 공휴일인 경우, 다음 영업일에 제공됩니다)** 유의사항본 개방데이터는 공공누리 2유형임을 참고하시기 바랍니다.이용허락범위 제2유형 : 출처표시 + 상업적 이용금지해당 데이터를 상업적으로 활용하고자 하는 이용자는 데이터 원천 소유자인 한국예탁결제원과 사용 목적과 범위에 따른 정보이용계약이 필요합니다. 정보이용계약 또는 해당 정보에 관하여 궁금한 점이 있으시면 한국예탁결제원 증권정보부(연락처: portal@ksd.or.kr)로 이메일 문의 주시기 바랍니다.

body header item items 결과메세지 결과코드 국제 채권 식별 번호. 유가증권(채권)의 국제인증 고유번호 내국인에게 대여한 잔고 금액 내국인에게 차입한 잔고 금액 내국인의 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래 ) 체결 금액 내국인의 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래 ) 체결 주식 수량 대차 거래를 체결한 총 합계 금액 대차 거래를 체결한 총 합계 주식 수량 대차 증권이 주식인지 채권인지등을 구분하는 코드 채권인지등을 구분하는 코드의 명칭 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래) 거래에서 상환한 금액 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래) 거래에서 상환한 주식의 수량 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래) 거래후 남은 주식의 수량 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래) 거래후 잔액 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래) 체결 금액 대차(증권회사가 고객과의 신용거래에 필요로 하는 돈이나 주식을 증권금융회사가 대출하는 거래)를 체결한 주식의 수량 만기별 종목의 수 산업 주체들이 모든 산업활동을 그 성질에 따라 유형화하고 이를 부호화한 코드 산업 주체들이 모든 산업활동을 그 성질에 따라 유형화한 분류 이름 상환 요청한 상환주식의 수량 상환한 주식의 수량 외국인과 체결한 대차 계약 금액 외국인과 체결한 대차 계약의 주식 수량 외국인에게 증권등을 대여한 잔고 금액 외국인의 대여잔고 비율 외국인이 차입한 찬고 금액 유가증권 국제인증 고유번호 코드 이름 작업 또는 거래의 기준이 되는 일자(년월일) 전체 결과 수 주식을 차입한 경우 그 차입 비율 차입 후 잔액 주식의 대여 비율 주식의 대여 후 잔액 차입잔액 기준 외국인 차입의 비율 페이지번호 한 페이지 결과 수

주소는 예시입니다 — 이 API의 실제 호출 주소는 공공데이터포털이 로그인 뒤에만 공개해서 자동으로 가져올 수 없습니다. 파라미터 이름은 확실하니, 주소만 원문 활용가이드에서 확인해 채우십시오.

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode '결과형식(xml/json)=json' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '산업 주체들이 모든 산업활동을 그 성질에 따라 유형화한 분류 이름=값' \
  --data-urlencode '유가증권 국제인증 고유번호 코드 이름=11110' \
  --data-urlencode '작업 또는 거래의 기준이 되는 일자(년월일)=01' \
  --data-urlencode '페이지 번호=1'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "결과형식(xml/json)": "json",
  "공공데이터포털에서 받은 인증키": "값",
  "산업 주체들이 모든 산업활동을 그 성질에 따라 유형화한 분류 이름": "값",
  "유가증권 국제인증 고유번호 코드 이름": "11110",
  "작업 또는 거래의 기준이 되는 일자(년월일)": "01",
  "페이지 번호": "1",
});

const res = await fetch(`https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}?${params}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

import requests

params = {
    "serviceKey": "발급받은_인증키",
    "결과형식(xml/json)": "json",
    "공공데이터포털에서 받은 인증키": "값",
    "산업 주체들이 모든 산업활동을 그 성질에 따라 유형화한 분류 이름": "값",
    "유가증권 국제인증 고유번호 코드 이름": "11110",
    "작업 또는 거래의 기준이 되는 일자(년월일)": "01",
    "페이지 번호": "1",
}

r = requests.get("https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}", params=params, timeout=15)
r.raise_for_status()
print(r.json())