Admin Guide

Getting Started

Authorization and 2FA

To get access to the Admin Panel, you should have an active profile in the system. Use credentials provided by the exchange administrator to log in.

Note

In case of an error, check the login and password, input language and Caps Lock state. If everything appears to be correct, contact the administrator to clarify the status of your profile.

2FA

We recommend that you enable two-factor authentication for users with administrator permissions, after which they will be prompted to enter a unique temporary 2FA verification code upon singing in. This code is sent to the user email upon each login attempt.

General Interface Options

The Admin Panel provides ready access to exchange parameters displayed in various sections and subsections accessed via the main menu on the left. Some of them are organized into tabs where you can find information related to a specific task.

All Admin Panel sections share a uniform interface and provide basic functionality, such as search, sorting and data export, as described below.

In some sections, you can access additional information related to a data record at hand by doing one of the following:

  • clicking a data row to expand it and show additional information on the same screen

  • clicking an ellipsis button displayed on the right side of a data row to navigate to a separate detail screen

Lengthy emails and nicknames that cannot be displayed in full due to column width settings are shortened. You can hover the mouse cursor over these fields to view their full text.

When information is likely to appear in various contexts (such as details about specific users or orders), you can expect to find it in different sections. Such redundancy is also helpful in that all essential data is always available to any user regardless of user permissions and roles.

Sorting

Information in the Admin Panel sections is presented in tables and you can sort and filter the displayed data.

To find out whether you can sort table data by a particular field, hover the mouse cursor over a corresponding column header. If sorting by this field is supported, you will see an arrow next to it indicating the available sorting options:

  • Arrow inactive — sorting by this field is disabled

  • Up arrow (active) — descending sorting by this field is enabled (you can click the arrow to enable ascending sorting)

  • Down arrow (active) — ascending sorting by this field is enabled (you can click the arrow to enable descending sorting)

Note

You can sort table data only by a single field at a time.

Filters

The funnel button displayed in some of the sections indicates that you can specify custom search filters. You can click this button to open a filter window and enter desired values. The set of available filtering parameters varies for different sections. The displayed input corresponds to a parameter type: it can be text, number, date, selector, etc. Typically, two values are required for filtering by a time interval: the start date and the end date. You can enter these values manually or select them using the calendar tool.

To enable filtering, click the Apply filters button. To disable filtering, click Reset filters.

In some sections, you can choose among predefined quick filters to filter data by a specific parameter, such as a user status or time interval. To enable these filters, use the corresponding buttons displayed above data tables.

Pagination

Most of the screens support pagination and display data on multiple pages. You can instantly navigate to a specified page or use the left and right arrows to switch to the previous or next page.

In some sections, the Shown on page option is provided so that you can specify the number of rows displayed on each page.

Copying Values

In some sections, the option to copy certain values to the clipboard is provided. A corresponding button is displayed upon hovering the mouse cursor over a value. For example, you can copy a user nickname or email displayed in the Users section.

Data Export

The data displayed in some of the Admin Panel sections can be exported to an Excel file by clicking the XLS button.

While the file is being created, you can track the export progress in the download menu displayed at the top of the screen. All created Excel files that have not yet been downloaded are listed on this menu. You can download a file by clicking the arrow button displayed next to it.

Note

The data included in the created Excel file will match the currently applied sorting and filtering criteria.

Exporting large quantities of data may take a lot of time. For this reason, we recommend that you limit the number of data records included in the resulting Excel file: for example, you can filter data by a time range and/or other criteria.

Users

In the Users section, you can see a list of exchange users registered in the system.

You can display the user data in a table form or in tiles using the corresponding options available at the top right screen section.

General Info

The following user data is displayed in this section:

Nickname/Email

Indicates the user email and nickname displayed in the B2Core UI.

You can copy these values to the clipboard by clicking a button displayed next to these fields.

Role

Indicates the roles currently assigned to a user.

To view information about users with a specific role, you can switch to a corresponding tab at the top of the screen.

Status

Indicates the current user profile status.

To display user profiles with a specific status, click a corresponding button at the top of the screen (Active, Terminated, Frozen or All).

Country

Indicates the country where a user resides determined based on the latest session IP address.

Ag. Balance (root asset)

Indicates the user’s aggregate balance, meaning the amount of all assets available to a user in conversion to a root asset of the exchange (for example, USD).

API

Indicates whether a user has been provided with API keys that are currently enabled in the B2Core UI granting the user access to the trading API.

Last login

Indicates the most recent date and time when a user has logged in to the system (according to the current time zone settings).

Created at

Indicates the date and time when a user profile was created (according to the current time zone settings).

Details

The following tabs are available in the User Details section displayed upon clicking a user profile on the previous screen:

Balances

Provides information about current balances on user deposit accounts.

Transfers

Displays a list of transfers made by a user.

Historical Executions

Displays a list of executed orders placed by a user. The following information is provided about each order:

Market

Indicates the currency pair

Order Type

Indicates the order type

Side

Indicates the order side (buy or sell)

Execution Price

Indicates the trade price at which an order has been executed

Based Amount

Indicates the amount of a traded base asset

Quote Amount

Indicates the amount of a traded quote asset

Commissions

Indicates the commission charged for an order

Commission Currency

Indicates the asset in which the commission was charged

Status

Indicates the current order status

Executed At

Indicates the date and time when an order has been executed (according to the current time zone settings)

Order ID

Indicates the order ID

Open Orders

Displays a list of open orders placed by a user and awaiting execution. The orders placed during the last week are displayed in this list by default.

The following information is provided about each order:

Order ID

Indicates the order ID

Market

Indicates the currency pair

Order Type

Indicates the order type

Side

Indicates the order side (buy or sell)

Quantity

Indicates the overall order amount, in a quote asset

Filled

Indicates the filled order amount, in a quote asset

Remaining

Indicates the unfilled order amount, in a quote asset (Remaining = Quantity – Filled)

Limit Price

For limit orders, indicates the order limit price

Created At

Indicates the date and time when an order has been placed (according to the current time zone settings)

Login Info

Displays information about user sessions, including the date and time when a user has been logged in to the system, the IP address of each session and a corresponding country.

Note

In the User Details section, you can click the gear icon located next to the pane displaying the user status, role, nickname and email. In the opened Basic info menu, you can customize user roles and status.

Transfers

