Exchanges
General information
Exchanges are transfers between client’s wallets denominated in different currencies. An exchange operation consists of two transfers. The first transfer is made from a client’s wallet to the global wallet. The second transfer is made from the global wallet to a client’s wallet denominated in another currency.
On the Exchanges, page you can find information about all exchanges made by Enterprise clients.
To filter the page data, click the down arrow located at the top of the table and adjust the following filter parameters:
ID — the system identifier of an exchange.
Wallet to — the wallet to which funds were credited as a result of an exchange operation.
Wallet from — the wallet from which funds were debited as a result of an exchange operation.
Applicant — the email address of the client who made an exchange.
From user’s transfer ID — the identifier of the transfer made from a client’s wallet to the global wallet.
From global transfer ID — the identifier of the transfer made from the global wallet to a client’s target wallet.
Status — the exchange status. Possible values:
Created — the operation has been created and is in the queue for processing.
Failed — the operation failed in the blockchain.
Success — the operation is successfully completed.
Pending — the operation is being processed.
Click the check mark icon to apply the filters. To reset filters, click the cross icon.
On the Administrative > Exchanges tab, the following data is provided about each exchnage:
- ID
The system identifier of an exchange operation.
- Status
The exchange status. Possible values:
Created — the operation has been created and is in the queue for processing.
Failed — the operation failed in the blockchain.
Success — the operation is successfully completed.
Pending — the operation is being processed.
- From wallet
The client’s wallet from which funds were transferred to the global wallet. This is a link to the wallet details.
- To wallet
The client’s wallet to which funds were credited as a result of an exchange operation. This is a link to the wallet details.
- Amount
The exchange amount in the base currency.
- Rate
The exchange rate.
- Applicant
The client who made the exchange.
- Transfer from user’s wallet
The identifier of the transfer made from a client’s wallet to the global wallet. This is a link to the transfer details.
- Transfer from global wallet
The identifier of the transfer made from the global wallet to a client’s target wallet. This is a link to the transfer details.
- Trading order
The identifier of the order created to hedge the exchange operation, as well as the hedging result (success or fail). This is a link to the order details.
- Markup
The markup value, in percents. This value represents the expected profit from the exchange operation.
- Final markup
The markup value representing the actual profit or loss from the exchange operation.
- Profit (USD)
The profit or loss from the exchange operation before hedging, in USD.
- Profit with hedging (USD)
The profit or loss from the exchange operation after hedging, in USD.
- Created at
The date and time when the exchange operation was created.
- Export
Click this button to download the up-to-date exchanges report or subscribe to automatically receive scheduled reports. For more details, see Reports and Subscriptions.
Exchanges details
To view detailed information about a specific exchange, click the exchange ID.
On the details page, you can view and edit the following information about the exchange:
- Status
The exchange status. Possible values:
Created — the operation has been created and is in the queue for processing.
Failed — the operation failed in the blockchain.
Success — the operation is successfully completed.
Pending — the operation is being processed. The additional message indicating the current processing stage is displayed.
- Amount
The exchange amount, in the base currency (without blockchain fees).
- Rate
The exchange rate. The rate is calculated as follows:
Rate = Backoffice raw rate - Markup
.- Applicant
The client who made the exchange.
- Wallet from
The client’s wallet from which funds were debited as a result of an exchange operation.
- Wallet to
The client’s wallet to which funds were transferred from the global wallet.
- To global
The link to the transfer from a client’s wallet to the global wallet.
- From global
The link to the transfer from the global wallet to a client’s target wallet.
- Trading order
Let’s make it simpler: The identifier of the order created to hedge the exchange operation, as well as the hedging result (success or fail). This is a link to the order details.
On the right side of the page, you can also find the essential Profit and Loss information (PL info):
- Client requested rate
The exchange rate requested by the client. The actual rate differs from the requested rate if the transfer from a client’s wallet to the global wallet was made after the freeze rate time specified in the settings had expired.
- Delivery costs rate to target
The rate of the blockchain fee that is charged for transferring funds from the global wallet to a client’s target wallet.
- Backoffice raw rate
The exchange rate received from a rate provider (without markup). This rate is calculated as follows:
Backoffice raw rate = (Rate * 100) / (100 - Markup)
.- Final rate
The final rate including the markup and transportation fees. Transportation fees are blockchain fees charged for transferring funds from the global wallet to a client’s wallet. This rate is calculated as follows:
Final rate = (Total amount + (delivery_cost * delivery_rate)) / Amount
, where:Total amount is the amount received by a client
Amount is the amount sent by a client
delivery_cost is the amount of transportation fees (dust + blockchain fee)
delivery_rate is the rate of the blockchain currency fee to amount currency
- Markup
The value representing the expected profit from the exchange operation, in percents.
- Final markup
The value representing the actual profit or loss from the exchange operation, in percents. This value is calculated as follows:
Final markup = 100 - (Final rate * 100 / trading_rate)
, where:trading_rate is the rate of the closed exchange order.
For sell orders,
trading_rate
is used for calculations.For buy orders,
1 / trading_rate
is used for calculations.
- Profit base
The profit or loss calculated before hedging, in the base currency. This value is calculated as follows:
Profit base = income_amount + profit_dust - loss_amount - spent_fee
, where:profit_dust is greater than zero only for OMNI tokens
loss_amount is the amount transferred from the global wallet to a client’s target wallet, multiplied by the value of Backoffice raw rate (without markup).
spent_fee is the sum of the dust value and the blockchain fee charged for token transportation. For coins, it is a blockchain fee.
- Profit target
The profit or loss calculated before hedging, in the target currency. This value is calculated as follows:
Profit target = income_amount + profit_dust - loss_amount - spent_fee
, where:income_amount is the amount transferred from a client’s wallet to the global wallet, multiplied by the value of Backoffice raw rate.
profit_dust [TBD] is greater than zero for OMNI tokens. It is a transfer dust charged for the transportation of funds to the global wallet in base currency and multiplied by the reverse rate to the base currency of the transfer from the global wallet to a client’s wallet (
reverse rate = 1 / rate
)loss_amount is the amount transferred from the global wallet to a client’s wallet.
spent_fee is the sum of the dust value and the blockchain fee, multiplied by the value of Delivery costs rate to target that is spent for token transportation to a client’s wallet. For coins, it is a blockchain fee.
- Profit base with hedging
The profit or loss calculated after hedging, in the base currency. This value is calculated depending on the side of the hedging order:
For the Sell side, the formula is as follows:
profit_hedge_base = trade_target - backoffice_target - spent_fee
, where:spent_fee is the dust value and the blockchain fee charged for token transportation. For coins, it’s the blockchain fee.
rate_base [TBD] is a rate to the base currency for an outgoing transfer from the global wallet to a client’s wallet
backoffice_target is the amount transferred from the global wallet to a client’s wallet, in the base currency
trade_target is the value calculated as follows:
trading_order.external_total * rate_base
For the Buy side, the formula is as follows:
profit_hedge_base = backoffice_source - trade_source - spent_fee
, where:profit_hedge_base is a value calculated as follows:
backoffice_source - trade_source - spent_fee
spent_fee is the dust value and the blockchain fee charged for token transportation. For coins, it’s the blockchain fee.
rate_base [TBD] is a rate to the base currency for an outgoing transfer from the global wallet to a client’s wallet
backoffice_source is the amount transferred from a client’s wallet to the global wallet, in the base currency
trade_source is the value calculated as follows:
trading_order.external_total * rate_base
- Profit target with hedging
The profit or loss calculated after hedging, in the target currency. This value is calculated depending on the side of the hedging order:
For the Sell side, the formula is as follows:
profit_hedge_target = trade_target - backoffice_target - spent_fee
, where:spent_fee is the sum of dust and blockchain fee multiplied by the Delivery costs rate to target value that is spent for the token transportation to a client’s wallet; for coins, it is a blockchain fee
backoffice_target is the amount of transfer from the global wallet to a client’s wallet
trade_target is the trading_order.external_total
For the Buy side the formula is as follows:
profit_hedge_target = backoffice_target_from_source - trade_target - spent_fee
, where:spent_fee is the sum of dust and blockchain fee multiplied by the Delivery costs rate to target value that is spent for the token transportation to a client’s wallet; for coins, it is a blockchain fee
backoffice_target_from_source is the transfer amount sent from the global wallet and multiplied by the Backoffice raw rate
trade_target is the value calculated as
trading_order.external_total * Backoffice raw rate