Queries the bid and offer rates of each currency against the base currency for the current Broker channel. Used to convert multi-currency amounts into one currency for display in the Broker App, such as converting amounts on deposit and withdrawal pages and summing cash and holdings in the selected currency on the asset overview.
Rates are returned under universal_exchanges.<account_channel>.spec_exchanges.<group>.exchanges. Asset conversion reads the am group, and reads the key group when am is missing.
To convert an amount in currency A into currency B, take the two rate items whose other_currency is A and B:
- Positive amount: amount ×
bid_rate of A ÷ offer_rate of B
- Negative amount: amount ×
offer_rate of A ÷ bid_rate of B
No conversion is needed when A and B are the same. When no rate exists for B, display the original amount.
WhaleCore converts fees, limits, and coupon face-value currencies in order previews internally, and you don't need to (and cannot) fetch rates from WhaleCore. Call this operation only when the Broker App displays converted amounts itself.