ユースケース
各ページは、正しい営業日を決める、家賃をインフレで調整するといった1つの作業を取り上げ、それを実行する Narwhal のリクエストと実際のレスポンスを示します。
カレンダーと発表
データや決定が出るタイミングを把握します。
| 活用例 | 内容 |
|---|---|
| 自分のアプリの中に経済指標カレンダーを表示する | プロダクトに経済指標カレンダーを組み込みます。ユーザーごとの国フィルター、閲覧者のタイムゾーンでの発表時刻、国別のキャッシュ、日程が動いた発表の処理に対応します。 |
| 経済指標 スケジュール：発表前に時刻、対象期間、前回値を確認する | 経済指標 スケジュールをカレンダー API で取得し、ある国の注目度の高い次の指標について、UTC と現地の発表時刻、対象期間、前回値を発表前に確認できます。下調べに役立ちます。 |
| トレーディングデスクやオンコールチームへ発表前アラートを送る | トレーディングデスクやオンコールチーム向けの発表前の経済指標 通知を作ります。各メッセージに、UTC の時刻、デスクの現地時刻、対象期間、前回値が入るため、一目で確認できます。 |
| 記事のために、来週の発表予定と最新値を調べる | 今週発表予定の経済指標と、インフレ率・失業率・GDPの最新値を取得します。記事で正しい対象月を書けるよう、基準期間と発表日も一緒に返ります。Narwhal API で記事向けの経済データを調べる方法です。 |
| 中央銀行 政策金利 推移：市場が織り込む金利パスまで追跡する | 複数の国の中央銀行について現在の政策金利と金利の推移を読み取り、さらに今後の会合の利下げ・据え置き・利上げについて、市場が織り込む確率を加えて一緒に追跡します。 |
祝日と営業日
休業日を踏まえて計画します。
| 活用例 | 内容 |
|---|---|
| 決済日 営業日 計算：二国間で祝日が異なる取引を確認する | 両国の祝日が異なる国際取引の決済日を営業日で計算します。取引一覧を両国の祝日リストに通し、日付が営業日の単純計算とずれる取引に印を付けて、確認しやすい形にします。 |
| 給与計算のために、国と年ごとの祝日を一覧にする | 給与計算のために国ごとの祝日を年単位で取得し、各エントリの scope と地域コードで、全国の祝日と地域限定の祝日を見分けます。国と年を指定して呼び出すだけで、給与計算に必要な祝日の一覧が手に入ります。 |
| 配送日 祝日 計算：チェックアウトで2か国にまたがる配送日を約束する | 配送日 祝日 計算を、注文の締め切り時刻、配送業者の日数、発送国と配送先国の祝日をもとに行い、カートに配送日を表示します。2か国にまたがる注文でも、チェックアウトで配送日を約束できます。 |
| 各国 祝日 会議 日程：複数の国の祝日を避けて会議やリリースを組む | 各国の祝日カレンダー API を使い、複数の国の祝日と重ならない日を見つけて、会議、リリース、メンテナンス枠の日程を組みます。多国籍チームの日程が休日と重なりません。 |
| SLA 営業時間 計算：サービスレベル契約の違反タイマーを営業日で動かす | SLA 営業時間 計算を営業日ベースで行う違反タイマーを、サービスデスクに用意します。契約で定めるべきことと、契約国の Narwhal の祝日がタイマーにどう反映されるかを、具体的に説明します。 |
| 各国 祝日 旅行の計画：祝日とイスラム暦（ヒジュラ暦）を踏まえる | Narwhal API で各国の祝日、連休、ヒジュラ暦の日付をもとに旅行や予約を計画します。予約や価格のデータは含まれず、日付だけを提供するので、日程を組む材料として使えます。 |
予測市場
市場のオッズをプロダクトや調査で使います。
| 活用例 | 内容 |
|---|---|
| 顧客とディーラーに利下げ・据え置き・利上げの確率を表示する | 政策金利の確率（利下げ・据え置き・利上げ）を顧客向け画面やディーリングデスクに表示する方法です。表現のしかた、丸め方、日時の付け方、Narwhal からの更新方法を解説します。 |
| マクロイベントの市場オッズを表示するダッシュボードを作る | Narwhalの予測のトピックとイベントのエンドポイントから、CPI、雇用統計、失業率、景気後退、金利決定の市場オッズを表示する予測市場ダッシュボードを作ります。 |
| 同じイベントについて、2つの予測市場の価格差をスクリーニングする | Kalshi と Polymarket をスクリーニングするデスクは、Narwhal の1回の呼び出しで両方の気配値、ルール文、決済の参照元を取得でき、価格差を各契約の支払い条件と照らして読めます。 |
| 予測市場 研究のためのオッズ履歴と決済済み結果の取得 | 予測市場 研究のために、Narwhal APIで予測市場のオッズ履歴と決済済みイベントの結果を取得します。レスポンスの as_of、stale、final を読み取って、研究用データとして使えます。 |
| 市場オッズを入力シグナルとして使い、予想変動幅の変化を測る | Narwhal の政策金利パスをポーリングして中央銀行の決定に関する市場の確率を読み取り、2回の読み取りの間で予想変動幅の変化をベーシスポイントで計算します。予測市場をトレードのシグナルにする手順です。 |
インフレ、金利、マクロ
公的統計で調整、比較、監視を行います。
| 活用例 | 内容 |
|---|---|
| 過去の予算や契約額を現在の価格に換算する | 報告書向けに、過去の予算や契約額を現在の貨幣価値に換算するインフレ調整の手順です。基準月と指数を選び、APIのCPIで数値に注記を付けます。Pythonによる換算例と注記の書き方も確認できます。 |
| 下限と上限つきの CPI 連動の賃料改定を計算する | 賃料 CPI 連動の年次改定を、下限と上限つきで計算します。Narwhal API の CPI 2 時点の値から求める方法を、実行できる Python スクリプトで示します。 |
| 2 か国のインフレ率と比べて、昇給が物価に追いついているか確かめる | 昇給が物価に追いついているかを、2 か国の CPI 前年比のインフレ率と比べて確かめます。実質賃金 計算には、Narwhal のインフレ率エンドポイントを使います。 |
| イールドカーブ スプレッドを毎日記録し、しきい値に照らして警告を付ける | リスクチーム向けにイールドカーブを毎日チェックします。履歴ルートからスプレッドを保存し、しきい値に照らして警告を付け、参照元の日付つきで実行ごとに記録していきます。 |
| 対象国のカントリーリスクプレミアムと資本コストの入力値を取得する | 対象国の株式リスクプレミアムを、成熟市場プレミアムとカントリーリスクプレミアムに分けて取得し、株主資本コストと WACC の算出に使う方法を、手順に沿って説明します。 |
| 新興国のインフレ率・政策金利・成長率を比較する | インドネシア、ブラジル、メキシコ、インドなどの新興国について、インフレ率、中央銀行の政策金利、GDP成長率を1つのAPIで比較します。データのない国には年次系列へのフォールバックを使います。 |
| 公的ライブデータで経済学の演習を作る | 実質金利とGDPに含まれる物価上昇を題材に、授業で使う経済学の演習データを作ります。公的機関のインフレ率、政策金利、GDPのライブデータを使い、リクエスト例とPythonの計算まで確認できます。 |
この活用例について
各活用例は作業内容を示し、実際のリクエストとレスポンスを見せ、詳細は使い方ガイドと API のページへリンクします。
すべての例で同じ無料 API キーを使います。キーには最初の12か月間、毎月 $10 の無料クレジットが付きます。
このデータをAPIで取得
リクエストを試す。
curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
"https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"無料キーで始めましょう
12か月間、毎月10ドル分の無料クレジット。カードは不要です。毎月10ドル分の無料クレジット。カードは不要です。