math_currency_converter_history
Fetch historical daily exchange rates for a currency pair over a trailing date range. Returns open, high, low, close data for charting price movement and percentage change.
Instructions
Currency Converter Historical Rate Series. Fetch a historical end-of-day (EOD) FX rate series for one currency pair over a trailing date range, for charting price movement and percentage change. Returns success plus a data object holding the resolved from/to codes, the window start and end dates, and a series array of daily candles (date, open, high, low, close), plus the resolution path (direct, triangulation through USD, or identity). Data comes from a local cache of EODHD daily forex data; a first-time or stale range triggers an on-demand outbound fetch from EODHD, so the series is live external data that changes day to day and the call is not idempotent. Use this for a multi-day time series of a currency pair; use math_currency_converter_convert for a single present-day amount conversion, and math_unit_converter for non-currency length, mass, volume, or speed conversion. Rate-limited (30 req/min anonymous) to protect the upstream API quota.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | Yes | Base ISO 4217 currency code (3 letters, case-insensitive). Must be one of the 31 supported codes. | |
| to | Yes | Quote ISO 4217 currency code (3 letters, case-insensitive). Same 31-code enum as from; equal from/to returns a flat series of 1. | |
| days | No | Length of the trailing window in calendar days back from today. Must be between 7 and 1825 (about 5 years); defaults to 90 when omitted. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| success | No | True when the series was retrieved. | |
| data | No |