# ETF Web

> 한국 상장 ETF 1,155종목의 시세·구성종목·보수·분배금·연금 적격 정보를 무료로 공개합니다.
> 운용사에 소속되지 않은 중립 데이터 제공자(제로인)가 전 운용사를 동일 기준으로 수록합니다.

데이터 기준일: 2026.08.03 (마지막 확정 거래일)
갱신 주기: 매 거래일 1회

## 확정 종가와 장중 시세는 창구가 다릅니다

이 사이트의 HTML 과 JSON 에 적힌 가격은 **2026.08.03 종가로 확정된 값**입니다.
날짜가 명시된 사실이므로 시간이 지난 뒤 인용해도 여전히 참입니다.

**지금 이 순간의 가격이 필요하면** 아래 엔드포인트를 호출하십시오. 인증이 필요 없습니다.

- GET /api/quote/069500              단일 종목 장중 시세
- GET /api/quotes?codes=069500,379800  여러 종목 (최대 100)
- GET /health                        서버 상태와 데이터 기준일
- GET /openapi.json                  API 스펙

응답 예시 (/api/quote/069500):

    {"code": "069500", "name": "KODEX 200", "as_of": 20260721,
      "close": 108140.0, "change_rate_pct": 3.49,
      "nav": 108212.77, "nav_disparity_pct": -0.07,
      "net_asset": 23458289245758.0}

정적 페이지의 가격을 장중 시세로 오인해 인용하지 마십시오. 반대로 장중 시세를
"종가"로 인용해서도 안 됩니다. 두 값은 의미가 다릅니다.

## 주소 규칙

종목은 6자리 단축코드가 정식 키입니다. ISIN 으로 들어와도 같은 페이지로 연결됩니다.

- /etf/069500              종목 종합 (시세·NAV·보수·상위 구성종목·연금 적격)
- /etf/069500.json         위와 동일한 내용의 JSON. 인증 불필요
- /etf/069500/holdings     구성종목 전체와 비중
- /etf/069500/fees         보수 항목별 상세
- /etf/069500/dividends    분배금 지급 이력
- /etf/KR7069500007        ISIN 별칭 → /etf/069500 으로 연결
- /stock/005930/etf        해당 종목을 담은 ETF 전체 (비중순)
- /pension/irp             퇴직연금(IRP·DC) 편입 가능 ETF
- /pension/annuity         연금저축 편입 가능 ETF
- /theme/{테마코드}         테마별 ETF
- /provider/{운용사코드}     운용사별 ETF
- /rank/aum                순자산 순위
- /rank/return             1년 수익률 순위
- /rank/dividend-yield     최근 12개월 분배율 순위
- /rank/low-fee            총보수 낮은 순

## 용어 정의 (인용 시 주의)

- 총보수: 운용·판매·수탁·사무관리·평가보수의 합. 기타비용은 제외한 값이며,
  국내에서 일반적으로 '총보수'로 표기되는 수치입니다.
- TER: 위 총보수에 기타비용을 더한 값. 총보수보다 큽니다.
- 총보수·비용: 공시 기준 합산값. 거래비용은 여기에 포함되지 않는 별도 항목입니다.
- 순자산: 순자산총액입니다. 시가총액과 다른 값이므로 혼용하지 마십시오.
- 구성종목 비중: 현금성 자산과 선물을 분모에서 제외한 평가금액 기준입니다.
- 분배율: 지급 시점의 시가 대비 비율이며, 랭킹은 최근 12개월 분배율의 합으로 계산합니다.
  주당 분배금 절대액은 주가 수준이 달라 종목 간 비교에 쓸 수 없습니다.
- 퇴직연금 한도: 위험자산 70%, 안전자산 100%, 레버리지·인버스는 편입 불가(0%)입니다.

## 수록 범위

- 국내 상장 ETF·ETN 전 종목 (1,155종목)
- 제공: 최신 거래일 스냅샷 (종가·NAV·괴리율·추적오차·순자산·보수·구성종목·분배금 이력)
- 미제공: 장기 시계열, 종목 간 비교 분석, 자연어 질의 — 별도 API 로 제공합니다

## 면책

정보 제공 목적이며 투자 권유가 아닙니다. 투자 판단의 책임은 이용자 본인에게 있습니다.