전체 문서 탐색

Narwhal이 공식 경제 데이터를 검증하는 방법

모든 공개 경제 데이터 API 응답에 적용되는 출처, 검증, 저장 및 수정 규칙입니다.

Narwhal은 국가 통계 발표 자료를 일관된 하나의 명세로 제공합니다. 서로 다른 지표를 모호한 숫자 하나로 축약하지 않고 출처의 기간, 단위, 발표일 및 해석에 필요한 필드를 보존합니다.

공식 출처만

현재 제공 중인 각 데이터는 정부 통계청 또는 다른 공식 국가 통계 제공 기관에서 가져옵니다. Narwhal은 상업적 추정치를 공식 CPI, 노동, GDP 또는 상품 무역 시계열에 섞지 않습니다.

현재 제공 기관에는 ABS, Statistics Canada, Destatis, INSEE, ONS, 일본의 국가 통계 기관, DOSM, CBS Netherlands, SingStat, BLS, BEA, US Census Bureau, Statistics Estonia, Ireland's Central Statistics Office, Latvia's Central Statistical Bureau, Slovenia's Statistical Office, Croatian Bureau of Statistics, Czech Statistical Office, State Data Agency of Lithuania 및 Statistics Portugal (INE)가 포함됩니다. 데이터 범위 표 에는 현재 데이터를 제공하는 국가별로 해당 제공 기관과 갱신 주기가 나와 있습니다.

포르투갈의 INE 출처 기록 은 다음 라이선스에 따라 게시됩니다: CC BY 4.0 라이선스. Narwhal은 INE를 출처로 표시하고 API 명세에서 정규화한 값과 파생 값을 명시합니다.

Narwhal이 이 기관들의 데이터를 정규화한 결과에도 다음과 같은 공표된 조건이 적용됩니다:

  • Statistics Estonia Statistics Estonia의 출처 조건과 CC BY-SA 4.0 라이선스는 Statistics Estonia의 출처 표시, 라이선스 링크 및 수정물에 대한 동일 조건 적용을 요구합니다. Statistics Estonia 출처 조건CC BY-SA 4.0 라이선스
  • 아일랜드 CSO 아일랜드 CSO 저작권 정책과 CC BY 4.0 라이선스는 출처 표시를 조건으로 재사용을 허용합니다. 아일랜드 CSO 저작권 정책CC BY 4.0 라이선스
  • 라트비아 CSB 라트비아 CSB 배포 정책은 출처 표시를 조건으로 상업적 및 비상업적 재사용을 허용합니다. 라트비아 CSB 배포 정책
  • 슬로베니아 SURS SURS 재사용 정책은 출처 표시와 변경 사항의 명확한 표시를 조건으로 상업적 복제, 배포, 수정 및 제품에의 포함을 허용합니다. SURS 재사용 정책
  • 크로아티아 통계청(CBS) CBS Croatia의 공개 라이선스는 출처 표시, 라이선스 링크 및 변경 사항 표시를 요구합니다. 크로아티아 CBS 공개 라이선스
  • 체코 ČSÚ ČSÚ 재사용 조건은 체코 데이터 재사용에 적용됩니다. ČSÚ 재사용 조건
  • 리투아니아 국가데이터청 리투아니아 배포 정책은 원출처 표시를 요구합니다. 리투아니아 배포 정책

Narwhal은 API 명세에서 정규화 내용과 파생 비율을 명시합니다.

Statistics Norway(SSB) 표 09190, 14710/14700, 13760, 08792는 CC BY 4.0에 따라 재사용됩니다. 출처, 표, 라이선스 및 업데이트 정보를 유지하고, Narwhal의 정규화와 파생 변경 사항을 명시하며, SSB가 보증한다는 인상을 주지 마세요.

핀란드 통계청(StatFin) 표 132h, 15b5/122p, 135y는 CC BY 4.0에 따라 재사용됩니다. 핀란드 통계청 출처 표시, 데이터셋, 라이선스 및 업데이트 정보를 유지하고 Narwhal의 정규화를 명시하세요.