In the Transfers section, you can view a history of all deposit and withdrawal operations performed by each user.

General Info

The following order data is displayed in this section:

Time

Indicates the date and time of a transfer (according to the current time zone settings)

Email

Indicates the email of a user who made a transfer

Type

Indicates the transfer type (deposit or withdrawal)

Asset

Indicates the traded asset code (such as BTC for bitcoin)

Amount

Indicates the executed order amount

Amount (root asset)

Indicates the executed order amount, in conversion to a root asset of the exchange (for example, USD)

Role

Indicates the role assigned to a user who made a transfer

Details

Enables you to access detailed information about an order by clicking the information icon (in case of rolled back trades, the order ID and trade ID are displayed in this field)

Transfer ID

Indicates the transfer ID

RateToRoot asset

Indicates the conversion rate applied upon converting an asset to a root asset of the exchange (for example, USD)

Status

Indicates the current status of a transfer operation:

  • Awaiting Confirmation — a withdrawal transfer request has been created and is awaiting confirmation

  • Pending — a deposit transfer request has been created and is awaiting completion

  • Completed — all operations related to transfer processing have been completed

  • Failed — a transfer operation has failed

  • Canceled — a transfer has been canceled

Details

The following tabs are available in the Transfers Details section displayed upon clicking a transfer on the previous screen:

Transfers

Displays a table containing the same fields as the table in the Transfers section.

Balances tab

Provides information about current balances on user deposit accounts.

Transactions

In the Transactions section, you can find information about all transactions made on the exchange as part of executed trades and orders.

Depending on whether you need to view the data about specific orders or trades, you can switch to a corresponding page in this section.

Note

While execution of a single order may involve multiple trades (which is the case with a limit order that may be filled in several portions), executing a single trade can also require closing multiple orders: for example, if the order book lists 10 open orders, each selling 0.1 BTC, and another user places an order to buy 1 BTC, these 10 orders will be executed as part of a single trade.

Trades

In this subsection, you can find a list of the most recent trades sorted by their execution date.

General Info

The following data is displayed in this subsection:

E-mail

Indicates the email of a user who executed a trade

Side

Indicates the trade side (buy or sell)

Base Amt

Indicates the traded amount, in a base asset

Quote Amt

Indicates the traded amount, in a quote asset

Total Base Amt

Indicates the traded amount (before commission), in a base asset

Total Quote Amt

Indicates the traded amount (before commission), in a quote asset

Ex. Price

Indicates the trade execution price

Market

Indicates the currency pair

Order Type

Indicates the order type

Order Status

Indicates the current order status

Role

Indicates the roles assigned to a user who executed a trade

Executed At

Indicates the date and time when a trade has been executed (according to the current time zone settings)

Extended Info

Upon clicking a trade in the list, you can view detailed information about orders related to this trade.

Note

If a trade was executed based on multiple matched orders, a separate record is displayed for each order. For trades executed based on a single matched order or a fraction of it, a single record is displayed in the detail section.

Trade ID

Indicates the trade ID

Order ID

Indicates the ID of an order related to a trade

Commission Fee

Indicates the commission rate applied to a trade (in percents) according to a specified tier

Remaining Amt

Indicates the associated order’s amount that has not yet been filled

Commission Asset

Indicates the asset in which a commission was charged and the commission amount

CounterParty ID

Indicates a trade counterparty (if any)

Orders

In this subsection, you can view a list of orders along with data related to their execution. The orders placed during the last week are displayed by default.

General Info

The following data is displayed in this subsection:

E-mail

Indicates the email of a user who placed an order

Order ID

Indicates the order ID

Time in Force

Indicates the Time in Force setting applied to an order

Market

Indicates the currency pair

Order Type

Indicates the order type

Order Status

Indicates the current order status

Role

Indicates the roles currently assigned to a user who placed an order

Created At

Indicates the date and time when an order was created (according to the current time zone settings).

Completed At

Indicates the date and time when an order was executed (according to the current time zone settings).

Extended Info

Upon clicking an order in the list, you can view detailed information about it.

Side

Indicates the order side (buy or sell)

Quantity

Indicates the stated order amount, in a quote asset

Avg. Fill Price

Indicates the average execution price, which is helpful for evaluating orders executed in multiple trades

Limit Price

For limit orders, indicates the order limit price

Filled

Indicates the filled order amount, in a quote asset

Remaining

Indicates the unfilled order amount, in a quote asset (Remaining = Quantity – Filled)

API Keys

Indicates whether a user has been provided with API keys that are currently enabled in the B2Core UI granting the user access to the trading API.

Balances

In this section, you can find information about current balances on user deposit accounts. You can display information about a specific user or asset by switching to a corresponding subsection.

Balances by Users

In this subsection, you can see a list of all exchange users and find information about their balances.

Note

To view information about users with a specific role, you can switch to a corresponding tab at the top of the screen. You can use a quick search to find a user by a nickname or email.

General Info

The following data is displayed in this subsection:

E-mail

Indicates the user email

Role

Indicates the roles currently assigned to a user

Status

Indicates the current user profile status

Ag. Balance (root asset)

Indicates the user’s aggregate balance, meaning the total amount of all available user assets in conversion to a root asset of the exchange (for example, USD)

Extended Info

Upon clicking a row in the users list, you can view detailed information about user assets.

Asset

Indicates the asset code (such as BTC for bitcoin)

Total Amount Asset

Indicates the total amount of a specified asset remaining on a user’s deposit account: (Total assets = Available assets + Locked assets)

Available Amount Asset

Indicates the amount of a specified asset that remains at a user’s disposal and can be withdrawn from a corresponding deposit account considering all open limit orders on this market placed by the user by this time: (Available assets = Total assets - Locked assets)

Locked Asset

Indicates the total amount of a specified asset that has been reserved for open limit orders placed by a user and cannot be withdrawn from the deposit account: (Locked assets = Total assets - Available assets)

Locked (root asset)

Indicates the amount of user’s locked assets, in conversion to a root asset of the exchange (for example, USD)

Available Amount (root asset)

Indicates the amount of assets available to a user, in conversion to a root asset of the exchange (for example, USD)

Total Amount (root asset)

Indicates the total amount of assets remaining on a user’s deposit account, in conversion to a root asset of the exchange (for example, USD)

RateToRoot asset

