Historical FX rate (convert at a date) API

The exchange rate between two currencies on a specific past date (ECB rates via Frankfurter), and optionally convert an amount. Fills the historical gap our finance/fx (latest) leaves. Answers 'USD to EUR on 2020-03-15', 'GBP/JPY rate on date X', 'convert 100 USD to EUR at date D'.

Price$0.01per request

MethodPOST

Route/v1/finance/fx-historical

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

financefxcurrencyhistoricalexchange-rateconvertforexecb

API URLhttps://x402.hexl.dev/v1/finance/fx-historical

Integration docs

Example request

{
  "date": "2020-03-16",
  "from": "USD",
  "to": "EUR",
  "amount": 100
}

Example response

{
  "requestedDate": "2020-03-16",
  "date": "2020-03-16",
  "from": "USD",
  "to": "EUR",
  "rate": 0.8963,
  "amount": 100,
  "converted": 89.63,
  "note": null
}

Input schema

{
  "type": "object",
  "required": [
    "date",
    "from",
    "to"
  ],
  "properties": {
    "date": {
      "type": "string",
      "examples": [
        "2020-03-16"
      ]
    },
    "from": {
      "type": "string",
      "examples": [
        "USD"
      ]
    },
    "to": {
      "type": "string",
      "examples": [
        "EUR"
      ]
    },
    "amount": {
      "type": "number",
      "default": 1
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}