日本銀行の時系列統計(為替・金利・マネー)を取得する
日本銀行の時系列統計データ検索サイトでは、為替・金利・物価・マネーなど約20万系列が公開されています。ドル円やコールレート、マネタリーベースといった金融のマクロ指標が、キー不要でAPIから取れるのが強みです。市況コメントや景気判断の根拠となる公式データを、登録なしにその場で引けるわけです。ただし系列数が膨大なため、目的の系列コードに辿り着くのが最大の関門になります。このガイドでは、主要統計コードから目的の系列までの辿り方、期間や頻度の指定、系列選びと集計の実務、そして基準年や改定といったつまずきやすい点までを実例つきでまとめました。
取れるデータと辿り方
ドル円相場、無担保コールレート、企業物価指数(CGPI)、マネタリーベース、マネーストック、日銀短観の業況判断DIなど、マクロの体温計となる系列が取得できます。市況コメントや景気判断の裏付けとなる主要指標が、公式の一次情報としてまとめて手に入ります。
取得は「分野別データベース → 階層 → 系列コード」の順で辿り、系列コードを指定して時系列を取得します。図鑑では約20万系列をツリーで辿れるエクスプローラも用意しているので、コードが分からないときはそこで探せます。いずれもAPIキーは不要で、登録なしにすぐ試せます。
取得の具体例(パラメータの渡し方)
どの系列があるか分からないときは、まず boj_major_statistics(パラメータ不要)で主要統計コードの一覧を取得し、目的に近い分野・系列コードを見つけます。ここで「為替」「金利」「マネーストック」などのあたりを付けるのが第一歩です。約20万系列の中からいきなり探すのは現実的でないため、この主要コードを起点にするのが定石です。
系列コードが決まったら boj_timeseries に seriesCode を渡します。期間を絞るときは fromYear / toYear、頻度を指定するときは frequency(月次・四半期・年次など)、出力形式は format で調整できます。返り値はその系列の時系列(時点×値)で、そのままチャート化や集計に回せます。期間を絞らずに取ると長大な系列が返ることもあるため、必要な範囲を fromYear / toYear で明示しておくと扱いやすくなります。
例えばドル円の推移が欲しければ該当系列コードを seriesCode に、企業物価やマネタリーベースなら各分野の系列コードを渡します。複数系列を並べて比較したいときは、系列ごとに boj_timeseries を呼び、時点をキーに結合すると比較チャートが作れます。頻度の異なる系列を混ぜる場合は、時点の粒度を揃える処理を挟むと整合します。
よくあるつまずき
系列コードの特定が最初の壁です。約20万系列あるため、正しいコードに辿り着くのが最も手間のかかる作業になります。boj_major_statistics で主要系列を起点にし、分野を絞ってから個別コードを探すと迷いにくくなります。近い名前の系列が複数あることも多いので、コードの意味(対象・単位・調整の有無)を確認してから使ってください。
頻度と基準の取り違えに注意します。同じ物価でも月次・四半期で系列が分かれ、指数の基準年(例:ある年=100)も系列によって異なります。異なる基準の系列をそのまま並べて比較すると、水準の段差を「実際の変化」と誤読しかねません。基準年を揃えるか、前年比などの変化率に直してから比較するのが安全です。
公表スケジュールによる遅延・改定があります。速報と確報で値が変わる系列があるため、分析の再現性を保つなら取得日と系列コードを記録し、季節調整済みか原数値かも明示しておいてください。過去の値がさかのぼって改定されることもあるので、一度取得した値を「確定値」と決めつけない運用が安全です。
分析ユースケースと関連ツールの使い分け
①マクロ・ダッシュボード:ドル円・金利・マネタリーベースを boj_timeseries でまとめて取得し、1枚のダッシュボードに並べると、金融環境の変化を一目で追えます。日次の市況コメントや、経済ニュースの背景を数値で裏付ける用途に向きます。
②物価と実体経済の照合:企業物価指数(CGPI)と、e-Stat の消費者物価(CPI)を突き合わせると、川上(企業間取引)から川下(消費)への価格転嫁の度合いを観察できます。日銀系列は boj_timeseries、消費側は e-Stat 側のツールが担うので、両者を時点で結合して並べます。
③金利・為替のトレンド分析:無担保コールレートやドル円を長期で取得し、金融政策の局面ごとの水準変化を可視化できます。系列の探索は boj_major_statistics、実際の時系列取得は boj_timeseries と役割が分かれているので、まず前者でコードを見つけ、後者で取得する二段構えで進めてください。
系列選びと集計の実務
日銀時系列統計を使いこなす最大のポイントは、目的に合った系列を正しく選ぶことです。同じ「金利」「物価」でも、対象・単位・頻度・調整の有無が違う系列が並んでおり、名前が似ているために取り違えやすい落とし穴があります。boj_major_statistics で主要コードを起点に分野を絞り、候補が複数あるときは各系列の定義(何を、どの単位で、どの頻度で測っているか)を確認してから採用してください。
複数系列を比較・合成するときは、頻度と基準を揃える処理が要ります。月次と四半期を並べるなら粒度を合わせ、指数の基準年が異なる系列は前年比などの変化率に直してから比較すると、水準の段差を実際の変化と誤読せずに済みます。boj_timeseries の frequency と、返り値に含まれる基準情報を確認しながら整えるのがコツです。
運用面では、取得日と系列コード、季節調整の別を必ず記録します。日銀統計は速報から確報への改定や、過去値のさかのぼり改定があるため、いつ時点のデータかを残しておかないと、後から数字が合わない原因を追えなくなります。特に他者と分析結果を共有する場面では、「どの系列を、いつ取得した値か」が明示されているかどうかで、再現性と信頼性が大きく変わります。再現性を保つこの一手間が、マクロ分析の土台を支えます。
出典
元システムエンジニア。Web系アプリ開発6年+ソリューション9年、IT実務およそ15年。個人開発者として、政府オープンデータや各府省のAPIを実際に叩いて検証し、「何が取れるか」「実装時にどこで詰まるか」「どう活用するか」を一次検証にもとづいて記録しています。
運営者・検証方針について →