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

REST または MCP を通じて、Economics、FX、Equities、SEC 提出書類、パーム油価格、Calendars に1つのキーを使用します。

このガイドは CPI から始まり、6つの API それぞれの実用的なリファレンスへリンクします： api.narwhalapi.com.

経済データの対応範囲

AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD、SGP、USAはライブです。すべてのデータリクエストにNarwhal APIキーが必要です。

無料ベータ版の上限： 3,000 UTC 月あたりの成功リクエスト数、および 30 1分あたりのリクエスト数。バースト上限： 5。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",
  "base_period": "1982-84",
  "base_value": "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	10か国の公式公開元によるCPI、インフレ、労働、GDP、貿易データ。
FX API	現在のレート、換算、ページ分割された履歴。すべてのレートにタイムスタンプがあります。
株式データAPI	普通株式銘柄を発見し、分割調整済みの日次バーを取得します。
公開祝日カレンダー API	国、地域、振替日の範囲を含む公開祝日。
アブラヤシ生果房（FFB）API	地域と樹齢別のインドネシア公式 FFB スケジュール。
SEC 提出 API	企業検索、識別情報、SEC提出書類メタデータ。

国と指標を選択

稼働中のすべての国で、9つの最新リリース操作と、対応する9つの履歴操作を利用できます。 Economics APIリファレンスすべてのパスとレスポンス形式を一覧表示します。

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

MCP経由で接続

MCP クライアントで同じキーとスキーマを使用します。ツール検索には、6つすべての 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件消費します。

レスポンスを読む

各操作のレスポンススキーマを読みます。Economics はドメインオブジェクトを返し、Equities は次を使用します： meta/values 時系列と count/data 銘柄向け。

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

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

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

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

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

まずHTTPステータスを確認し、次に code アプリケーションロジック内。 detail ログとデバッグ用です。エラーとクォータのガイドすべての公開ステータスを一覧表示します。

RFC 9457 問題レスポンス

{
  "ok": false,
  "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",
  "instance": "/v1/economics/USA/cpi"
}

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

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

LLM？ llms.txt を読む。