{
  "schemaVersion": 1,
  "generatedAt": "2026-07-18T12:19:20.752Z",
  "validAsOf": "2026-07-15",
  "contentHashSha256": "a156cc76e4173b4ffaf8a8d974519ae5db1565bb3d63c17782627729819db53f",
  "contentHashScope": "canonical JSON of indicators, observations, and sources",
  "period": {
    "start": "2024-06",
    "end": "2026-06",
    "latestCustoms": "2026-06",
    "latestBop": "2026-05",
    "bopMonthCount": 24
  },
  "coverage": {
    "observationCount": 171,
    "customsObservationCount": 3,
    "bopObservationCount": 168
  },
  "sources": [
    {
      "key": "korea-customs-trade-stats",
      "name": "관세청 수출입무역통계",
      "publisher": "대한민국 관세청",
      "releaseUrl": "https://www.customs.go.kr/kcs/na/ntt/selectNttInfo.do?nttSn=10170123&nttSnUrl=dfb439d5b7e33bf1537aea7874715abd",
      "updatedAt": "2026-07-15"
    },
    {
      "key": "bok-ecos",
      "name": "한국은행 경제통계시스템 ECOS 국제수지 301Y013",
      "publisher": "한국은행",
      "catalogUrl": "https://ecos.bok.or.kr/",
      "releaseUrl": "https://www.bok.or.kr/portal/bbs/B0000501/view.do?depth=201264&menuNo=201264&nttId=11062667&programType=newsData&relate=Y",
      "updatedAt": "2026-07-08"
    }
  ],
  "datasets": [
    {
      "key": "korea-customs-monthly-trade-total",
      "titleKo": "관세청 월간 수출입 총괄",
      "category": "customs",
      "publisher": "대한민국 관세청",
      "status": "active",
      "updateCadence": "월간",
      "sourceUrl": "https://www.customs.go.kr/kcs/na/ntt/selectNttInfo.do?nttSn=10170123&nttSnUrl=dfb439d5b7e33bf1537aea7874715abd"
    },
    {
      "key": "bok-ecos-monthly-balance-of-payments",
      "titleKo": "한국은행 ECOS 월간 국제수지",
      "category": "bop",
      "publisher": "한국은행",
      "status": "active",
      "updateCadence": "월간",
      "sourceUrl": "https://ecos.bok.or.kr/"
    }
  ],
  "indicators": [
    {
      "key": "kr-customs-export-usd",
      "nameKo": "통관기준 수출",
      "category": "customs",
      "unit": "USD",
      "valuePrecision": 0
    },
    {
      "key": "kr-customs-import-usd",
      "nameKo": "통관기준 수입",
      "category": "customs",
      "unit": "USD",
      "valuePrecision": 0
    },
    {
      "key": "kr-customs-trade-balance-usd",
      "nameKo": "통관기준 무역수지",
      "category": "customs",
      "unit": "USD",
      "valuePrecision": 0
    },
    {
      "key": "kr-bop-current-account-usd",
      "nameKo": "경상수지",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "000000"
    },
    {
      "key": "kr-bop-goods-balance-usd",
      "nameKo": "상품수지",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "100000"
    },
    {
      "key": "kr-bop-goods-export-usd",
      "nameKo": "상품수출",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "110000"
    },
    {
      "key": "kr-bop-goods-import-fob-usd",
      "nameKo": "상품수입(FOB)",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "120000"
    },
    {
      "key": "kr-bop-services-balance-usd",
      "nameKo": "서비스수지",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "200000"
    },
    {
      "key": "kr-bop-primary-income-balance-usd",
      "nameKo": "본원소득수지",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "300000"
    },
    {
      "key": "kr-bop-secondary-income-balance-usd",
      "nameKo": "이전소득수지",
      "category": "bop",
      "unit": "million USD",
      "valuePrecision": 1,
      "sourceItemCode": "400000"
    }
  ],
  "processing": [
    "한국은행 ECOS 301Y013의 7개 핵심 항목을 월별·항목별로 수집하고 기간 완전성을 검증했습니다.",
    "ECOS 값은 원자료 단위인 백만 달러를 유지합니다.",
    "관세청 2026-06 확정 발표의 백만 달러 값을 공개 지표 저장 단위인 달러로 변환했습니다.",
    "같은 기간의 상품수출-상품수입=상품수지, 경상수지 구성 항등식을 검증했습니다."
  ],
  "caveats": [
    "국제수지 최신 월은 잠정치이며 한국은행의 정기 개편에 따라 과거 값도 수정될 수 있습니다.",
    "통관기준 무역수지와 국제수지 상품수지는 집계·가격 기준이 달라 직접 대체할 수 없습니다.",
    "관세청 공개 API 인증정보가 없어 통관기준 장기 시계열은 이번 자산에 포함하지 않고 2026-06 확정치만 제공합니다."
  ],
  "downloads": {
    "json": "/data/korea/external-economy/monthly-external-economy.json",
    "csv": "/data/korea/external-economy/monthly-external-economy.csv",
    "metadata": "/data/korea/external-economy/monthly-external-economy.metadata.json"
  }
}