Multi-currency wallets and liquidity management
Mirror user swaps on Blaaiz to keep wallet liquidity balanced across currencies
If your platform manages user balances internally and supports multi-currency wallets, you can mirror your users' currency swaps on Blaaiz to keep your liquidity balanced across currencies.
How it works
Step-by-step
- User requests a swap — Your user wants to convert funds between currencies in your app (e.g. USD to NGN).
- Preview the rate — Call Fee breakdown to show the user the exchange rate and fees before confirming.
- Execute the swap — Call POST /swap with your
from_business_wallet_id,to_business_wallet_id, andamount. Useamount_type: "from"to specify how much to debit, oramount_type: "to"to specify how much the destination wallet should receive. - Update your user's balance — The swap response includes the exact
from_amount,to_amount, andfrom_exchange_rateapplied. Use these to update the user's balances in your system.
Swaps are between your own business wallets — both wallets must belong to the same business and hold different currencies. The swap executes instantly and the response includes the final amounts and rate applied.
Why mirror swaps on Blaaiz?
Even if you manage user balances in your own database, executing a corresponding swap on Blaaiz ensures your business wallet balances stay aligned with your users' aggregate holdings. Without this, you may end up with excess liquidity in one currency and a deficit in another — which would block payouts.