ハウツーガイド

1つの疑問に1ページで答えます。営業日、発表時刻、インフレの計算、コモディティの単位、為替レート、オッズ、API の作業を、リクエストと数値つきで確認できます。

祝日と営業日

祝日、営業日数、決済日。

祝日と営業日
ガイド内容
2つの日付の間の営業日数を数えるPythonまたはスプレッドシートで日付間の営業日数を数えます。開始日と終了日を含めて祝日を差し引き、振替日や地域別カレンダーにも対応します。
日付に営業日数を加算するPython、Excel、Google Sheetsで日付に営業日数を加算します。週末と祝日を除外し、年の切り替わりに対応して、感謝祭の具体的な日付を使った例で計算します。
T+1またはT+2の決済日を計算するPythonまたはスプレッドシートでT+1とT+2の決済日を計算します。米国株とUSD/JPYの計算例で、週末と関係国の祝日を除外します。
指定した日付が祝日か確認するNarwhal APIまたはスプレッドシートで、指定した日付が祝日か確認します。2026年のクリスマスの例で、地域別の項目、振替日、対象範囲を扱います。
複数の国の祝日を一覧表示Pythonスクリプトやカレンダーページで、5か国の2026年の祝日を一覧表示します。共通の日付を比較し、地域別の行を処理して、休暇日を除外します。
コードに祝日判定を追加する2026年の感謝祭の週を例に、PythonやJavaScriptでキャッシュを使う祝日判定を追加し、スプレッドシートの数式を使用して、未公開のカレンダーに対応します。

発表日と中央銀行

データや政策決定がいつ出るか、その通知を受ける方法。

発表日と中央銀行
ガイド内容
次のCPI公表日を検索経済カレンダーAPIまたは国別ページで米国CPIの公表日を検索します。対象月、公表予定のUTC時刻、ニューヨーク時刻を確認します。
リリース時刻を自分のタイムゾーンに変換するPythonまたはスプレッドシートで、経済リリースのUTC時刻を現地時刻に変換します。2026年11月のCPIの例で、夏時間と日付の変更に対応します。
経済リリースの前に通知を受け取る経済指標 通知は、カレンダーフィードか 1 日 1 回実行する Python スクリプトで設定できます。米国 CPI を例に、UTC、ニューヨーク時間、ジャカルタ時間それぞれの通知時刻を確認できます。
経済カレンダーを作成する選んだ国と日付の経済指標カレンダーを、UTCの発表時刻つきで作ります。Pythonスクリプト、Webサイトのカレンダー、お使いのカレンダーアプリのフィードのどれでも使えます。
FOMC会合の日付と議事要旨を検索する経済カレンダーAPIで予定されたFOMCの政策金利決定と議事要旨を検索し、カレンダーフィードを使い、UTC、ニューヨーク、ジャカルタのリリース時刻を確認します。
すべての中央銀行会合を1つの一覧にまとめるPythonスクリプトで中央銀行の決定日を日付順に一覧にし、コード不要の会合ガイドを探し、正確な時刻の確認に経済カレンダーを使う場面を確認します。
中央銀行の金利変更を追跡するPythonで中央銀行の金利変更を追跡します。Narwhal APIで政策金利履歴を読み取り、単一金利とレンジを比較し、ソースの日付を使って毎日確認します。

経済

公的統計に基づくインフレ、成長率、利回り。