핀란드 관세청 Uljas 큐브 ULJAS_KAUPPATASE(확정)와 ULJAS_ENNAKKO(잠정)는 CC BY 4.0에 따라 재사용됩니다. 핀란드 관세청, 큐브 및 업데이트 출처 표시와 확정 또는 잠정 상태를 유지하고, Narwhal의 선택과 정규화를 명시하세요.

Statistics Sweden(SCB) 표 TAB3102/TAB3100, TAB6596, TAB6387, TAB5391은 CC0에 따라 재사용됩니다. 데이터셋과 Narwhal의 독립적인 가공을 명시하고, 결과를 SCB 공식 발행물로 제시하거나 공식 협력을 암시하지 마세요.

Statistics Denmark StatBank 표 PRIS01, AKU111K, SITC2R4M, SITC2R4는 CC BY 4.0에 따라 재사용됩니다. 덴마크 통계청과 표의 출처 표시를 유지하고 Narwhal의 정규화를 명시하세요.

Eurostat 재사용 조건은 덴마크의 namq_10_gdp와 룩셈부르크의 namq_10_gdp, une_rt_q, lfsq_argan, ext_st_27_2020msbec 선택 데이터에 적용됩니다. Eurostat, 데이터셋 및 접근 날짜의 출처 표시를 유지하고 Narwhal의 변경 사항과 Eurostat이 해당 변경에 책임지지 않는다는 점을 명시하세요.

STATEC 전국 CPI 데이터셋 DSD_ECOICOP_PRIX@DF_E5405는 CC0에 따라 재사용됩니다. STATEC 표시와 링크된 데이터셋 기록을 유지하세요.

캐나다 통계청 데이터는 Open Government Licence - Canada에 따라 재사용됩니다. 출처 표시와 제3자 고지를 유지하고, Narwhal의 정규화와 파생 변경 사항을 명시하며, 캐나다 통계청이 보증한다는 인상을 주지 마세요.

네덜란드 통계청(CBS) StatLine 표 86141ENG, 80590ENG, 85879ENG, 85880ENG, 85427ENG는 CC BY 4.0에 따라 재사용됩니다. CBS 출처 표시를 유지하고 Narwhal의 변경 사항을 명시하며, 별도 제한이 있는 제3자 자료를 제외하고 CBS가 보증한다는 인상을 주지 마세요.

국가통계청(ONS) 데이터는 Open Government Licence v3.0에 따라 재사용됩니다. ONS와 라이선스 표시 및 제3자 고지를 유지하고, Narwhal의 정규화와 파생 변경 사항을 명시하며, ONS가 보증한다는 인상을 주지 마세요.

호주 통계청(ABS) 데이터는 CC BY 4.0에 따라 재사용됩니다. ABS 출처 표시를 유지하고 Narwhal의 정규화와 파생 변경 사항을 명시하며, 사용 허가가 확인되지 않은 제3자 자료를 제외하고 ABS가 보증한다는 인상을 주지 마세요.

일본 통계 대시보드 / e-Stat 데이터는 Government of Japan Standard Terms of Use 2.0 / CC BY 4.0 호환 조건에 따라 재사용됩니다. 출처 표시와 별도로 명시된 제3자 권리를 유지하세요.

INSEE 데이터는 Open Licence 2.0에 따라 재사용됩니다. 출처, 최신 업데이트 정보 및 제3자 고지를 유지하고, Narwhal의 정규화와 파생 변경 사항을 명시하며, INSEE가 보증한다는 인상을 주지 마세요.

프랑스 관세청(DGDDI/DSECE) 데이터는 링크된 재사용 고지에 따라 재사용됩니다. 정확한 출처와 기준 날짜를 유지하고 데이터 무결성을 보존하세요.

Destatis 데이터는 Data licence Germany - attribution - Version 2.0에 따라 재사용됩니다. 출처, 라이선스 및 업데이트 맥락을 유지하세요.

스페인 국가통계원(INE) 표 76125, 67821, 67822, 65081, 65219는 CC BY 4.0에 따라 재사용됩니다. 출처와 업데이트 표시를 유지하고 Narwhal의 변경 사항을 명시하며, INE가 보증한다는 인상을 주지 마세요.

