最初のNarwhal APIリクエストを実行

1つのAPIキーで経済、為替、商品スポット価格（金、銀、プラチナ、パラジウム、銅、WTI原油、ブレント原油）、パーム油、米国の週次ガソリン価格（EIA）、米国の週次ディーゼル価格（EIA）、月次商品ベンチマーク（World Bank）、日次スポット価格（WTI原油、ブレント原油、天然ガス）、米国、英国、ドイツ、日本、カナダの利回り曲線、予測市場の確率（KalshiとPolymarket）、経済指標の発表カレンダー、祝日の利用を始めましょう。Bearerキーによる認証と、レスポンスやエラーの処理方法を説明します。

このガイドはCPIから始まり、提供中のAPIリファレンスを次の場所で案内します： api.narwhalapi.com。

経済データの対応範囲

36 国: AUS, AUT, BEL, CAN, CHL, COL, CZE, DEU, DNK, ESP, EST, FIN, FRA, GBR, HRV, IRL, ITA, JPN, LTU, LUX, LVA, MEX, MYS, NLD, NOR, NZL, PAK, PHL, POL, PRT, QAT, SAU, SGP, SVN, SWE, USA。カバレッジは操作と国によって異なります。各操作に対応国が記載されています。すべてのデータリクエストには Bearer キーが必要です。

Free ベータ版の上限： 5,000 件の成功リクエスト（UTC の暦月単位）、および毎分30リクエスト。RESTとMCPは同じ制限を共有します。

APIキーを設定

キーを Bearer トークンとして送信するヘッダーは Authorization です。URL には絶対に含めないでください。無料キーを取得するためにアカウントを作成、次に認証ガイドを、キーを保存する前に読んでください。

ターミナル

export NARWHAL_API_KEY="nw_live_..."

公式 CPI をリクエスト

パスに ISO 3文字国コードを指定します。パラメータ period を省略すると、受け入れ済みの完全なリリースのうち最新のものを返します。

リクエスト

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

レスポンスの例

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "index_base": "1982-84=100",
  "released_on": "2026-08-12"
}

PythonとJavaScriptの例

アプリケーションでも同じ環境変数とエンドポイントを使用します。これらの例では標準ライブラリを使用しています。

Python 3

import json
import os
from urllib.request import Request, urlopen

request = Request(
    "https://api.narwhalapi.com/v1/economics/USA/cpi",
    headers={"Authorization": "Bearer " + os.environ["NARWHAL_API_KEY"]},
)
with urlopen(request, timeout=30) as response:
    data = json.load(response)
print(data)

JavaScript · Node.js 18+

const key = process.env.NARWHAL_API_KEY;
if (!key) throw new Error("Set NARWHAL_API_KEY first");
const response = await fetch(
  "https://api.narwhalapi.com/v1/economics/USA/cpi",
  { headers: { Authorization: "Bearer " + key }, signal: AbortSignal.timeout(30000) }
);
const data = await response.json();
if (!response.ok) throw new Error(JSON.stringify(data));
console.log(data);

APIを選択

API	開始：
経済データAPI	公式の公表機関による CPI、インフレ率、労働、GDP、貿易データです。カバレッジは国と指標によって異なります。
為替API	現在のレート、換算、ページ分割された履歴。すべてのレートにタイムスタンプがあります。
祝日 API	公開済みの祝日データ。全国・地域の適用範囲と振替休日を含みます。
パーム油API	インドネシアとマレーシアのCPO・FFB価格。元の単位と履歴を保持します。

国と指標を選択

最新リリース操作と対応する履歴操作を利用できますが、提供される指標は国によって異なります。経済データAPIリファレンスには、すべてのパスとレスポンス形式が記載されています。

指標	パスのサフィックス
CPI	`/cpi`
インフレ率	`/inflation`
失業率	`/unemployment`
労働力率	`/labour-force-participation`
GDP と成長率	`/gdp` · `/gdp-growth`
貿易	`/trade`

MCP経由で接続

MCP クライアントで同じキーとスキーマを使用します。ツールの検出では、4つの API 全体でアカウントが利用できる操作が一覧表示されます。参照先： MCPガイド。

クライアントに依存しないフィールドマップ

{
  "url": "https://api.narwhalapi.com/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_NARWHAL_API_KEY"
  }
}

MCP クライアントの安全なシークレット設定でプレースホルダーを置き換えます。通常の JSON は、それ自体では環境変数を展開しません。

初回の tools/call

{
  "method": "tools/call",
  "params": {
    "name": "fx_get_rates",
    "arguments": { "base": "USD", "currencies": ["EUR", "JPY"] }
  }
}

初期化と tools/list はクォータを消費しません。成功した各 tools/call はリクエストを1件消費します。

レスポンスを読む

統合する前に各操作のレスポンススキーマを確認してください。

規則	意味
`period`	公式リリースが返す正確な月、四半期、または年。
`released_on`	公式の公表日。
小数文字列	2進浮動小数点による予期しない誤差を避けられます。
欠落データ	不完全または利用できないリリースは失敗として処理され、欠落値がゼロになることはありません。

読む Narwhal が公式リリースを保存・更新する方法。

成功レスポンスのクォータヘッダー

X-Request-IDX-RateLimit-LimitX-RateLimit-RemainingX-RateLimit-Reset

ステータスとコードでエラーを処理

まずHTTPステータスを確認し、次に code をアプリケーションのロジックで使用します。 detail はログとデバッグに使用します。エラーとクォータのガイドには、すべての公開ステータスが記載されています。

RFC 9457 問題レスポンス

{
  "type": "https://narwhalapi.com/problems/invalid-query",
  "title": "Invalid query",
  "status": 400,
  "detail": "The request parameters are not valid for this operation.",
  "code": "invalid_query",
  "request_id": "019d1af4-8f33-7b21-91af-ef535f2dcf50"
}

キーについてサポートが必要ですか？ Narwhal APIに連絡する。

新機能を確認：変更履歴。

LLM？ llms.txt を読む。