Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blnkfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

This feature will be deprecated in the future. For multi-currency transactions, we recommend using the Currency Exchange approach instead.
Blnk also supports recording transactions between ledger balances of different asset classes using the rate field.
Important: Avoid applying rates to transactions within the same currency, as it is unnecessary and redundant.
Let’s dive in ✨ What we’ll cover …
  1. Applying rates
  2. Key considerations

​
1: Applying rates

Consider a transaction record sending USD 2,290.19 from a USD balance to a GBP balance. The first thing is to calculate the exchange rate value against the source, i.e., by how much should you multiply the transaction amount to convert from the source’s currency to the destination’s currency. In our example, 1 USD = 0.79 GBP. This means "rate": 0.79.
Request
{
  "reference": "ref_1234567890",
  "amount": 2290.19,
  "currency": "USD",
  "precision": 100,
  "rate": 0.79,
  "source": "bal_usd",
  "destination": "bal_gbp"
}
Failing to specify a rate value for transactions between currencies can result in incorrect destination balances and ledger discrepancies. Always include an exchange rate to ensure accuracy.

​
What happens next

  1. Blnk applies the rate to the transaction amount: 2290.19 * 0.79 = 1803.09
  2. Blnk applies the precision to the converted amount: 1803.09 * 100 = 180309
  3. Blnk records the amount as 180309 in bal_gbp, and 229019 in bal_usd and computes their balances.

​
Need help?

We are very happy to help you make the most of Blnk, regardless of whether it is your first time or you are switching from another tool. To ask questions or discuss issues, please contact us or join our Discord community.