Indicates the conversion rate applied upon converting an asset to a root asset of the exchange (for example, USD)

Details

To view detailed information about operations with a specific user asset, hover the mouse pointer over the end part of a corresponding row and click the displayed ellipsis button.

The following tabs are available on the displayed Balance Details screen:

Transfers

Provides information about transfers made by a user. Information displayed on this tab is similar to the one presented in the Transfers section.

Open Orders

Provides information about orders opened during the last week by a user.

You can change the time range settings and apply other filters by clicking the funnel button displayed at the top of this tab.

The following information is displayed on this tab about each order:

Status

Indicates the current order status

Created At

Indicates the date and time when an order has been placed (according to the current time zone settings)

Order ID

Indicates the order ID

Market

Indicates the currency pair

Side

Indicates the order side (buy or sell)

Order Type

Indicates the order type

Filled

Indicates the filled order amount, in a base asset

Remaining

Indicates the unfilled order amount, in a base asset

Closed Orders

On this tab, you can find information about orders placed by a user and closed during the last week.

Assets

On this tab, you can find information about balances on user deposit accounts. Information displayed on this tab is similar to the one presented in the Balances by Users section upon loading user details.

Balances by Assets

In this section, you can find information about the current balances on various user deposit accounts.

You can type an asset code (for example, BTC) in the quick search field to display a list of users who have opened deposit accounts on a corresponding market.

Upon clicking a row in the users list, you can see detailed information about the current balances on user deposit accounts. Information displayed in this list is similar to the one presented in the Balances by Users section upon loading user details.

Commissions

In this section, you can find information about commissions charged for a specific asset and the total commissions paid by an individual user, a user group or all users of the exchange. You can export this data to an Excel file, monitor total asset volumes traded on the exchange and configure tiers to introduce varying maker and taker fees for any market.

Asset Commissions

In this subsection, you can find information about commissions charged for each asset.

Totals

The following summary information is displayed at the top of this screen (these values are converted to a root asset of the exchange):

Total Asset Amount (root asset)

Indicates the total volume of assets available on deposit accounts of all users of the exchange

Total Commission (root asset)

Indicates the total commission charged for all assets traded on the exchange

Total Volume (root asset)

Indicates the total volume of assets traded on the exchange

Total PnL (root asset)

Indicates the total profit-loss in all assets traded on the exchange

Note

You can display summary information for a specific time range by clicking the funnel button located at the top of the screen.

General Info

The following information is displayed in this section about each asset traded on the exchange:

Asset

Indicates the asset code (such as BTC for bitcoin)

Asset Amount

Indicates the total asset amount available for trade on the exchange

Asset Amount (root asset)

Indicates the total asset amount available on the exchange, in conversion to a root asset of the exchange (for example, USD)

Commission Amount

Indicates the total commission charged for all operations with an asset

Commission (root asset)

Indicates the total commission charged for an asset, in conversion to a root asset of the exchange (for example, USD)

Volume (root asset)

Indicates the currently traded volume of an asset, in conversion to a root asset of the exchange (for example, USD)

Realized PnL (root asset)

Indicates the net profit-loss resulting from the actual asset trades, based on the history of executed trades. This value is converted to a root asset of the exchange (for example, USD).

Realized profit-loss is re-calculated once every 24 hours and the displayed metric corresponds to the value obtained for the previous day.

Unrealized PnL (root asset)

Indicates the net profit-loss that would result from a hypothetical closure of all positions currently opened in an asset and depends on fluctuations of its price. This value is converted to a root asset of the exchange (for example, USD).

Once an asset has been traded, its Unrealized PnL becomes zero and its actualized profit-loss is reflected in Realized PnL.

Details

The following tabs are displayed upon clicking a row in the assets list:

Trades

On this tab, you can see a list of all trades made with a selected asset.

You can click the funnel button at the top of this tab to filter the displayed data: for example, you can display only trades with a specific side (buy or sell) executed on a certain market (meaning a currency pair).

The following information is provided on this tab about each trade:

E-mail / Time

Indicates the email of a user who executed a trade along with the date and time when the trade has been executed

Market / Side

Indicates the currency pair and trade side (buy or sell)

Execution ID / Order ID

Indicates the trade and order ID

Transfers

On this tab, you can find information about asset transfers.

You can click the funnel button at the top of this tab to filter the displayed data: for example, you can display only transfers of a specific type (deposit or withdrawal) involving a selected asset.

User Commissions

In this subsection, you can find information about commissions paid by users.

Note

To view information about users with a specific role, you can switch to a corresponding tab at the top of the screen. You can use a quick search to find a user by a nickname or email.

Totals

The following summary information is displayed at the top of this screen (these values are converted to a root asset of the exchange):

Total Commission (root asset)

Indicates the total commission amount charged for all assets traded on the exchange

Total Volume (root asset)

Indicates the total volume of assets currently traded on the exchange

Total PnL (root asset)

Indicates the net profit-loss across all user portfolios, based on the history of executed trades. This value is converted to a root asset of the exchange (for example, USD).

Note

You can display summary information for a specific time range by clicking the funnel button located at the top of the screen.

General Info

The following information is displayed in this section about each user:

E-mail

Indicates the user email

Role

Indicates the roles currently assigned to a user

Status

Indicates the current user status

Ag. Balance (root asset)

Indicates the user’s aggregate balance, meaning the total volume of all user assets converted to a root asset of the exchange (for example, USD)

Commissions (root asset)

Indicates the total commission amount paid by a user for all assets, in conversion to a root asset of the exchange (for example, USD)

Traded Volume (root asset)

Indicates the overall volume of assets traded by a user, in conversion to a root asset of the exchange (for example, USD)

Realized PnL (root asset)

Indicates the net profit-loss calculated based on the history of trades executed by a user. This value is converted to a root asset of the exchange (for example, USD).

Realized PnL is calculated once every 24 hours and the displayed metric corresponds to the value obtained for the previous day.

Unrealized PnL (root asset)

Indicates the net profit-loss calculated based on continuous fluctuations of the price of assets traded by a user. This value is converted to a root asset of the exchange (for example, USD).

Once an asset has been traded, its Unrealized PnL becomes zero and its actualized profit-loss is reflected in Realized PnL.

Details

The following tabs are displayed upon clicking a row in the users list:

Assets

