한국예탁결제원_국제거래정보서비스_GW

본 API 서비스는 국제에서 거래되는 종목들의 거래 정보를 확인할 수 있는 서비스입니다. 구체적으로 종목별 전환 가능 주식수, DR의 월별 전환 및 해지 현황 정보를 조회할 수 있습니다. 그리고 국가코드도 조회가 가능하며, DR 전환가능 대상 종목 또한 조회 가능합니다. 추가로 연도별 미국주식 결제처리 현황을 조회할 수 있습니다. DR의 월별 전환/해지 현황 정보는 조회 기준 연월과 DR전환건수, DR전환주수(원주), DR해지건수, DR해지주수(원주)를 알 수 있습니다. 국가코드 조회시, 한글 국가명과 영문 국가명을 결과 값으로 받을 수 있습니다. DR 전환 가능대상 종목 조회시, DR 전환 비율과 총 원주수, DR 종목코드, 발행회사명을 알 수 있습니다. 연도별 미국주식 결제처리 현황 조회에서는 미국시장 매수 및 매도 결제건수를 결과 값으로 받아보실 수 있습니다.

body header DR Ticker DR 구분(1: ADR 2: GDR 3: PADR 4: JDR) DR 전환가능 총 원주수 DR 전환비율(원주:DR) DR 종목코드 DR구분명 DR전환건수 DR전환주수(원주) DR해지건수 DR해지주수(원주) item items 거래시장(기술문서 첨부파일 참조) 거래시장명 결과메세지 결과코드 국가명(예: 독일) 국가영문명(예: Germany) 국가코드(예: DE) 미국시장 매도결제건수 미국시장 매수결제건수 발행회사명 발행회사번호(기업정보서비스 참조 예: 594) 예탁기관 원주 대 DR비율 원주 종류(보통주 우선주 등) 원주종류 원주종목명(예:삼성전자) 원주종목코드(KR표준코드) 원주표준코드(주식정보서비스 참조) 전체 결과 수 조회기준연월(YYYYMM) 총DR전환가능한도 페이지 번호 한 페이지 결과 수 현재DR전환가능주식수(원주->DR)

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

curl -G 'https://apis.data.go.kr/{기관코드}/{서비스명}/{오퍼레이션}' \
  --data-urlencode 'serviceKey=발급받은_인증키' \
  --data-urlencode 'DR ISIN 코드=11110' \
  --data-urlencode '공공데이터포털에서 받은 인증키=값' \
  --data-urlencode '국가코드(미선택 시 데이터 전체 조회)=11110' \
  --data-urlencode '조회기준연도(YYYY)=2025' \
  --data-urlencode '조회기준연월(YYYYMM)=01' \
  --data-urlencode '조회시작연월(YYYYMM)=01'

const params = new URLSearchParams({
  "serviceKey": "발급받은_인증키",
  "DR ISIN 코드": "11110",
  "공공데이터포털에서 받은 인증키": "값",
  "국가코드(미선택 시 데이터 전체 조회)": "11110",
  "조회기준연도(YYYY)": "2025",
  "조회기준연월(YYYYMM)": "01",
  "조회시작연월(YYYYMM)": "01",
});

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": "발급받은_인증키",
    "DR ISIN 코드": "11110",
    "공공데이터포털에서 받은 인증키": "값",
    "국가코드(미선택 시 데이터 전체 조회)": "11110",
    "조회기준연도(YYYY)": "2025",
    "조회기준연월(YYYYMM)": "01",
    "조회시작연월(YYYYMM)": "01",
}

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