스페인 국세청(AEAT) 총 상품무역 데이터는 링크된 재사용 조건에 따라 2024년부터의 새 방법론을 사용합니다. 출처, 날짜 및 메타데이터를 유지하고 Narwhal의 변경 사항을 명시하며, 데이터를 왜곡하거나 AEAT가 보증한다는 인상을 주지 마세요.

필리핀 통계청(PSA) OpenSTAT 표 0012M4ACP22.px, 0021B3FKEI2.px, 0012L4DFTS0.px, 0012B5BEXQ1.px, 0022B5BEXQ2.px, 022B5BEXS2.px는 CC BY 데이터셋 조건에 따라 재사용됩니다. PSA 출처 표시, 조건 링크 및 기술 주석을 유지하고, Narwhal의 변경 사항을 명시하며, PSA가 보증한다는 인상을 주지 마세요.

Narwhal은 다음 발행 기관의 발표 일정 항목(날짜, 시각, 제목 및 기준 기간)을 링크된 이용 조건에 따라 재사용합니다.

미국 연방준비제도 이사회 발표 일정 항목은 퍼블릭 도메인에 속하며, 미국 연방준비제도 이사회를 출처로 명시하여 재사용됩니다. Narwhal은 로고나 인장을 사용하지 않으며, 이사회가 보증한다는 인상을 주지 않습니다.

미국 노동부 고용훈련청 발표 일정 항목은 퍼블릭 도메인에 속하며, 미국 노동부(DOL)를 출처로 명시하고 노동부가 보증한다는 인상을 주지 않는 방식으로 재사용됩니다.

미국 에너지정보청 발표 일정 항목은 퍼블릭 도메인에 속하며, "Source: U.S. Energy Information Administration"을 출처로 표시하여 재사용됩니다. 각 발표 항목의 observed_at은 Narwhal이 EIA 일정을 읽은 날짜를 나타내며, 이 날짜를 "Source: U.S. Energy Information Administration (<date>)" 형식의 출처 표시에 사용합니다.

재정서비스국 월간 재정 보고서의 발표 일정 항목(발표 날짜, 시각, 제목 및 대상 기간)은 FiscalData가 상업적 이용을 허용하여 제공하며 Narwhal이 재사용합니다. Narwhal은 미국 재무부 재정서비스국을 출처로 명시하고 항목을 정규화하며, 이는 재정서비스국이나 미국 재무부의 보증이나 지지를 암시하지 않습니다.

Eurostat 유로 지역 발표 일정 항목은 "Source: Eurostat"을 표시하여 재사용됩니다. Narwhal은 항목을 정규화하며, Eurostat이 보증한다는 인상을 주지 않습니다.

유럽연합 집행위원회 경제금융총국(DG ECFIN) 기업 및 소비자 조사 발표 일정 항목은 "© European Union"을 표시하여 다음 라이선스에 따라 재사용됩니다: CC BY 4.0 라이선스. Narwhal은 항목을 정규화하여 내용을 변경했습니다.

일본 재무성 발표 일정 항목은 Public Data License 1.0에 따라 일본 재무성을 출처로 명시하여 재사용됩니다. Narwhal이 내용을 편집했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