On this tab, you can find information about commissions charged for each of the assets traded by a user.

Information displayed on this tab is similar to the one presented in the Asset Commissions section.

All Commissions

On this tab, you can find detailed information about commissions paid by a user for each trading operation.

The following information is available on this tab:

E-mail / Time

Indicates the email of a user who executed a trade along with the date and time when the trade has been executed

Asset

Indicates the traded asset in which a commission was charged

Execution ID / Order ID

Indicates the trade and order ID

Market / Side

Indicates the currency pair and trade side (buy or sell)

Base Amount

Indicates the traded amount, in a base asset

Quote Amount

Indicates the traded amount, in a quote asset

Ex. Price

Indicates the asset price at which a trade has been executed

Maker / Taker

Indicates whether a trade has increased the overall market liquidity (in which case a lower maker fee is charged for it) or diminished it (in which case a higher taker fee is charged)

Comm. Amount

Indicates the commission charged for a trade, displayed both in an asset in which it was charged and in a root asset of the exchange (for example, USD)

Tiers

You can encourage trading on any market by charging different maker and taker fees depending on the traded amount and custom preferences.

At the top of the screen, you can select a tier group which is essentially a group of markets. To manage markets in a selected group, click the gear button next to the group selector. To create a new market group, click the plus button and specify the group title.

The following tabs are available in this subsection:

Markets

On this tab, you can manage the markets (currency pairs) to which a selected tier is applicable.

You can add a new currency pair by clicking Add Market and selecting a required option in a drop-down list.

Tiers

On this tab, you can manage the tiers included into a selected group.

You can add a new tier by clicking Add Tier and specifying the following tier settings:

Description

Specifies the tier description

Volume

Specifies the minimum asset volume to be traded before special fees apply to a trade

Currency (read-only)

Indicates the root asset of the exchange

Maker Fee

Specifies the commission rate applied to market makers providing liquidity to the exchange

Taker Fee

Specifies the commission rate applied to market takers diminishing liquidity of the exchange

Group ID

Specifies the user group for which the created tier will be introduced

VIP Commission

On this tab, you can configure personalized commission rates applied to valuable exchange users.

To create a new VIP tier, click Add Commission and specify the following tier settings:

ID (read-only)

Indicates the tier ID

roles

Specifies the user roles to which this tier applies

Dealing

In the Dealing section, you can monitor trades in real-time and assess trading strategies employed by exchange users, as well as cancel and roll back trades and find information about aggregate balances on user trading accounts opened on various markets.

Trade Monitor

In this subsection, you can monitor trades executed on the exchange in real time.

The Trade Monitor is disabled by default and no data is displayed in a corresponding table. To enable monitoring, select the time interval (1, 3, 5 or 8 minutes) at which the data should be updated and click Run Monitoring. While the incoming data is being processed, information about the trades is updated and displayed on this screen.

General Info

The following information related to trades is displayed in this section:

E-mail

Indicates the email of a user who executed a trade

Execution ID

Indicates the trade ID

Order ID

Indicates the ID of an order related to a trade

Market ID

Indicates the currency pair

Order Type

Indicates the order type

Order Status

Indicates the current order status

Role

Indicates the roles currently assigned to a user who executed a trade

Executed At

Indicates the date and time when a trade has been executed (according to the current time zone settings)

Extended Info

The following information is displayed upon clicking a row in the trades list on clicking the Show all details button at the top of the screen:

Side

Indicates the trade side (buy or sell)

Remaining Amt

Indicates the trade amount that has not yet been filled

Base Amt

Indicates the traded amount, in a base asset

Quote Amt

Indicates the traded amount, in a quote asset

Ex. Price

Indicates the asset price at which a trade has been executed

Commission (root asset)

Indicates the commission amount charged for a trade, in conversion to a root asset of the exchange (for example, USD)

API

Indicates whether a trade has been executed via the trading API or UI.

You can click the funnel button at the top of the screen to filter the displayed data: for example, you can display only trades executed on a certain market within a specified amount range.

After monitoring is enabled, you can switch to other Admin Panel sections without interrupting the process.

To stop monitoring, click a corresponding button at the top of the screen.

Risk Monitor

In this subsection, you can find aggregate information about all assets traded on the exchange, based on which you can find out whether there are any risks posed to your users’ assets.

Note

The data displayed on this page is updated every 60 seconds.

Totals

The following summary information is displayed at the top of this screen (these values are converted to a root asset of the exchange):

Amount (root asset)

Indicates the total volume of assets available on deposit accounts of all users of the exchange

Volume (root asset)

Indicates the total volume of assets traded on the exchange

PnL (root asset)

Indicates the net profit-loss calculated for all assets traded on the exchange

General Info

The following information is displayed in this section about each asset traded on the exchange:

Asset

Indicates the asset code (such as BTC for bitcoin)

Asset Amount

Indicates the total asset amount available for trade on the exchange

Amount (root asset)

Indicates the total asset amount available on the exchange, in conversion to a root asset of the exchange (for example, USD)

Volume (root asset)

Indicates the currently traded volume of an asset, in conversion to a root asset of the exchange (for example, USD)

PnL Asset

Indicates the net profit-loss calculated for an asset

PnL (root asset)

Indicates the net profit-loss calculated for an asset, in conversion to a root asset of the exchange (for example, USD)

Roll-Back

In this subsection, you can locate and revert (roll back) trades executed on the exchange.

Note

You can only revert trades executed by users assigned a Frozen status.

To find a particular trade, specify the day and time period within which it has been executed. In addition, you can specify a currency pair (market) and a user who executed the trade.

The search results are displayed in a list providing information about the trades matching the specified criteria.

General Info

The following information is displayed in the trades list:

Email

Indicates an email of a user who executed the trades

Assets change

Indicates the aggregate amount of assets purchased and/or sold by a user within a specified time period

Details

Upon clicking the ellipsis button next to an entry displayed in the list, you can see a list of all trades executed by a user within the specified time period. The following information is provided about each trade:

Order ID

Indicates the order ID

Execution ID

Indicates the trade ID

Market ID

Indicates the currency pair

Order Type

Indicates the order type

Order Status

Indicates the current order status

Quote Amt

Indicates the traded amount, in a quote asset

Base Amt

Indicates the traded amount, in a base asset

Commission

Indicates the commission amount charged for a trade

Commission (root asset)

