← Finance & Currency

Historical Rates

GET /historical/:date

Retrieve exchange rates for any specific past date. Provide a date in YYYY-MM-DD format in the URL path, and optionally filter by base currency and target symbols. Useful for generating historical invoices, auditing past transactions, back-testing trading strategies, and building exchange rate charts. Data sourced from ECB daily reference rates.

Parameters

date required

Date in URL (YYYY-MM-DD)

base optional default: EUR

Base currency

symbols optional

Target currencies

Example Requests

Basic usage
curl "https://nordapi.ee/api/v1/historical/2026-03-15?base=USD"
Rates on a specific date with USD base
curl "https://nordapi.ee/api/v1/historical/2026-03-15?base=USD"
EUR rates for specific currencies on a date
curl "https://nordapi.ee/api/v1/historical/2026-01-01?base=EUR&symbols=NOK,SEK,DKK"
Historical rates on New Year's Day 2025
curl "https://nordapi.ee/api/v1/historical/2025-01-02?base=GBP&symbols=USD,EUR"

Live Response 

HTTP 404: {
  "error": "No rates available for this date",
  "message": "Exchange rates are not available for the requested date.",
  "success": false
}

Example Response

{"success":true,"base":"USD","date":"2026-03-15","rates":{"EUR":0.921,"GBP":0.793}}
← Back to Finance & Currency