Bodu.Financial.ExchangeRates.ExchangeRateHost 0.7.1

Bodu.Financial.ExchangeRates.ExchangeRateHost

API stability — Preview. The public API surface is largely settled but is still being finalized ahead of the 1.0 release and may change; breaking changes can land in a minor version until then.

A Bodu.Financial exchange-rate provider backed by the exchangerate.host (api.exchangerate.host) foreign-exchange REST service.

It fetches the exchangerate.host time-series and single-date endpoints, parses the JSON response, and serves the results as Bodu.Financial.ExchangeRates.ExchangeRate values through the standard IDatedRateProvider and IRateProvider contracts — so it composes with Money.ConvertTo, the caching and aggregating providers, and the rest of the Bodu.Financial FX stack. The same interfaces and DI shape as every other provider, a different data source.

using Bodu.Financial.ExchangeRates;

// The provider builds and owns its HttpClient from the options; dispose it to release the client.
using var provider = new ExchangeRateHostRateProvider(new ExchangeRateHostRateProviderOptions { ApiKey = "…" });

// Warm a pair for a range (recommended), then look rates up synchronously.
await provider.LoadPairAsync("EUR", "USD", new DateOnly(2023, 1, 1), new DateOnly(2023, 6, 30));

RateLookupResult usd = provider.GetRate("EUR", "USD", new DateOnly(2023, 1, 3));

Behaviour

• Source + quote. exchangerate.host denominates its response against a source currency and returns the requested quote currencies, keyed by the concatenated {SOURCE}{QUOTE} currency code (for example USDEUR). A pair is fetched by denominating against the source currency and requesting the destination currency as the quote currency.
• Endpoint selection. A one-day request uses the single-date endpoint (the date is carried in the date query parameter); a multi-day range uses the time-series endpoint.
• API key required. Set ApiKey; it is presented as the access_key query parameter.
• No provider-local disk cache. For durable caching, compose with AddCachedRateProvider<…> from the Bodu.Financial.ExchangeRates.Caching package.

Endpoint configuration

Dependency injection

The package ships its own AddExchangeRateHostExchangeRates registration in the Bodu.Financial.ExchangeRates namespace — there is no separate *.DependencyInjection package.

services
    .AddFinancialService(configuration)
    .AddExchangeRateHostExchangeRates(configuration, configure: o => o.ApiKey = "…");

Part of the Bodu utility library.