経済
ガイド内容
CPI 前年同月比と前月比の計算方法CPI 前年同月比と前月比を、APIから計算済みの値で取得する方法と、指数水準からPythonや表計算で求める方法を解説します。米国の例と、月次データが欠けたときの対処も紹介します。
インフレ調整後の価格を求めるインフレ調整は、CPI指数、Pythonスクリプト、またはスプレッドシートの数式で行えます。2025年11月の100ドルが2026年9月にいくらの購買力になるかを、実際の数値で確認できます。
各国のインフレ率を比較するPythonまたはスプレッドシートで、各国のインフレ率を比較します。公表された物価上昇率を順位付けし、発表日を併記して、国ごとに異なる対象期間にも対応する方法を紹介します。
実質金利を計算する名目利回りとインフレ率から実質金利を計算します。フィッシャー方程式、PythonによるAPIコード、スプレッドシートの数式、日付付きの米国の例で、実質金利の求め方がわかります。
イールドカーブが逆転しているか確認する米国債の利回りを比べて、イールドカーブが逆イールドかどうかを確認します。Pythonコード、スプレッドシートの数式、ベーシスポイントで表したスプレッドの日付付きの例を使って判定できます。
GDP 成長率 計算：GDPの水準から求めるGDP 成長率 計算を、四半期の水準からPythonまたは表計算で行う方法です。年率換算のやり方と、名目成長率を米国の実質GDP成長率と比べる方法も、計算例つきで解説します。
Pythonで世界銀行のデータを取得するNarwhal APIでPythonから世界銀行のデータを取得する方法を学びます。指標を探し、年次の観測値を読み取り、DataFrameを作成し、1日の取得上限を確認します。
IDでカナダ統計局の表を取得するカナダ統計局の表IDで表を検索し、ベクトル番号をコピーして、PythonのrequestsでNarwhal APIからCPI履歴や複数系列の最新値を取得できます。
各国の政策金利を比較する方法Pythonで各国の政策金利を比較します。単一金利と誘導目標レンジを扱い、通貨、金利種別、ソースの日付を含む表を作成して並べ替えます。

コモディティ

原油、金、銀、銅を、お使いの単位と通貨で。

コモディティ
ガイド内容
原油 バレル リットル換算：ガロン単価まで求める原油 バレル リットルの換算を、ブレントやWTIの1バレルあたりのドル価格から行います。Python、スプレッドシートの数式、コモディティ換算ツールで、リットル、米ガロン、英ガロンの価格を求められます。
自国通貨建てでコモディティ価格を調べる原油価格 円など、商品価格を自国通貨で取得する方法です。金は希望の通貨で直接取得でき、他の商品は為替レートで換算します。トロイオンスあたりとグラムあたりのルピア価格の計算方法も紹介します。
金銀比価を計算するPythonまたはスプレッドシートで金銀比価を計算します。金と銀の価格を1トロイオンスあたりの米ドルで取得し、同じ日付や時刻の価格同士で割り算する方法がわかります。
銅価格 kg・メートルトン換算の手順銅価格 kg換算とトン換算を、米ドル/ポンドの価格から行います。APIのコード、スプレッドシートの数式、それぞれの換算の計算例を使って、1kgあたりと1メートルトンあたりの価格を求められます。
金属価格 CSV で価格履歴をダウンロードするPythonで日次の金価格履歴をCSVとしてダウンロードするか、ウェブサイトの履歴テーブルを使えます。日付入りの例、ページネーションの詳細、各履歴の開始時点を確認できます。
コモディティ価格アラートを設定する金価格 通知を Python、Zapier、Make で定期実行します。金価格をしきい値と比べ、状態を保存して、しきい値をまたいだときだけ通知を送るので、同じ通知が重なりません。

為替レート

過去の日付のレート、クロスレート、平均値。

為替レート
ガイド内容
過去の日付の為替レートを取得する過去 為替レートを日付指定で取得する方法です。Narwhal API または通貨ページで特定日のレートを調べ、見方を確認し、データのない日付や小数値の扱いまでスプレッドシートで処理できます。
クロス円 計算：2つの通貨ペアからEUR/IDRを求めるクロス円 計算の考え方で、2つのドル建てレートからEUR/IDRをPythonまたは表計算で求めます。割る向き、日付が結果に与える影響、直接レートとの差も確認でき、換算額まで出せます。
月平均 為替レートの計算月平均 為替レートを、日次の観測値からPythonまたは表計算で求める方法です。2026年9月のUSD/IDRの例で手順を示し、会計や請求書で使うときの注意点も説明します。
為替レート 請求書：請求日の為替レートを調べる為替レートを請求書の日付で調べる方法です。Python またはスプレッドシートを使い、週末の扱いと通貨の向きの選び方を押さえて、日付入りの EUR 建て請求書を USD に換算します。

