過去の為替レート API

リクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD/observations?currencies=EUR,NZD&start_date=2026-08-20&end_date=2026-08-28&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

MCP ツールは次のとおりです： fx_get_rate_history。その currencies 入力は JSON 配列です。それ以外のフィールドはすべて同じ意味です。

レスポンス

{
  "base": "USD",
  "start_date": "2026-08-20",
  "end_date": "2026-08-28",
  "observations": [
    {
      "date": "2026-08-20",
      "rates": [
        { "currency": "EUR", "rate": "0.85609" },
        { "currency": "NZD", "rate": "1.681" }
      ]
    },
    {
      "date": "2026-08-21",
      "rates": [
        { "currency": "EUR", "rate": "0.85477" },
        { "currency": "NZD", "rate": "1.6714" }
      ]
    },
    {
      "date": "2026-08-24",
      "rates": [{ "currency": "EUR", "rate": "0.85734" }]
    }
  ],
  "next_cursor": null,
  "has_more": false
}

各レートは小数文字列です。1単位の base 返される金額に相当： currency その観測日について。

ページ分割

limit 日付を数えるため、1つの日付の通貨レコードがページ間で分割されることはありません。次の場合： has_more true の場合は指定： next_cursor 同じ基準通貨、通貨、開始日、終了日で戻ります。カーソルはフィルター境界に結び付いており、これらの値を変更すると次を返します： 400 invalid_cursor.

日付範囲全体の上限はありません。全履歴のバックフィルでは、次の状態になるまで同じ上限付きページを繰り返し使用します： next_cursor null です。

欠落した日付と通貨は捏造されません

実際に保存された観測日だけが表示されます。週末、祝日、その他の公開されていない日付は省略されます。Narwhal はそれらを前方補完しません。

日付には、リクエストした通貨の一部だけが含まれる場合があります。例では、8月24日にNZDのレコードはありませんが、EURにはあります。これは正確な疎な観測値であり、部分レスポンスのエラーではありません。

エラー

• 400 invalid_query 無効な通貨、日付、ページサイズ向け。
• 400 invalid_cursor 形式不正またはフィルター不一致のページ分割状態向け。
• 401 invalid_api_key Bearer キーがないか無効な場合。
• 404 currency_not_supported 選択した通貨を利用できない場合。
• 429 rate_limit_exceeded 短時間上限に達した場合。次を待ちます： Retry-After 再試行する前に。
• 429 quota_exhausted 共有月間クォータを使い切った場合。
• 503 upstream_unavailable 受け入れ済みの履歴データを安全に読み取れない場合。

確認： エラーと上限のガイド 2種類のレート制限ヘッダーと再試行動作向け。

カバレッジと制限

カバレッジの開始日は通貨によって異なります。対応する保存系列で最も早いものは1971年に始まり、日次カバレッジの大半は1999年または2000年に始まります。この契約を変更せずにカバレッジが広がる場合があります。

このインターフェースは、以前のすべての公開版ではなく、現在受け入れられている履歴系列を返します。ソース、プロバイダー、ライセンス、導出、古さ、市場セッションのフィールドは省略します。次をお読みください： FX の方法論 公開データポリシーと次のもの向け： FX プロダクトページ すべての稼働中操作向け。