すべてのAPI

為替レート API

RESTまたはMCPで現在の為替レートを取得できます。同じAPIキーで金額の換算や保存済みの過去レートの取得もできます。

最初のリクエスト

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/rates/USD?currencies=EUR,JPY" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "base": "USD",
  "market_session": "open",
  "rates": [
    {
      "currency": "EUR",
      "rate": "0.9200",
      "timestamp": "2026-08-22T06:29:41Z",
      "stale": false
    },
    {
      "currency": "JPY",
      "rate": "147.23",
      "timestamp": "2026-08-22T06:29:39Z",
      "stale": false
    }
  ]
}

換算

現在の参考為替レートを使って対応通貨間の金額を換算します。各結果にはレート、タイムスタンプ、市場セッションの情報が含まれます。

curl --request GET \
  --url "https://api.narwhalapi.com/v1/fx/convert?from=USD&to=JPY&amount=100.00" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "from": "USD",
  "to": "JPY",
  "rate": "147.23",
  "converted": "14723",
  "market_session": "open",
  "timestamp": "2026-08-22T06:29:39Z",
  "stale": false
}

レート履歴

通貨と日付範囲で過去の為替レートを取得します。実際の欠落を保持した保存済み観測値をページ単位で取得できます。

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"

レスポンスの例説明用レスポンス · 実際のリクエストによるものではありません

{
  "base": "USD",
  "observations": [
    {
      "date": "2026-08-20",
      "rates": [
        {
          "currency": "EUR",
          "rate": "0.85609"
        },
        {
          "currency": "NZD",
          "rate": "1.681"
        }
      ]
    }
  ],
  "next_cursor": null
}