Indicates the commission amount charged for a trade, in conversion to a root asset of the exchange (for example, USD)

Executed At

Indicates the date and time when a trade has been executed

PnL

Indicates the net profit-loss calculated for a trade

To roll back a trade, enable a corresponding check box displayed next to it and click Revert. As a result, the selected trades will change their status to Reverted and the balances on trading accounts opened on corresponding markets will be updated to reflect the changes.

See also

Roll Back Trade

Arbitrage

In this subsection, you can detect fraudulent trading strategies that might be employed by some users. Examples of these include suspicious cases of high-frequency trading backed by powerful trading hardware and unfair use of arbitrage polygons. You can monitor trades for occurrence of any of this strategies by switching to a corresponding tab on this screen.

Trading Rates

Trading rate monitoring is disabled by default and no data is displayed in a corresponding table. To enable monitoring, select the time interval (1 minute, 3 minutes, 5 minutes or 1 day) and specify an email of a user whose activity you wish to monitor (when this field is not specified, activities of all users are monitored). Click Run Monitoring to launch the monitoring process. While the incoming data is being processed, information about the trades is updated and displayed on this screen.

The following information related to trades is displayed in this section:

E-mail

Indicates an email of a user who executed a suspicious trade

Trades Count

Indicates the overall number of trades that have been executed during a specified time period

After monitoring is enabled, you can switch to other Admin Panel sections without interrupting the process.

To stop monitoring, click a corresponding button at the top of the screen.

Arbitrage Polygon

Arbitrage polygon monitoring is disabled by default and no data is displayed in a corresponding table. To enable monitoring, select the time interval (1 minute, 3 minutes, 5 minutes or 1 day) and specify an email of a user whose activity you wish to monitor (when this field is not specified, activities of all users are monitored). Click Run Monitoring to launch the monitoring process.

Upon detecting any suspicious arbitrage strategies, all relevant data will be displayed on this screen (including the information about a user employing such strategy, the market in question and associated trades). You can click an entry in this list to view detail information.

After monitoring is enabled, you can switch to other Admin Panel sections without interrupting the process.

To stop monitoring, click a corresponding button at the top of the screen.

PnL

In this section, you can monitor net profits and losses (PnL) calculated for individual users or assets based on the history of trades executed on the exchange.

Note

PnL values are calculated once every 24 hours and the displayed metrics correspond to values obtained for the previous day.

User PnL

In this subsection, you can view net profit-loss calculated for each user based on a history of user trades on each market.

Totals

The following summary information is displayed at the top of this screen (these values are converted to a root asset of the exchange):

Total Commission (root asset)

Indicates the total commission charged for all assets traded on the exchange

Total Volume (root asset)

Indicates the total volume of assets traded on the exchange

Total PnL (root asset)

Indicates the net profit-loss calculated for all assets traded on the exchange

Note

You can display summary information for users with a selected status and specify a custom time period by clicking the funnel button located at the top of the screen.

General Info

In the detail section of this screen, you can view summary information about user balances, the net traded volume and commissions paid by each user. Information displayed on this tab is similar to the one presented in the User Commissions section.

Extended Info

Upon clicking an entry in the users list, the following summary information is displayed at the top of the screen (these values are converted to a root asset of the exchange):

Ag. Balance (root asset)

Indicates the user’s aggregate balance, meaning the total amount of all available user assets

Commissions (root asset)

Indicates the total commission charged for all user assets traded on the exchange

Traded Volume (root asset)

Indicates the total volume of user assets traded on the exchange

Realized PnL (root asset)

Indicates the net profit-loss calculated based on the history of trades executed by a user

Unrealized PnL (root asset)

Indicates the net profit-loss calculated based on current fluctuations of the price of assets traded by a user

In this subsection, you can view information about user assets and transfers by switching to a corresponding tab:

Assets

On this tab, you can find information about user assets, commissions and the net profit-loss calculated for each user asset. See Exchange Asset PnL to learn about the data displayed on this tab.

Transfers

On this tab, you can view the history of user transfers. See Transfers to learn about the data displayed on this tab.

Exchange Asset PnL

In this subsection, you can monitor the total profit-loss calculated for each asset traded on the exchange, based on trades executed by all exchange users.

Totals

The following summary information is displayed at the top of this screen (these values are converted to a root asset of the exchange):

Total Commissions (root asset)

Indicates the total commission charged for all assets traded on the exchange

Total Traded Volume (root asset)

Indicates the total volume of assets traded on the exchange

Note

You can display summary information for a specific time range by clicking the funnel button located at the top of the screen.

General Info

The following information about each asset is displayed in this subsection:

Asset

Indicates the asset code (such as BTC for bitcoin)

Commission Amount

Indicates the total commission amount charged for an asset, in conversion to a corresponding asset

Commission (root asset)

Indicates the total commission amount charged for an asset, in conversion to a root asset of the exchange (for example, USD)

Volume (root asset)

Indicates the total volume of an asset traded on the exchange, in conversion to a root asset of the exchange (for example, USD)

Realised PnL

Indicates the net profit-loss calculated for an asset based on the history of executed trades

Settings

In this section, you can configure the exchange settings and manage markets and users.

Markets

In this subsection, you can customize market settings, including commissions applied to each currency pair. The following market settings are available on this screen:

Market Name

Indicates the market name displayed on the exchange (typically, it specifies a currency pair)

Order Price Deviation

Indicates the allowed price deviation for limit orders placed on the market, upon exceeding which (that is, upon deviating too much from the best bid or ask prices) an order will be rejected. This value is normalized to 0–1 range (for example, 0.15 will indicate an allowed price deviation of 15%) and cannot exceed 1

Maker Fee

Indicates the commission rate applied to market makers that provide market liquidity. This value is normalized to 0–1 range (for example, 0.05 will indicate a fee of 5%). A maker fee of 5% is considered substantial and may be detrimental to business

Taker Fee

Indicates the commission rate applied to market takers that diminish market liquidity. This value is normalized to 0–1 range (for example, 0.05 will indicate a fee of 5%). A taker fee of 5% is considered substantial and may be detrimental to business

Buys / Sells

Indicates the trading operations (buy and/or sell) permitted on a market

Visible

Indicates whether a market currently appears in the Admin Panel interface

Status

Indicates the current market status

