ドキュメント
APIリファレンスサイト
すべてのドキュメントを閲覧

Narwhal が公式経済データを検証する方法

公開の経済データAPIのすべてのレスポンスを支えるソース、検証、保存、改訂の規則。

Narwhalは各国の統計発表を、予測可能な共通の仕様で提供します。異なる指標を曖昧な1つの数値にまとめるのではなく、ソースの対象期間、単位、公表日、解釈に必要なフィールドを保持します。

公式ソースのみ

提供中の各データ系列は、政府統計局またはその他の公的な国内発行元をソースとしています。Narwhalは、公式のCPI、労働、GDP、財貿易の系列に民間の推計値を混ぜません。

現在の発行元には、ABS、Statistics Canada、Destatis、INSEE、ONS、日本の国の統計機関、DOSM、CBS Netherlands、SingStat、BLS、BEA、US Census Bureau、Statistics Estonia、アイルランドのCentral Statistics Office、ラトビアのCentral Statistical Bureau、スロベニアの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のOpen Licenceでは、帰属表示、ライセンスへのリンク、変更箇所の表示が必要です。 CBS CroatiaのOpen Licence
  • チェコのČ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に基づいて再利用されています。出典表示と第三者の権利に関する通知を保持し、Narwhalによる正規化と派生的な変更を明示し、カナダ統計局の推奨を示唆しないでください。

オランダ統計局（CBS） のStatLineの表86141ENG、80590ENG、85879ENG、85880ENG、85427ENGはCC BY 4.0に基づいて再利用されています。CBSの出典表示を保持し、Narwhalによる変更を明示し、別途制限のある第三者の資料を除外し、CBSの推奨を示唆しないでください。

英国国家統計局（ONS） のデータはOpen Government Licence v3.0に基づいて再利用されています。ONSとライセンスの表示および第三者の権利に関する通知を保持し、Narwhalによる正規化と派生的な変更を明示し、ONSの推奨を示唆しないでください。

オーストラリア統計局（ABS） のデータはCC BY 4.0に基づいて再利用されています。ABSの出典表示を保持し、Narwhalによる正規化と派生的な変更を明示し、許諾が確認されていない第三者の資料を除外し、ABSの推奨を示唆しないでください。

統計ダッシュボード / e-Stat のデータはGovernment of Japan Standard Terms of Use 2.0 / CC BY 4.0互換の条件に基づいて再利用されています。出典表示と別途明記された第三者の権利を保持してください。

INSEE のデータはOpen Licence 2.0に基づいて再利用されています。出典、最終更新情報、第三者の権利に関する通知を保持し、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は最後に受け入れた公開内容を利用可能なまま保持します。欠落値をゼロに置き換えたり、失敗したリリースの一部を古い公開内容と混ぜたりすることはありません。

意味を損なわない共通の仕様

国別の最新値と履歴の操作は、共通の安定した REST パスと MCP ツールを使用し、指標ごとの文脈も明示します。CPI は 1982-84=100 などの基準を保持します。アイルランドの CPI は2023年12月基準を使用します。ラトビアのソースの調整フラグ WorkAndSes はそのまま保持し、Narwhal による未検証の調整は加えません。GDP は常に当期価格で、GDP 成長率は実質です。フラグは、系列が季節調整されていない場合、または年率換算されている場合にのみ表示されます。貿易は財のみを対象とし、通貨を保持します。アイルランドのソースの千ユーロ単位の値は、API 契約でユーロに換算します。

小数値は、クライアント側で意図せず精度が失われないよう文字列で返されます。欠損値は欠損したままです。 経済データAPIリファレンス には、すべてのオペレーションのフィールドと、受け付ける期間の形式が記載されています。

鮮度と改訂

顧客リクエストはNarwhalに保存された受け入れ済みデータを読み取ります。政府ウェブサイトの応答を待つことはありません。 period は観測値を識別し、 released_on は公式公表日を記録します。

公式機関は過去の数値を改訂できます。改訂版が同じ確認を通過すると、その期間について以前に保存された値を置き換える場合があります。Narwhal は現在、取り込みタイムスタンプを公開しておらず、パブリックベータ中のソースから公開までの固定遅延も約束していません。正確な内容は次を参照してください： データ鮮度の仕様。

現在の制限

  • 国と指標のカバレッジは公開カバレッジページに記載されています。利用できる期間はソースによって異なります。
  • 頻度は公式ソースに従い、人為的に高く設定されることはありません。
  • 商品貿易にはサービス貿易を含みません。
  • 経済データは公開元によって遅延、訂正、改訂される場合があります。
  • Basic と Pro には稼働率99.5%のSLAが含まれます。詳しくは利用規約をご覧ください。Narwhal のデータは金融、投資、法律、税務上の助言ではありません。

運用上の動作については、次をお読みください： エラーとクォータ。国別の対象範囲は、こちらで確認できます： カバレッジ。