Multi-currency and exchange rates

Bluecoins is a multi-currency app by design. An account can be denominated in any world currency, each transaction records the exchange rate in effect when it was created, and the app converts everything into your default currency for totals and reports. Cryptocurrencies are supported as account currencies too.

How rates are stored

Two levels of rate apply:

• Per-account conversion rate — each account has its own currency and conversion rate against your default currency, set in account setup.
• Per-transaction rate — when you record a foreign-currency transaction, the form records the exchange rate used for that entry, and you can change it.

Because every transaction carries its own rate, historical entries keep the value they had when you made them — which is exactly what the EACR toggle in the balance sheet reasons about when it decides how to normalize balances.

Live exchange rates

The app can fetch current rates automatically, and it is engineered so that a single failed provider never leaves you without a rate:

• Provider fallback — rates are tried from a chain of providers. Free providers are tried first (shuffled), then keyed providers as a backstop, then the app falls back to 1.0 if all fail.
• A 30-second cache — repeated lookups for the same currency pair within a short window reuse the cached rate instead of hitting the network again.
• A circuit breaker — a provider that fails is skipped for a cooldown period, so one slow or down service cannot stall a lookup; a recovered provider is tried again on its next success.

The rate engine ships with 14 providers covering free fiat, keyed fiat, and crypto — including the Venezuelan bolívar, which uses official BCV rates from dolarapi, and Kraken for selected crypto pairs. Crypto-to-fiat and crypto-to-crypto conversions are supported (crypto pairs convert through USD).

Conversion in reports

Net worth and balance-sheet totals convert into your default currency using the account rates, so a wallet full of foreign cash still counts toward your net worth in the currency you think in. The EACR toggle controls how foreign-currency transaction amounts are normalized inside the balance views — see the balance sheet guide for the details.

Same-currency shortcuts

Two practical details keep things predictable: converting a currency into itself always returns exactly 1.0 (no network call), and when a transaction’s currency matches the account’s currency, no conversion is needed at all.

Multi-currency works with everything else in the app — transfers between accounts in different currencies, credit cards in a foreign currency, and reports that mix accounts — because the rate is attached to the entry, not to the report.