e-Stat(일본 공식 통계 포털) 발표 일정 항목은 "Source: Portal Site of Official Statistics of Japan website (https://www.e-stat.go.jp/)"를 표시하여 재사용됩니다. Narwhal이 내용을 편집했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 내각부 경제사회종합연구소(ESRI) 발표 일정 항목은 일본 정부 표준 이용 약관 2.0 에 따라 "Created by Narwhal based on the GDP release schedule (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/en/sna/kouhyou/kouhyou_top.html)"를 출처로 표시하여 재사용됩니다. Narwhal이 항목을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 세관(재무성) 발표 일정 항목은 공공데이터 이용허락 1.0 에 따라 "Created by Narwhal based on the Calendar of Release Dates (Japan Customs, Ministry of Finance) (https://www.customs.go.jp/toukei/calendar/calend_e.htm)"를 출처로 표시하여 재사용됩니다. Narwhal이 항목을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 재무성, 업종별 법인기업 재무제표 통계 발표 일정 항목은 공공데이터 이용허락 1.0 에 따라 "Created by Narwhal based on the Financial Statements Statistics of Corporations by Industry release schedule (Ministry of Finance, Japan) (https://www.mof.go.jp/pri/reference/ssc/results/release_info.htm)"를 출처로 표시하여 재사용됩니다. Narwhal이 항목을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 통계국(총무성) 월간 요약은 일본 소비자물가지수, 도쿄 지역 소비자물가지수(잠정), 노동력조사, 가계수지조사(가계 지출)의 발표 일정 항목에 표시되는 실제값과 이전값의 출처이며, Narwhal은 이 값을 발표된 그대로 읽고 공공데이터 이용허락 1.0 에 따라 "Created by Narwhal based on the Consumer Price Index, Tokyo area Consumer Price Index (preliminary), Labour Force Survey, and Family Income and Expenditure Survey (household spending) monthly summaries (Statistics Bureau of Japan) (https://www.stat.go.jp/english/)"를 출처로 표시하여 재사용합니다. Narwhal이 내용을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 후생노동성(MHLW) 보도자료는 매월근로통계조사의 발표 일정 항목에 표시되는 실제값(현금 급여 총액 및 실질 임금의 전년 동월 대비 변화율)의 출처이며, Narwhal은 이 값을 발표된 그대로 읽고 공공데이터 이용허락 1.0 에 따라 "Created by Narwhal based on the Monthly Labour Survey (Ministry of Health, Labour and Welfare) (https://www.mhlw.go.jp/toukei/itiran/roudou/monthly/)"를 출처로 표시하여 재사용합니다. Narwhal이 내용을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

일본 내각부 경제사회종합연구소(ESRI) 기계 수주 통계는 기계 수주 발표 일정 항목에 표시되는 실제값과 이전값(선박 및 전력을 제외한 민간 부문의 근원 기계 수주, 전월 대비 및 전년 동월 대비 변화율)의 출처이며, Narwhal은 이 값을 발표된 그대로 읽고 일본 정부 표준 이용 약관 2.0 에 따라 "Created by Narwhal based on the Machinery Orders statistics (Economic and Social Research Institute, Cabinet Office) (https://www.esri.cao.go.jp/jp/stat/juchu/menu_juchu.html)"를 출처로 표시하여 재사용합니다. Narwhal이 내용을 편집(정규화)했으며, 편집된 버전을 일본 정부가 작성한 것으로 제시하지 않습니다.

캐나다 모기지주택공사 발표 일정 항목은 "Source: Canada Mortgage and Housing Corporation (CMHC), housing data release schedule, reference period as shown on each release."라는 고지를 표시하여 재사용됩니다. 수령자는 CMHC의 라이선스 조건에 따라 항목을 사용합니다.

호주준비은행 발표 일정 항목은 "Source: Reserve Bank of Australia 2026"을 출처로 명시하여 다음 라이선스에 따라 재사용됩니다: CC BY 4.0 라이선스. Narwhal은 항목을 정규화하여 내용을 변경했습니다. 이러한 사용은 RBA의 보증이나 지지를 의미하지 않습니다.

Banco Central do Brasil 발표 일정 항목은 Banco Central do Brasil(BCB)을 출처로 명시하여 재사용됩니다. 정보는 변경 없이 유지되며 날짜, 시각 및 제목은 발표된 그대로 보존됩니다.

Banco de México 발표 일정 항목은 Banco de México를 출처로 명시하고 웹 주소 https://www.banxico.org.mx/ 를 표시하여 재사용됩니다.

튀르키예 통계청(TurkStat) 발표 일정 항목은 TurkStat을 출처로 명시하여 재사용됩니다.

인도 통계·사업이행부(MoSPI) 발표 일정 항목은 MoSPI를 출처로 명시하여 재사용됩니다.

그리스 통계청(ELSTAT) 발표 일정 항목은 ELSTAT을 출처로 명시하여 재사용됩니다. Narwhal은 항목을 정규화하여 내용을 변경했으며, ELSTAT은 이러한 변경에 대해 책임을 지지 않습니다.