To configure market settings, hover the mouse pointer over the end part of a corresponding row and click the displayed gear button. In the invoked Settings dialog, you can customize the settings described above as well as enable or disable tier fees for the market.

Assets

In this subsection, you can find the following asset settings:

Asset Name

Indicates the asset name displayed on the exchange

Withdrawal Fee

Indicates the commission charged for withdrawal transfers

Scale

The number of decimal places displayed for asset amounts, which also determines the Amount Scale and Price Scale limits for related markets (this value must be within 2—18 range)

Withdrawal / Deposit

Indicates whether withdrawal and deposit operations are permitted for an asset

To configure these settings, hover the mouse pointer over the end part of a corresponding row and click the displayed gear button.

Admin Users

In this subsection, you can find settings related to users assigned the following roles granting them access to the Admin Panel:

  • Admin — users with this role are permitted to change the status of other users, update the market status, assign user roles, specify commissions charged for trades and withdrawal transfers, as well as set new passwords for exchange users

  • Support — users with this role are permitted to change the status of other users and cancel (roll back) trades

  • Bot — a role assigned to non-human accounts, such as those created for trading bots

At the top of this screen, you can switch between various tabs displaying users with corresponding roles.

Note

You can grant access to the Admin Panel to a new user by clicking the Add User button.

Upon clicking a user profile in the users list, you are navigated to the Account Details screen providing information about the user status, roles, email and nickname. In addition, you can see the current aggregate balance on all deposit accounts available to this user, as well as find out whether the user has been provided with trading API keys.

You can customize a user profile by clicking the gear icon displayed at the top of the screen.

The Login Info tab displayed on this screen provides information about each user session, including the date and time when a user has logged in, a session IP and country.

No Role User

In this subsection, you can find information about users to which no roles have been assigned.

The information displayed in this section is similar to the one presented on the Users screen.

Preferences

In this subsection, you can configure the time zone settings applied to date and time fields displayed in the Admin Panel.

Upon saving the changes, all information about the date and time of various exchange operations will be updated according to a selected time zone.

Logs

In this section, you can find logs listing all actions made on the exchange.

You can switch between various tabs to access information related to any of the following activity types:

  • All — a complete log reflecting all the activities

  • Users — a log of activities related to managing user profiles, such as creating new profiles or assigning user roles

  • Transfers — a log of activities related to transfer operations, such as creating new transfer requests

  • Transactions — a log of activities related to transactions

  • Commissions — a log of activities related to managing tiers and commission settings configured for individual tier groups, users or assets

  • Dealing — a log of activities related to trades

  • Settings — a log of activities related to general exchange settings, such as managing markets and assets

On each tab, you can find the following information about an action that has been logged:

Time stamp

Indicates the date and time of an action

Email

Indicates the email of a user who performed an action

Role

Indicates the roles assigned to a user who performed an action

Operation

Indicates the activity type

Information

Provides the action description

See also

View Changelog

Reference

In this document section, you can find general information about various concepts related to exchange operation.

User Roles

An exchange user can be assigned one or more roles that determine access permissions granted to the user and commission settings applied to the user’s trading account.

Roles assigned to exchange users

The following roles can be assigned to general exchange users:

  • Vip — assigned to valuable exchange users to which individualized commissions apply

  • User — when assigned to users, they can no longer place orders on the exchange and are only allowed to make transfers (this status is reserved for users that were banned from the exchange for various reasons: by assigning such users this role, you no longer allow them to trade while letting them withdraw their funds and leave the venue)

  • Demo — when assigned to users, they can no longer place orders and make transfers (this is a legacy status reserved for the users that wish to try out a demo service)

  • Trader — when assigned to users, they are allowed to perform general exchange operations, such as placing new orders or making transfers

  • Market-Maker — when assigned to users, no commissions are charged for trades executed by them

  • NoCommission — when assigned to users, no commissions are charged for any of their operations on the exchange

  • Hedging — when assigned to users, transactions made by them are ignored upon calculating the Total Asset Amount, Total Commission, Total Volume and Total PnL across the exchange; this role does not imply any restriction to users

Roles assigned to exchange administrators

The following roles can be assigned to users that should be granted access to the Admin Panel:

  • Admin — users with this role are permitted to change the status of other user user profiles, update the market status, assign user roles, specify commissions charged for trades and withdrawal transfers, as well as set new passwords for exchange users

  • Support — users with this role are permitted to change the status of other user profiles and cancel (roll back) trades

  • Bot — a technical role assigned to non-human accounts, such as those created for trading bots

User Statuses

The status of a user profile determines whether the user is allowed to interact with the exchange via the trading API and UI.

A user profile can be assigned one of the following statuses:

  • Active — a user has full access to the exchange and can perform any operations on it according to the assigned user roles

  • Frozen — a user is temporarily not allowed to perform any actions on the exchange while retaining read-only access to it

  • Terminated — a user is permanently denied access to the exchange and no longer allowed to perform any actions on it

Important

Once a user profile has been terminated, it cannot be restored.

Order Types

Orders of the following types can currently be placed on the exchange:

  • A Market order is an instruction to instantly buy or sell a certain asset amount at a currently best price on the market. Such orders are not listed in the order book and executed or cancelled immediately.

  • A Limit order is an instruction to buy or sell a certain asset amount at a specified price. Limit orders are placed in the order book and executed only when the market price reaches or exceeds the specified limit price. For this reason, limit orders may never be executed if their limit price differs significantly from the current market price.

See the Time in Force section to learn about execution parameters that can be specified for different order types.

Time in Force

The following time-in-force settings can be specified for various types of orders:

  • FOK (Fill-or-Kill) — can be applied to a market order. Such orders are either filled immediately or killed (cancelled). In other words, a fill-or-kill order must be filled immediately in its entirety or not executed at all. FOK orders are used when partial delivery of assets is not acceptable for any reason.

  • IOC (Immediate-or-Cancel) — can be applied to a market order. This setting implies that any part of an order that cannot be filled immediately must be cancelled. Upon placing an IOC order, an attempt will be made to immediately execute it (in full or in part) at the best possible price, after which any remaining, unfilled part will be cancelled. If no amount is available at a specified price upon placing such order, it will be cancelled immediately.

  • GTC (Good-till-Cancelled) — the default setting applied to all limit orders. Open GTC orders are awaiting execution until they are cancelled explicitly or filled.