予測市場

オッズ、確率、アラート。

予測市場
ガイド内容
オッズ 確率 変換：予測市場の価格を確率にする方法オッズ 確率 変換の手順を紹介します。予測市場の価格やほかのオッズ形式をインプライド確率に換算し、Pythonやスプレッドシートでオーバーラウンドをとりのぞいて結果どうしを比べます。
Polymarket Kalshi 違いを同じ問いで比べるPolymarket Kalshi 違いを、同じFRBの金利判断で確認します。両プラットフォームのクォートの差をスクリプトやシートで計算し、各プラットフォームのルールと統合確率も読み取れます。
FRB 利下げ 確率を読むAPIまたは金利決定の確率ページで、FRB 利下げ 確率に加えて据え置き・利上げの確率を取得できます。ベーシスポイント単位の予想変動幅と、日付つきの会合の例も確認できます。
予測のオッズが動いたらアラートを受け取る予測市場 オッズの変動通知を、定期実行の Python スクリプトまたはノーコードのワークフローで設定します。前回のオッズを保存し、しきい値を決めて、毎回の値と比較する方法がわかります。

API の作業

Webhook、ストリーム、キャッシュ、バックフィル、エージェント。

API の作業
ガイド内容
Webhook 受信：Narwhal の送信先を設定Webhook 受信の手順を解説します。Narwhal の送信先の作成、配信署名の検証、重複イベントの処理、履歴やイベントジャーナルによる取りこぼしの復旧がわかります。
WebSocket でリアルタイムにイベントを受信WebSocket リアルタイム配信を Python で扱う方法です。Narwhal API のイベントと予測のストリームに接続し、国やトピックで絞り込み、カーソルを保存し、再接続とエラーを処理します。
レスポンスをキャッシュして429エラーに対応するデータの種類ごとにAPIレスポンスをキャッシュし、Retry-Afterを処理して、レート制限と残高不足を見分けます。Pythonコードと、月額コストを求める計算例つきで解説します。
ヒストリカルデータを一括で取得するカーソル方式のページネーションで履歴データをダウンロードし、行をファイルに保存し、中断したバックフィルを再開し、各系列が返す最初の日付を確認する手順を説明します。
毎日のデータ取得をスケジュールするAPI 定期実行の例として、Python と cron で金と USD/IDR を毎日取得して CSV に追記します。ノーコードのフローも紹介し、実行タイミング、失敗時の扱い、月間の利用量もわかります。
LLM エージェントに Narwhal へのアクセスを与えるAI エージェント API 連携の手順です。API キーと MCP で LLM エージェントを Narwhal に接続し、クライアントの設定、読み取り専用のデータツール、クレジットの扱い、接続エラーの対処までまとめています。
Alpha Vantage から Narwhal へ移行するAlpha Vantage 移行の手順です。各 function を Narwhal のエンドポイントに対応づけ、apikey パラメータを Bearer ヘッダーに置き換え、CPI、株式、為替のデータが一致するか確認します。

この使い方ガイドについて

各ガイドは1つの疑問に答え、実際に動くリクエストと、出典で確認できる日付つきの例を示します。

すべての例で同じ無料 API キーを使います。キーには最初の12か月間、毎月 $10 の無料クレジットが付きます。

このデータをAPIで取得

リクエストを試す。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"
無料のAPIキーを取得クイックスタートを読む

よくある質問

使い方ガイドとチュートリアルの違いは何ですか。

使い方ガイドは、2つの日付の間の営業日数を数えるといった1つの疑問に答えます。チュートリアルは、スプレッドシート、Python、Postgres などすでにお使いのツールに Narwhal のデータを設定します。

API キーは必要ですか。

コードの例には無料の API キーが必要です。キーには最初の12か月間、毎月 $10 の無料クレジットが付きます。一部のガイドは、キーなしでスプレッドシートや公開ページからも使えます。

例にはどの言語を使っていますか。

主に Python とスプレッドシートの数式で、作業に合う場合は JavaScript、SQL、ノーコードツールも使います。