Bodu.Financial.ExchangeRates.Fixer 0.7.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Bodu.Financial.ExchangeRates.Fixer --version 0.7.0
                    


                    

                
NuGet\Install-Package Bodu.Financial.ExchangeRates.Fixer -Version 0.7.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Bodu.Financial.ExchangeRates.Fixer" Version="0.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Bodu.Financial.ExchangeRates.Fixer" Version="0.7.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Bodu.Financial.ExchangeRates.Fixer" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Bodu.Financial.ExchangeRates.Fixer --version 0.7.0
                    


                    

                
#r "nuget: Bodu.Financial.ExchangeRates.Fixer, 0.7.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Bodu.Financial.ExchangeRates.Fixer@0.7.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Bodu.Financial.ExchangeRates.Fixer&version=0.7.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Bodu.Financial.ExchangeRates.Fixer&version=0.7.0
                    


                            Install as a Cake Tool

Bodu.Financial.ExchangeRates.Fixer

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 Fixer (fixer.io) foreign-exchange REST service.

It fetches the Fixer 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 FixerRateProvider(new FixerRateProviderOptions { 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

  • Base + quote. Fixer denominates its response against a base currency and returns the requested quote symbols. A pair is fetched by denominating against the source currency and requesting the destination currency as the quote symbol.
  • Endpoint selection. A one-day request uses the single-date endpoint; a multi-day range uses the time-series endpoint.
  • Plan limits. The free plan is locked to a EUR base and to the latest and single-date endpoints; changing the base currency and the time-series endpoint require a paid plan. A request the account's plan does not permit surfaces as a fetch failure, not a pre-empted request — on the free plan, request pairs whose source currency is EUR (or rely on the inverse-lookup fallback).
  • 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

Option Default Purpose
ApiKey (required) The Fixer access key, sent as access_key.
BaseAddress https://data.fixer.io/api/ The API host.
TimeSeriesPath timeseries The multi-day time-series endpoint.
HistoricalPath {date} The single-date endpoint template ({date} placeholder).
HttpTimeout 30 s Applied to the HttpClient the provider creates, or by the DI registration.
AllowSynchronousNetworkAccess false Opt in to blocking on-demand fetches from synchronous lookups.
DefaultLookback 7 days The window fetched around a date for on-demand and latest-rate lookups.
CurrencyAliases empty Maps ISO codes to Fixer symbol components where they differ.

Dependency injection

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

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

Part of the Bodu utility library.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.7.1 82 9/24/2026
0.7.0 216 9/24/2026