Order Statuses

An order can be assigned one of the following statuses:

  • Working — indicates that the order is open and waiting to be executed partially or in full

  • Completed — indicates that the order has been executed

  • Cancelled — indicates that the order has been cancelled, either explicitly by a user or because it has not been filled according to the order type settings (for example, in case of a fill-or-kill order)

  • Rejected — indicates that the order has been rejected (for example, as a result of changing the user profile status to Frozen)

  • Reverted — indicates that the order has been reverted as a result of rolling back an associated trade

Market Statuses

A market can be assigned one of the following statuses:

  • Open — the market is operating properly and accepts orders via UI and API; this status cannot be assigned to a newly created market

  • Paused — the market stops accepting incoming orders via UI and API (previously placed limit orders still await execution); this status cannot be assigned to a newly created market

  • Halted — the market stops accepting incoming orders via UI and API, all open limit orders are cancelled

Note

For newly created markets, Status can only be set to Halted. To allow trading on the created market, locate it on the Settings > Markets page and set the market Status to Open. For detailed instructions, see Change Market Status.

PnL Calculation

Understanding PnL

PnL (profit and loss) is a metric indicating the overall profitability of trading operations (or incurred losses). It is calculated based on the traded volumes and spreads between closing and opening rates.

This metric allows you to selectively measure performance of each asset and trader. This is important since PnL reflects (both actual and potential) profitability from the standpoint of an exchange user, and not the exchange itself.

Before turning to explain how PnL is measured we should clarify what opening and closing a position stands for.

Essentially, each trade occurs when a sale meets a purchase: closing any position implies that it should have been opened in the first place. Positions may be opened and closed either in the full amount, or partially (when only a portion of a bid or offer is met, based on the order time-in-force settings). Both these cases are accounted for during PnL calculation, in the context of which, “opening a position” means any action after which user funds in some asset increase: be it as a result of depositing funds in this asset, or of buying some asset amount on the exchange (after placing an order), or of any incidental action like airdropping. The term “closing” points to an action after which user funds diminish, which implies a sale or withdrawal.

There are two kinds of PnL which account for actual and potential profit (loss):

  • Realized PnL (also called fixed PnL, or simply PnL) indicates the actual net profit (or loss) calculated each time a position is closed, after which this value is updated and recorded, being no longer affected by any subsequent variation in conversion rates.

  • Unrealized PnL (also called floating PnL) indicates a potential profit (loss) and its hypothetical impact upon Realized PnL that would become manifest if all currently open positions were closed at once. Unrealized PnL is constantly recalculated following an ongoing change in market prices for open positions. This value is not fixed, it “floats”, reflecting the market volatility and the movement of market rates. Unrealised PnL is most helpful for evaluating notional and actual profitability of limit orders.

To evaluate PnL, the exchange engine relies upon a sophisticated algorithm, which is not only capable of speedily handling very large quantities of incoming data, but also accounts for a variety of rare scenarios, such as missing rates in database records or revoking of previously executed trades.

The PnL is calculated individually for each user asset: for example, when ETH is exchanged to LTC, calculations are carried out simultaneously for both these currencies.

The procedure of PnL calculation is based on the following considerations:

  • PnL is calculated, stored and displayed in the platform root asset (typically, this is a fiat currency or stablecoin). In all examples that follow, it is implied that the platform root asset is USD.

  • A deposit operation is treated as a regular asset purchase at the current rate (implying that a position has been opened).

  • A withdrawal operation is treated as a regular asset sale at the current rate (implying that a position has been closed).

  • Trades are accounted for as if their execution involved an intermediate root asset, as in the case when a (base) asset is first sold for USD, and then USD is exchanged for the purchased (quote) asset.

    For example, in the case of buying ETH for BTC, PnL is calculated in the same way as if a user first sold BTC for USD, and then used the purchased USD to buy ETH.

If some asset (such as BTC) cannot be converted to the platform root asset either directly (BTC/USD) or via cross currency (BTC/LTC, and then LTC/USD), PnL for this asset is not calculated and is not affected by any transactions involving the asset (transfer or exchange), regardless of the order side.

Realized PnL calculation

Realized PnL is calculated separately for each user asset, and only after some position has been closed. After the first position is opened for a given asset, only intermediate values are updated to be later used in subsequent PnL calculations.

Upon opening a position, the average price for the asset and current balance are evaluated first, to be later used for Realized PnL calculation:

  1. [Balance In Root Asset] = [Previous Balance In Root Asset] + ([Asset Amount] * [Asset Rate To Root Asset])

  2. [Asset Balance] = [Previous Asset Balance] + [Asset Amount]

… where:

  • Balance In Root Asset — the total cost of assets now available to a user after the recent transaction. This is the current amount remaining in a user’s wallet that holds the traded/transferred asset, in conversion to the platform root asset. The conversion rates are taken as of the time of opening each previous position in this asset.

  • Previous Balance In Root Asset — the previous running Balance In Root Asset value as of before the current transaction, in the platform root asset. This value can be equal to zero if no transactions have previously taken place. It is stored in a database for use in subsequent PnL calculations.

  • Asset Amount — the amount of the recent transaction, in the base asset (after commission, in the case of opening a position).

  • Asset Rate To Root Asset — the current rate of the user asset to the platform root asset. This value continuously changes along with the ongoing rate fluctuations.

  • Asset Balance — the total asset amount in a user wallet after the recent transaction.

  • Previous Asset Balance — the asset amount that was available to a user before the recent transaction. This value can be equal to zero if no transactions have previously taken place. It is stored in a database for use in subsequent PnL calculations.

When a position is closed, Realized PnL is calculated as follows:

  1. [Avg Rate] = [Balance In Root Asset] / [Asset Balance]

  2. [Realized PnL] = [Previous PnL] + [Asset Amount] * ([Asset Rate To Root Asset] – [Avg Rate])

  3. [Balance In Root Asset] = [Previous Balance In Root Asset] – [Asset Amount] * [Avg Rate]

  4. [Asset Balance] = [Previous Asset Balance] – [Asset Amount]

… where:

  • Avg Rate — the average cost of a unit of asset. This value is obtained across the user balance sheet with a reference to historical rates established by the time when each transaction was made.

  • Previous PnL — the Realized PnL value as of before the recent transaction.

