Get the current mid-market exchange rate between two currencies. Uses Xe when credentials are set; falls back to Frankfurter (ECB) for free use.

Convert an amount from one currency to another at the current mid-market rate.

List currency codes. Returns common currencies without credentials; the full Xe list (~170 currencies) requires Xe credentials.

Fetch daily mid-market rates for a currency pair over the past N days. Uses Xe when credentials are set; falls back to Frankfurter (ECB) for free use.

Calculate annualised volatility of a currency pair over the past N days. Returns daily std-dev of log-returns and annualised figure — same methodology used in FX options pricing.

Tells you where today's rate sits in the N-day distribution and whether now is statistically favourable to convert. Useful for FX timing decisions.

Snapshot of NZD against all major trading pairs simultaneously (USD, AUD, EUR, GBP, JPY, SGD, CNY). Useful for a quick NZD strength overview.

Compute the Pearson correlation of daily log-returns between two currency pairs over N days. Useful for understanding co-movement: NZD/USD vs AUD/USD typically correlate highly (~0.85). Range: -1 (inverse) to +1 (perfect).

Check whether a currency pair's current rate has crossed a threshold. Returns a boolean verdict and the current rate — designed for use in polling loops or CI checks that trigger alerts.

Render an ASCII line chart of a currency pair's rate history over N days. Shows trend visually in the terminal.

Calculate simple moving averages (SMA) for a currency pair. Returns 20, 50, and 200-day SMAs (or custom period), current rate, and distance from each MA — useful for trend assessment.

One-call morning briefing for a currency pair: current rate, N-day range, annualised volatility, send-window verdict, and SMA(20). Combines get_rate + volatility_analysis + optimal_send_window into a single tool.