Skip to content

➕ Adding a Currency Pair

To add a new currency pair to your FX dashboard:

  1. Click "Add Pair" on the FX list page
  2. Select the two currencies using the search dropdown
  3. The system automatically discovers available data routes — both direct and chain routes
  4. Select the route you prefer and click Confirm — the pair is created and data synchronization begins automatically

🛤️ Conversion Routes (Direct & Chain)

When you select a base and quote currency, LibreFolio queries all installed providers to discover the best available exchange rate routes.

Add Pair — Direct Routes Add Pair — Chain Routes

🔗 Direct Routes

If a provider directly supports exchange rates between both currencies (e.g. ECB quoting rates for EUR 🇪🇺 / USD 🇺🇸), the system displays it as a direct route option.

🔀 Chain Routes

For exotic pairs (e.g., RON 🇷🇴 / JPY 🇯🇵) where no single central bank publishes rates directly, the system automatically builds conversion chains — multi-step paths through intermediate currencies (typically EUR 🇪🇺 or USD 🇺🇸).

Chain Example

RON 🇷🇴 → JPY 🇯🇵 via ECB:

  1. RON 🇷🇴 → EUR 🇪🇺 (ECB provides RON 🇷🇴 / EUR 🇪🇺)
  2. EUR 🇪🇺 → JPY 🇯🇵 (ECB provides EUR 🇪🇺 / JPY 🇯🇵)

The final rate is computed by multiplying the intermediate rates.

🧭 How Route Discovery Works

When you select two currencies, LibreFolio queries all installed providers to find:

  • 🔗 Direct routes: a single provider that covers both currencies
  • 🔀 Chain routes: two or more providers that together can connect the currencies through an intermediate currency (e.g., EUR 🇪🇺)

Each route shows:

  • 🏛️ The provider name and icon
  • ➡️ The direction (base → quote)
  • 🔢 For chains: the intermediate currency and the number of hops

You can choose any available route based on your preference for data source, coverage period, or update frequency.

For the Curious: Behind the Scenes

If you are interested in the mathematical details of how multi-hop conversion chains are computed and routed, you can read the developer documentation: FX Configuration & Routing and FX Chain Algorithm.

Note: This technical documentation is only for developers and is not required to use this feature.