Realized PnL is stored and displayed in the same platform root asset, which was used in preceding PnL calculations.

The resulting PnL value cannot be “converted” to another asset, since it would cease being a proper measure of PnL.

The algorithm accounts for variation in the rate of a user asset to the root asset with each transaction.

Unrealized PnL calculation

Unrealized PnL is constantly recalculated, upon receiving continuous data update requests following any change to the current rates:

[Unrealized PnL] = [Asset Balance] * ([Asset Rate To Root Asset] – [Avg Rate])

… where:

  • Asset Balance — the total asset amount in a user wallet.

  • Asset Rate To Root Asset — the current rate of the user asset to the platform root asset. This value continuously changes along with the ongoing rate fluctuations.

  • Avg Rate — the average cost of a unit of asset. This value is obtained across the user balance sheet with a reference to historical rates established by the time when each transaction was made.

Sample PnL calculations

Case study 1

To understand PnL, consider the following example, with a new user arriving on the exchange with zero balance on their freshly opened trading account. All of the user metrics are zero, awaiting the user to make the first investments.

Step 1. The user begins by depositing $6000 to the USD wallet, which for our purposes is the equivalent of opening a position.

To evaluate Balance in Root Asset, the amount deposited is multiplied by one, since we don’t need to convert the deposited currency (USD) to the platform root asset (also USD). The current balance on the user USD account is accordingly updated.

Balance (USD) in Root Asset (USD) = 0 + 6000 * 1 = $6000

Balance (USD) = 0 + 6000 = $6000

At this step, both the PnL values are zero:

Realized PnL = $0

Unrealized PnL = 6000 (1 – 6000/6000) = $0

Step 2. The user spends $1990 to buy 2000 USDT at the rate of 1:0.995.

Balance (USDT) in Root Asset = 0 + (2000 * 0.995) = $1990

Balance (USDT) = 0 + 2000 = ₮2000

PnL values are still zero, since nothing has changed so far, apart from the user opening another position:

Realized PnL (USDT) = $0

Unrealized PnL (USDT) = 2000 * (0.995 – 1990/2000) = $0

Step 3. While the user spends another $1200 to buy 1 ETH (so the ETH/USD rate is 1:1200), the USDT/USD rate changes and becomes 1:0.997.

Balance (USDT) in Root Asset = $1990

Balance USDT = ₮2000

Balance (ETH) in Root Asset = 0 + (1 * 1200) = $1200

Balance (ETH) = Ξ1

Since no positions have been closed at this step, only Unrealized PnL for USDT is updated, reflecting the current change in the USDT/USD rate. Keep in mind that PnL values are always calculated in the platform root asset (which is USD in our example), regardless of the asset being measured.

Realized PnL (USDT) = $0

Unrealized PnL (USDT) = 2000 * (0.997 – 1990/2000) = $4

Realized PnL (ETH) = $0

Unrealized PnL (ETH) = $0

Step 4. The user buys one more ETH, but at this time, the ETH/USD rate has increased and become 1:1400.

Balance (USDT) in Root Asset = $1990

Balance (USDT) = ₮2000

Balance (ETH) in Root Asset = 1200 + (1 * 1400) = $2600

Balance (ETH) = 1 + 1 = Ξ2

This time, Unrealized PnL is updated for ETH, reflecting the change in the ETH/USD rate:

Realized PnL (USDT) = $0

Unrealized PnL (USDT) = 2000 * (0.997 – 1990/2000) = $4

Realized PNL (ETH) = $0

Unrealized PNL (ETH) = 2 * (1400 – (1200 + 1400)/2) = $200

Step 5. The ETH/USD rate is now 1:1500, so the user decides to close two positions by selling 1 ETH at this rate and 1000 USDT at the rate of 1:0.997.

After the trades are executed, the unrealized profit in USDT translates into Realized PnL, while another ₮1000 remaining in the user USDT wallet still awaits its opportunity:

Realized PnL (USDT) = 0 + 1000 * (0.997 – (1990/2000)) = $2

Balance (USDT) in Root Asset = 1990 – 1000 * (1990/2000) = $995

Balance (USDT) = 2000 – 1000 = ₮1000

Unrealized PnL (USDT) = 1000 * (0.997 – 1990/2000) = $2

The same logic applies to PnL calculations for ETH:

Realized PnL (ETH) = 0 + 1 * (1500 – (1200 + 1400)/2) = $200

Balance (ETH) in Root Asset = 2600 – 1 * (1200 + 1400)/2) = $1300

Balance (ETH) = 2 – 1 = Ξ1

Unrealized PnL (ETH) = 1 * (1500 – (1300)/1) = $200

At this step, it is time to check the balance:

Balance (USD) = $1410 + $1500 + $997 = $3907

…where:

  • $1410 — the funds left after purchasing 2000 USDT and 2 ETH (one for $1200 and one for $1400).

  • $1500 — the income after selling 1 ETH

  • $997 — the income after selling 1000 USDT

Case study 2

The following table illustrates a series of sample PnL values produced based on hypothetical user actions and variations in the current rates.

In this table, the Balance and Balance In Root Asset columns display updated values that were obtained as a result of previous transactions (initially, both these values are zero). Realized PnL in each row is calculated using the Balance and Balance In Root Asset values from a preceding row.

As this table illustrates, the Balance to Balance In Root Asset ratio doesn’t change after a position is partially closed, despite the values themselves being updated. This is because a position is actually closed not using some specific portion of previously purchased assets, but by subtracting some portion from a net asset balance, for which the total cost of the assets is known.

Operation:

+ (buy) / (sell)

Rate

Realized PnL

Unrealized PnL

Balance

Balance In Root Asset

+1

10

0

0

1

10

+1

15

0

2 * (15 – 25/2) = 5

2

25

+1

20

0

15

3

45

+1

25

0

30

4

70

+1

30

0

50

5

100

+1

35

0

75

6

135

+1

40

0

105

7

175

–1

40

1 * (40 – 175/7) = 15

90

6

150

–1

35

15 + 1 * (35 – 150/6) = 25

50

5

125

–1

30

25 + 1 * (30 – 125/5) = 30

20

4

100

–1

25

30

0

3

75

–1

20

25

–10

2

50

–1

15

15

–10

1

25

–1

10

0

0

0

0

+1

30

0

0

1

30

+1

40

0

10

2

70