헝가리 중앙통계청(KSH) 발표 일정 항목은 "Forrás: KSH"를 출처로 명시하여 다음 라이선스에 따라 재사용됩니다: CC BY 4.0 라이선스. Narwhal은 항목을 정규화하여 내용을 변경했습니다.

아이슬란드 통계청 발표 일정 항목은 아이슬란드 통계청을 저작자로 명시하여 다음 라이선스에 따라 재사용됩니다: CC BY 4.0 라이선스. Narwhal은 항목을 정규화하여 내용을 변경했습니다.

대만 주계총처(DGBAS) 발표 일정 항목은 정부자료개방이용약관 1.0에 따라 DGBAS를 출처로 명시하여 재사용됩니다. Narwhal은 항목을 정규화하여 내용을 변경했습니다.

발표 자료는 완전한 형태로 검증을 통과해야 합니다

예약된 소스 검사는 후보 발행본을 가져와 식별 정보, 기간, 필수 필드, 단위 및 완전성을 검증합니다. 관측값과 그 소스 증거는 함께 저장됩니다. 필요한 검사를 통과한 완전한 발행본만 고객 요청에 제공됩니다.

후보 데이터가 불완전하거나 검증에 실패하면 Narwhal은 마지막 승인 발표를 계속 제공합니다. 누락된 값을 0으로 바꾸거나 실패한 발표의 일부를 이전 발표와 섞지 않습니다.

의미를 보존하는 하나의 명세

국가별 최신 및 과거 데이터 작업은 안정적인 REST 경로와 MCP 도구를 공유하며 지표별 맥락을 명시합니다. CPI는 1982-84=100과 같은 지수 기준을 유지합니다. 아일랜드 CPI는 2023년 12월 기준을 사용하며, 라트비아 소스의 WorkAndSes 조정 플래그는 검증되지 않은 Narwhal 조정 없이 원문 그대로 유지됩니다. GDP는 항상 당해년가격 기준이고 GDP 성장률은 실질 기준입니다. 시계열이 계절 조정되지 않았거나 연율로 환산된 경우에만 플래그가 표시됩니다. 무역은 상품만 포함하며 통화를 유지합니다. 아일랜드 소스의 천 유로 단위 값은 API 계약에서 유로로 변환합니다.

클라이언트에서 정밀도가 손실되지 않도록 십진수 값은 문자열로 반환됩니다. 누락된 값은 누락된 상태로 유지됩니다. 경제 데이터 API 레퍼런스 에는 모든 작업의 필드와 허용되는 기간 형식이 문서화되어 있습니다.

최신성 및 수정 사항

고객 요청은 Narwhal에 저장된 승인 데이터를 읽으므로 정부 웹사이트의 응답을 기다리지 않습니다. period 는 관측값을 식별하고, released_on 은 공식 발표일을 기록합니다.

공식 기관은 이전 수치를 수정할 수 있습니다. 수정된 발표 자료가 동일한 검증을 통과하면 해당 기간에 저장된 이전 값을 대체할 수 있습니다. Narwhal은 현재 수집 타임스탬프를 공개하지 않으며, 공개 베타 기간에 출처 발표부터 API 제공까지의 지연 시간을 고정적으로 보장하지 않습니다. 정확한 내용은 다음 명세를 확인하세요: 최신성 명세.

현재 제한 사항

  • 국가 및 지표 범위는 공개 범위 페이지에 표시됩니다. 사용 가능한 기간은 출처에 따라 다릅니다.
  • 갱신 주기는 공식 출처를 따르며 인위적으로 단축하지 않습니다.
  • 상품 무역에는 서비스 무역이 포함되지 않습니다.
  • 경제 데이터는 제공 기관에 의해 지연되거나 정정 또는 수정될 수 있습니다.
  • Basic 및 Pro에는 가동률 99.5% SLA가 포함됩니다. 자세한 내용은 이용약관을 참조하세요. Narwhal 데이터는 금융·투자·법률·세무 자문이 아닙니다.

API 동작에 대한 설명은 다음 문서를 참고하세요: 오류 및 할당량. 국가별 제공 범위는 다음에서 확인하세요: 데이터 범위.