get_historical_exchange_rates

Retrieve historical exchange rates for a specific date or range using a base currency. Filter results by target currencies or access all supported currencies. Closest available rates returned if exact data is unavailable.

Instructions

Returns historical exchange rates for a specific date or date range. If the exchange rates for a specified date is not available, the rates available for the closest date before the specified date will be provided. Either a specific date, a start date, or a date range must be provided. The symbols can be used to filter the results to specific currencies. If symbols are not provided, all supported currencies will be returned.

Input Schema

Name	Required	Description
`base_currency`	Yes	A base currency code for which rates are to be requested.
`end_date`	No	The end date, of a date range, for which the historical rates are requested in the YYYY-MM-DD format.
`specific_date`	No	The specific date for which the historical rates are requested in the YYYY-MM-DD format.
`start_date`	No	The start date, of a date range, for which the historical rates are requested in the YYYY-MM-DD format.
`symbols`	No	A list of target currency codes for which rates against the base currency will be provided. Do not provide it to request all supported currencies.

Input Schema (JSON Schema)

{
  "properties": {
    "base_currency": {
      "description": "A base currency code for which rates are to be requested.",
      "title": "Base Currency",
      "type": "string"
    },
    "end_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The end date, of a date range, for which the historical rates are requested in the YYYY-MM-DD format.",
      "title": "End Date"
    },
    "specific_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The specific date for which the historical rates are requested in the YYYY-MM-DD format.",
      "title": "Specific Date"
    },
    "start_date": {
      "anyOf": [
        {
          "format": "date",
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "The start date, of a date range, for which the historical rates are requested in the YYYY-MM-DD format.",
      "title": "Start Date"
    },
    "symbols": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "A list of target currency codes for which rates against the base currency will be provided. Do not provide it to request all supported currencies.",
      "title": "Symbols"
    }
  },
  "required": [
    "base_currency"
  ],
  "type": "object"
}

FrankfurterMCP