B2Core API REST API The Front Office API Front Office API objects

Front Office API objects

In this section, you can learn about the objects used in the Front Office API:

The Account object (Front Office)

This object provides the following data about a client account:

accountId integer

The identifier of a client account.

accountNumber string

The account number that is displayed to a client in the B2Core UI.

caption string

The account name displayed in the B2Core UI.

currency object

The details about a currency in which a client account is denominated. See the Currency object to learn more.

favourite boolean

If true, an account is marked as favorite; otherwise, false.

group object

The details about a group to which an account belongs.

Show object fields

id integer: The identifier of an account group.
name string: The name of an account group.
priority integer: The priority index assigned to an account group.

platform object

The details about a platform on which an account is opened.

Show object fields

id integer: The identifier of a platform.
name string: The name of a platform.

priority integer

The priority index assigned to an account.

statement object

The account statement providing details about a client account. See the Statement object to learn more.

type string

The account type. Possible values:

personal
trade
demo
partner
liquidity
exchange
external
bo
iisbo
system

createTime string

The date and time when a client account was created.

    THE ACCOUNT OBJECT (FRONT OFFICE)
  
{
  "accountId": 1,
  "accountNumber": "12345678",
  "caption": "USD",
  "currency": {
    "alphabeticCode": "USD",
    "minorUnit": 2,
    "name": "US Dollar",
    "numericCode": 840
  },
  "favourite": true,
  "group": {
    "id": 1,
    "name": "Fiat",
    "priority": 1
  },
  "platform": {
    "id": 1,
    "name": "MetaTrader 5"
  },
  "priority": 1,
  "statement": {
    "availableBalance": "1.000000000000000000",
    "currentBalance": "1.000000000000000000",
    "credit": "1.000000000000000000",
    "equity": "1.000000000000000000",
    "freeMargin": "1.000000000000000000",
    "hold": "1.000000000000000000",
    "margin": "1.000000000000000000",
    "marginLevel": "1.000000000000000000",
    "pnl": "1.000000000000000000",
    "updateTime": "2022-01-01T00:00:00+00:00"
  },
  "type": "trade",
  "createTime": "2022-01-01T00:00:00+00:00"
}

. The Authorization Record object (Front Office):

The Authorization Record object (Front Office)

This object provides the following data about a client authorization attempt:

id integer

The authorization record identifier.

ip string

The IP address from which a client signed in to the B2Core UI.

authDateTime string

The date and time when a client signed in to the B2Core UI.

status string

The result of a sign-in attempt. Possible values:

success
failure

    THE AUTHORIZATION RECORD OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "ip": "000.000.00.000",
    "authDateTime": "2022-01-01T00:00:00+00:00",
    "status": "success"
  }

The Banner object (Front Office)

This object provides the following data about a banner:

id integer

The banner identifier.

backgroundLinkLight string

The link to an image that is used as a background image for the light theme.

backgroundLinkDark string

The link to an image that is used as a background image for the dark theme.

buttonLight string

The button caption specified for the light theme.

buttonDark string

The button caption specified for the dark theme.

buttonLink string

The link to an external resource that is opened upon clicking a button displayed on a banner.

captionLight integer

The banner title specified for the light theme.

captionDark string

The banner title specified for the dark theme.

enabled boolean

If true, a banner is displayed to clients in the B2Core UI or mobile app; otherwise, false.

mobileText string

The banner text.

mobileTitle string

The banner title.

mobileSubTitle string

The banner subtitle.

mobileButtonTitle string

The caption of a button displayed on a banner.

priority integer

The order in which banners are displayed in the B2Core UI or mobile app if more than one banner is configured.

textLight string

The text of a banner, specified for the light theme.

textDark string

The text of a banner, specified for the dark theme.

type string

The banner type. Possible values:

desktop— banners of this type are displayed only in the B2Core UI.
mobile— banners of this type are displayed only in the mobile app.

resources array

An array of resource objects, specifying localized strings for user interface pages displayed to a client.

createdAt string

The date and time when a banner was created.

createdBy string

The email of a Back Office user who created a banner.

    THE BANNER OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "backgroundLinkLight": "https://example.com/image.png",
    "backgroundLinkDark": "https://example.com/image.png",
    "buttonLight": "https://example.com",
    "buttonDark": "https://example.com",
    "buttonLink": "https://example.com",
    "captionLight": "<b>Core Products</b>",
    "captionDark": "<b>Core Products</b>",
    "enabled": true,
    "mobileText": "Mobile Text",
    "mobileTitle": "Mobile Title",
    "mobileSubTitle": "Mobile Sub Title",
    "mobileButtonTitle": "Mobile Button Title",
    "priority": 1,
    "textLight": "Text Light",
    "textDark": "Text Dark",
    "type": "desktop",
    "url": "https://example.com/image.png",
    "resources": [
      {
        "key": "caption",
        "locale": "ru_RU",
        "value": "Lorem"
      }
    ],
    "createdAt": "2022-01-01T00:00:00+00:00",
    "createdBy": "jdoe@example.com"
  }

The Client Profile (Front Office)

This object provides the following data about a client profile:

id integer

The client profile identifier.

email string

The client’s email address.

locale string

The localization option applied to the B2Core UI.

status string

The client profile status. Possible values:

inactive
active
banned
deleted

nickname string

The client’s nickname used in the B2Core UI.

photo string

The filename of an image used as a profile picture.

maskedEmail string

The masked email address.

clientUiConfig object

The user interface configuration options specified for a client.

Show object fields

showId boolean: If true, a client identifier is displayed in the B2Core UI; otherwise, false.
allowChangeUserPic boolean: If true, a client can change their profile picture via the B2Core UI; otherwise, false.
allowChangeNickname boolean: If true, a client can change their nickname via the B2Core UI; otherwise, false.

info object

The client personal data.

Show object fields

firstName string: The client’s first name.
lastName string: The client’s last name.
middleName string: The client’s middle name.
birthday string: The client’s date of birth.

phone object

The details about a client phone number that is marked as the default one.

The default phone number is always a mobile number that is confirmed by a client. If several mobile numbers are confirmed, the latest confirmed number is marked as the default one.

Show object fields

id integer

The identifier of a phone number.

phone string

The phone number.

ext string

The phone number extension.

type string

The type of a phone number.

Always mobile for the default phone number.

confirm boolean

If true, a phone number is confirmed; otherwise, false.

Always true for the default phone number.

default boolean

If true, a phone number is marked as the default one for a client; otherwise, false.

maskedPhone string

The masked phone number.

phones array

An array of objects providing data about all phone numbers specified in a client profile.

type object

The details about a client profile type. See the Client Type object to learn more.

country object

The details about a client’s country (if specified by a client during registration or KYC verification process). See the Country object to learn more.

verificationLevel object

The details about a verification level obtained by a client. See Verification Level object to learn more.

lastLoginTime string

The date and time of when a client was last signed in to the B2Core UI.

createTime string

The date and time when a client profile was registered.

updateTime string

The date and time when a client profile was last modified.

    THE CLIENT PROFILE OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "email": "jdoe@example.com",
    "locale": "en_US",
    "status": "active",
    "nickname": null,
    "photo": "image.jpeg",
    "maskedEmail": "j*********@********.com",
    "clientUiConfig": {
      "showId": true,
      "allowChangeUserPic": true,
      "allowChangeNickname": true
    },
    "info": {
      "firstName": "John",
      "lastName": "Doe",
      "middleName": null,
      "birthday": "2022-01-01T00:00:00+00:00"
    },
    "phone": {
      "id": 1,
      "phone": "phone number",
      "ext": "123",
      "type": "mobile",
      "confirm": true,
      "default": true,
      "maskedPhone": "masked phone number"
    },
    "phones": [
      {
        "id": 1,
        "phone": "phone number",
        "ext": "123",
        "type": "mobile",
        "confirm": true,
        "default": true,
        "maskedPhone": "masked phone number"
      },
      {
        "id": 2,
        "phone": "phone number",
        "ext": "1214",
        "type": "fixed",
        "confirm": false,
        "default": false,
        "maskedPhone": "masked phone number"
      }
    ],
    "type": {
      "id": 1,
      "default": true,
      "enabled": true,
      "name": "Individual",
      "group": "individual",
      "wizard": true
    },
    "country": {
      "countryId": 8,
      "alpha2Code": "US",
      "alpha3Code": "USA",
      "countryName": "United States",
      "callingCode": "+1",
      "numericCode": "840",
      "enabled": true
    },
    "verificationLevel": {
      "id": 1,
      "name": "Level 0",
      "description": "description",
      "mailDescription": "mail description",
      "nextLevel": 1,
      "roleId": 1,
      "wizard": "DocumentsWizard",
      "default": true,
      "visible": true,
      "sustainable": true,
      "options": [
        "Document type 1",
        "Document type 2"
      ]
    },
    "lastLoginTime": "2022-01-01T00:00:00+00:00",
    "createTime": "2022-01-01T00:00:00+00:00",
    "updateTime": "2022-01-01T00:00:00+00:00"
  }

The Client Type object (Front Office)

This object provides the following data about a client type:

id integer

The client type identifier.

default boolean

If true, this is the default type assigned to all newly registered clients; otherwise, false.

enabled boolean

If true, this type can be assigned to clients; otherwise, false.

name string

The client type name.

group string

The group to which a client type is assigned. Possible values:

individual — indicates an individual client
corporative — indicates a corporate client

wizard boolean

If true, wizard pages are displayed to clients with the assigned type.

    THE CLIENT TYPE OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "default": true,
  "enabled": true,
  "name": "Individual",
  "group": "individual",
  "wizard": true
}

The Country object (Front Office)

This object provides the following data about a country:

countryId integer: The country identifier.
alpha2Code string: A two-letter country code (as per ISO 3166-2).
alpha3Code string: A three-letter country code (as per ISO 3166-3).
countryName string: The localized country name.
callingCode string: The international country dialing code.
numericCode string: A numeric country code (as per ISO 3166).
enabled boolean: If true, a country is available for selection when clients sign up to the B2Core UI.

    THE COUNTRY OBJECT (FRONT OFFICE)
  
{
  "countryId": 840,
  "alpha2Code": "US",
  "alpha3Code": "USA",
  "countryName": "United States",
  "callingCode": "+1",
  "numericCode": "840",
  "enabled": true
}

The Currency object (Front Office)

This object provides the following data about a currency:

alphabeticCode string: The alphabetic code of a currency (such as USD).
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The localized currency name.
numericCode integer: The numeric code of a currency.

    THE CURRENCY OBJECT (FRONT OFFICE)
  
{
  "alphabeticCode": "BTC",
  "blockExplorer": "https://live.blockcypher.com/btc/tx/{address}",
  "enabled": true,
  "markupBuy": 50.55,
  "markupSell": 50.55,
  "minorUnit": 8,
  "name": "Bitcoin",
  "numericCode": 1000,
  "resources": [
    {
      "key": "caption",
      "locale": "ja_JP",
      "value": "ビットコイン"
    }
  ],
  "createTime": "2022-01-01T00:00:00+00:00",
  "updateTime": "2022-01-01T00:00:00+00:00"
}

The Deposit Group object (Front Office)

This object provides the following data about a deposit group:

id integer: The identifier of a deposit group.
description string: The deposit group description.
caption string: The deposit group name displayed to clients in the B2Core UI.
name string: The deposit group name used in the Back Office.
icon string: The filename of an image displayed as a deposit group icon.

    THE DEPOSIT GROUP OBJECT (FRONT OFFICE)
  
 {
  "id": 1,
  "description": "Group description",
  "caption": "Crypto",
  "name": "Cryptocurrencies",
  "icon": "example.png"
}

The Deposit Method object (Front Office)

This object provides the following data about a deposit method:

id integer

The identifier of a deposit method.

name string

The deposit method name displayed to clients in the B2Core UI.

icon string

The filename of an image displayed as a deposit method icon.

libraryTimeToFund string

A hint displayed to clients in the B2Core UI about the period during which a deposit transaction is processed.

caption string

The deposit method description.

provider string

The name of a payment system used to make deposits.

tradersRoomCurrencies array

An array of objects providing data about each transaction currency added to a deposit method.

Show object fields

min object

The data about the minimum amount that can be deposited in a transaction currency.

Show object fields

value string: The minimum allowed deposit amount.
scale integer: The number of decimal places displayed when representing the minimum amount in a transaction currency.

max object

The data about the maximum amount that can be deposited in a transaction currency.

Show object fields

value string: The maximum allowed deposit amount.
scale integer: The number of decimal places displayed when representing the maximum amount in a transaction currency.

icon string

The filename of an image displayed as a currency icon.

caption string

The currency name displayed to clients in the B2Core UI.

keyCaption string

The path to a list of localized strings that can be displayed as a currency caption.

currency object

The details about a transaction currency.

Show object fields

alphabeticCode string: The alphabetic code of a currency.
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The currency name.
numericCode integer: The numeric code of a currency.

paymentSystemCurrencies array

An array of objects providing data about each payment currency added to a deposit method.

Show object fields

min object

The data about the minimum amount that can be deposited in a payment currency.

Show object fields

value string: The minimum allowed deposit amount.
scale integer: The number of decimal places displayed when representing the minimum amount in a payment currency.

max object

The data about the maximum amount that can be deposited in a payment currency.

Show object fields

value string: The maximum allowed deposit amount.
scale integer: The number of decimal places displayed when representing the maximum amount in a payment currency.

icon string

The filename of an image displayed as a currency icon.

caption string

The currency name displayed to clients in the B2Core UI.

keyCaption string

The path to a list of localized strings that can be displayed as a currency caption.

currency object

The details about a payment currency.

Show object fields

alphabeticCode string: The alphabetic code of a currency.
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The currency name.
numericCode integer: The numeric code of a currency.

vendorCommissions array

An array of objects providing data about commissions charged by a broker.

Show object fields

percent integer: The percentage of a deposit amount charged as a commission.
min number: The minimum commission amount.
max number: The maximum commission amount.
fix number: The fixed commission amount.
type string: The commission type.

providerCommissions array

An array of objects providing data about commissions charged by a payment system.

Show object fields

percent integer: The percent of a deposit amount charged as a commission.
min number: The minimum charged commission amount.
max number: The maximum charged commission amount.
fix number: The fixed commission amount.
type string: The commission type.

hideAmount boolean: If true, the Amount field is not displayed in the B2Core UI when clients deposit funds using a deposit method; otherwise, false.
hideProceed boolean: If true, the Proceed button is not displayed in the B2Core UI when clients deposit funds using a deposit method; otherwise, false.
description string: The additional description of a deposit method.
groups array: An array of objects providing data about deposit groups in which a deposit method is included. See the Deposit Group object to learn more.

    THE DEPOSIT METHOD OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "name": "B2BinPay",
  "icon": "image.png",
  "libraryTimeToFund": "Depending on the blockchain",
  "caption": "B2BinPay",
  "pretend": true,
  "provider": "B2BinPay",
  "tradersRoomCurrencies": [
    {
      "min": {
        "value": "0.00",
        "scale": 2
      },
      "max": {
        "value": "0.00",
        "scale": 2
      },
      "icon": "image.png",
      "caption": "BTC",
      "keyCaption": "",
      "currency": {
        "alphabeticCode": "BTC",
        "minorUnit": 8,
        "name": "BTC",
        "numericCode": 1000
      }
    }    
  ],
  "paymentSystemCurrencies": [
    {
      "min": {
        "value": "0.00",
        "scale": 2
      },
      "max": {
        "value": "0.00",
        "scale": 2
      },
      "icon": "image.png",
      "caption": "USD",
      "keyCaption": "",
      "currency": {
        "alphabeticCode": "USD",
        "minorUnit": 2,
        "name": "US Dollar",
        "numericCode": 840
      }
    }
  ],
  "vendorCommissions": [
    {
      "percent": 1,
      "min": 1,
      "max": 1,
      "fix": 1,
      "type": "default",
      "numericCode": 840
    },
    {
      "percent": 1,
      "min": 1,
      "max": 1,
      "fix": 1,
      "type": "default",
      "numericCode": 1000
    }
  ],
  "providerCommissions": [
    {
      "percent": 1,
      "min": 1,
      "max": 1,
      "fix": 1,
      "type": "default",
      "numericCode": 840
    },
    {
      "percent": 1,
      "min": 1,
      "max": 1,
      "fix": 1,
      "type": "default",
      "numericCode": 1000
    }
  ],
  "hideAmount": false,
  "hideProceed": false,
  "description": "Additional deposit method description",
  "groups": [
    {
      "id": 3,
      "description": "Group description",
      "caption": "Crypto",
      "name": "Cryptocurrencies",
      "icon": "image.png"
    }
  ]
}

The Device object (Front Office)

This object provides the following data about a client device:

id integer

The device identifier.

fingerprint object

The device fingerprint data:

Show object fields

platform string: The device platform.
userAgent string: The use agent data.
webTimezone string: The time zone set in a client browser.

ipAddress string

The client IP address.

lastSignIn string

The date and time when a client last signed in to the B2Core UI using this device.

createTime string

The date and time when a device was added to a list of client devices.

    THE DEVICE OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "fingerprint": {
      "platform": "macIntel",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.1.2 Safari/605.1.15",
      "webTimezone": "Europe/Moscow"
    },
    "hash": "wyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9",
    "ipAddress": "127.0.0.1",
    "lastSignIn": "2022-01-01T00:00:00+00:00",
    "createTime": "2022-01-01T00:00:00+00:00"
  }

The Document object (Front Office)

This object provides the following data about a client document submitted for passing a verification procedure:

id integer

The identifier of a document.

type object

The details about a document type with which a document is associated:

Show object fields

id integer

The identifier of a document type.

description string

The localized description of a document type.

enabled boolean

If true, a document type can be used for verification; otherwise, false.

example string

The path to a sample document that can be uploaded for this document type.

group object

The details about a document group in which a document type is included:

Show object fields

id integer: The identifier of a document group.
description string: The localized description of a document group.
enabled boolean: If true, a document group can be used for verification; otherwise, false.
name string: The localized name of a document group.
priority integer: The priority index assigned to a document group.
type string: The type of a document group.

maxFiles integer

The maximum number of files that can be uploaded for a document type.

name string

The localized name of a document type.

priority integer

The priority index assigned to a document type.

status string

The status of a client request for document approval.

applicationId integer

The identifier of a client request for document approval.

files object

The details about a document file:

Show object fields

id integer: The identifier of a document file.
file string: The path to a document file.

createTime string

The date and time when a document was submitted.

    THE DOCUMENT OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "type": {
    "id": 1,
    "description": "Document types available for corporate clients",
    "enabled": true,
    "exаmple": "example",
    "group": {
      "id": 1,
      "description": "The documents required for corporate clients",
      "enabled": true,
      "name": "corporate",
      "priority": 1,
      "type": "one"
    },
    "maxFiles": 10,
    "name": "corporate",
    "priority": 1
  },
  "status": "approved",
  "applicationId": 1,
  "files": [
    {
      "id": 8,
      "file": "y/1662913861_photo_2022-09-08_11-23-06.jpg"
    }
  ],
  "createTime": "2022-01-01T00:00:00+00:00"
}

The Localization object (Front Office)

This object provides the following data about a localization option:

id integer

The localization option identifier.

caption string

The name of a language for which localization settings are configured.

locale string

The locale identifier (such as en_US).

isEnabled boolean

If true, a language can be selected by clients in the B2Core UI; otherwise, false.

isDefault boolean

If true, a language and the localization settings specified for it are applied by default; otherwise, false.

isRightToLeft boolean

If true, text strings are displayed in the right-to-left direction; otherwise, false.

priority integer

The priority index assigned to a localization option.

format object

The details about format settings specified for a localization option.

Show object fields

decimal string: A character used as a decimal separator.
fullDate string: The full date format (such as l, F j, Y).
fullTime string: The full time format (such as h:i:s A T).
longDate string: The long date format (such as F j, Y).
middleDate string: The middle date format starting with the month (such as M j, Y).
middleTime string: The middle time format (such as h:i:s A).
name string: The person name format (such as {title} {givenName} {familyName})
shortDate string: The short date format (such as h:i A)
shortTime string: The short time format (such as h:i A).
thousands string: A character used as a thousands separator.

    THE LOCALIZATION OBJECT (BACK OFFICE)
  
{
    "id": 1,
    "caption": "English",
    "locale": "en_EN",
    "languageCode": "en",
    "isEnabled": true,
    "isDefault": true,
    "isRightToLeft": false,
    "priority": 1,
    "format": {
      "decimal": ",",
      "fullDate": "l, F j, Y",
      "fullTime": "h:i:s A T",
      "longDate": "F j, Y",
      "middleDate": "M j, Y",
      "middleTime": "h:i:s A",
      "name": "{title} {givenName} {familyName}",
      "shortDate": "d.m.Y",
      "shortTime": "h:i A",
      "thousands": " "
    }
  }

The Menu Item object (Front Office)

This object provides the following data about a menu item:

id integer: The menu item identifier.
caption string: The menu item name displayed to clients in the B2Core UI.
name string: The menu item name used in the Back Office.
new boolean: If true, a menu item is marked as new in the B2Core UI; otherwise, false.
priority integer: The priority index assigned to a menu item.
createTime string: The date and time when a menu item was added.
updateTime string: The date and time when a menu item was last updated.

    THE MENU ITEM OBJECT (FRONT OFFICE)
  
{
  "id": 2,
  "caption": "Dashboard",
  "name": "dashboard",
  "new": true,
  "priority": 2,
  "createTime": "2022-01-01T00:00:00+00:00",
  "updateTime": "2022-01-01T00:00:00+00:00"
}

The Product Currency object (Front Office)

This object provides the following data about a product currency:

id integer

The identifier of a product currency.

caption string

The name specified for a product currency.

product object

The details about a product to which a currency is added.

Show object fields

id integer

The product identifier.

type string

The product type. Possible values:

personal
trade
demo
partner
liquidity
exchange
external
bo
iisbo
system

name string

The product name.

group object

The details about a product group in which a product is included. See the Product Group object to learn more.

platform object

The details about a platform for which a product is created.

Show object fields

id integer: The platform identifier.
caption string: The platform name displayed to clients in the B2Core UI.
shortCaption string: The platform short name.
name string: The platform name used in the Back Office.
class string: The class to which a platform is assigned.
isDemo boolean: If true, only demo accounts can be opened using the products created for this platform; otherwise, false.

currency object

The details about a product currency.

Show object fields

alphabeticCode integer: The alphabetic code of a currency (such as USD).
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The currency name.
numericCode integer: The numeric code of a currency. (such as 840).

factory integer

This parameter is set to 100 if product-associated accounts are denominated in currency subunits (for example, cents); otherwise, set to 1.

variants object

The options that can be selected by a client when opening an account denominated in a product currency.

Show object fields

startAmounts array

Applicable only for demo accounts.

An array of string values specifying the initial amounts to be deposited to demo accounts denominated in a product currency.

leverages array

An array of integer values specifying optional leverage ratios available to accounts denominated in a product currency.

platformGroups array

An array of string values specifying platform group names.

isHedgingEnabled boolean

If true, exchange operations in a product currency are hedged; otherwise, false.

maxAccounts integer

The maximum number of accounts denominated in a product currency that can be created for a client.

permissions array

An array of string values specifying permissions applied to a product. Possible values:

deposit
enabled
exchange
trade
transferDeposit
transferWithdrawal
visible
withdrawal

priority integer

The priority index assigned to a product currency.

linkInfo string

A link to an external resource providing additional information about a product.

agreementLink string

A link to a document to which a client must consent in order to open an account in a product currency.

    THE PRODUCT CURRENCY OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "caption": "USD",
  "product": {
    "id": 2,
    "type": "trade",
    "name": "MT5 Live",
    "group": {
      "id": 1,
      "caption": "MetaTrader5 Live",
      "description": "MetaTrader5 Live",
      "type": "default",
      "priority": 1,
      "createTime": "2022-01-01T00:00:00+00:00",
      "updateTime": "2022-01-01T00:00:00+00:00"
    },
    "platform": {
      "id": 1,
      "caption": "MetaTrader5 Live",
      "shortCaption": null,
      "name": "mt5",
      "class": null,
      "isDemo": false
    }
  },
  "currency": {
    "alphabeticCode": "USD",
    "minorUnit": 2,
    "name": "US Dollar",
    "numericCode": 840
  },
  "factory": 1,
  "variants": {
    "startAmounts": [
      "100.00",
      "150.00"
    ],
    "leverages": [
      1,
      5
    ]
  },
  "platformGroups": [
    "Platform group name"    
  ],
  "isHedgingEnabled": true,
  "maxAccounts": 1,
  "permissions": [
    "deposit",
    "enabled",
    "trade",
    "withdrawal"
  ],
  "priority": 1,
  "linkInfo": "https://example.url",
  "agreementLink": "https://example.url"
}

The Product Group (Front Office)

This object provides the following data about a product group:

id integer: The product group identifier.
caption string: The product group name.
description string: The product group description.
type string: The product group type.
priority integer: The priority index assigned to a product group.
createTime string: The date and time when a product group was created.
updateTime string: The date and time when a product group was last updated.

    THE PRODUCT GROUP OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "caption": "Stable Coins",
  "description": "Stable Coins",
  "type": "default",
  "priority": 1,
  "createTime": "2022-01-01T00:00:00+00:00",
  "updateTime": "2022-01-01T00:00:00+00:00"
}

The Statement object (Front Office)

This object provides the following data about a client account statement:

availableBalance string: The free funds available on an account.
currentBalance string: The current balance on an account.
credit string: The amount of credit funds on an account.
equity string: The equity of an account.
freeMargin string: The account free margin.
hold string: The amount of funds currently on hold for an account.
margin string: The account margin.
marginLevel string: The account margin level, which is a ratio of equity to margin.
pnl string: The profit-loss value calculated for an account.
updateTime string: The date and time when an account statement has last been updated.

    THE STATEMENT OBJECT (FRONT OFFICE)
  
{
  "availableBalance": "1.000000000000000000",
  "currentBalance": "1.000000000000000000",
  "credit": "1.000000000000000000",
  "equity": "1.000000000000000000",
  "freeMargin": "1.000000000000000000",
  "hold": "1.000000000000000000",
  "margin": "1.000000000000000000",
  "marginLevel": "1.000000000000000000",
  "pnl": "1.000000000000000000",
  "updateTime": "2022-01-01T00:00:00+00:00"
}

The Transaction object (Front Office)

This object provides the following data about a transaction:

transactionId integer

The transaction identifier.

creditDetails object

The details about the credit side of a transaction.

Show object fields

account object: The details about an account to which funds were credited. See the Account object (Front Office) to learn more.
amount string: The amount credited.
commission string: The transaction fee amount.
currency object: The details about a credit currency. See the Currency object to learn more.

debitDetails object

The details about the debit side of a transaction.

Show object fields

account object: The details about an account from which funds were debited. See the Account object to learn more.
amount string: The amount debited.
commission string: The transaction fee amount.
currency object: The details about a debit currency. See the Currency object to learn more.

foreignExchangeRate string

The exchange rate at which a transaction was made.

method object

The details about a method by which the transaction was made.

Show object fields

id integer: The method identifier.
name string: The localized method name.

resolution object

Applicable only in the case of a failure.

Show object fields

id integer: The identifier of a particular failure.
name string: The localized description of a failure.

status string

The current transaction status. Possible values:

cancelled
done
failed
hold
holdFailed
inProgress
new
partial
pending
rejected
refund
refundFailed
trade

Transactions with the new status are not returned.

type string

The transaction type. Possible values:

deposit
exchange
external
partner
transfer
withdrawal

createTime string

The date and time when the transaction was made.

updateTime string

The date and time when the transaction status has last been updated.

    THE TRANSACTION OBJECT (FRONT OFFICE)
  
{
  “transactionId”: 235,
    “creditDetails”: {
      “account”: {
          “accountId”: 1,
          “accountNumber”: “1",
          “caption”: “USD”,
          “currency”: {
              “alphabeticCode”: “USD”,
              “name”: “USD”,
              “numericCode”: 840,
              “minorUnit”: 2
          },
          “favourite”: true,
          “group”: {
              “id”: 3,
              “name”: “Fiat”,
              “priority”: 2
          },
          “platform”: {
              “id”: 1,
              “name”: “eWallet”
          },
          “priority”: 202,
          “statement”: {
              “availableBalance”: “2007.450000000000000000”,
              “currentBalance”: “2007.450000000000000000”,
              “credit”: “0.000000000000000000”,
              “equity”: “0.000000000000000000”,
              “freeMargin”: “0.000000000000000000”,
              “hold”: “1456.800000000000000000”,
              “margin”: “0.000000000000000000”,
              “marginLevel”: “0.000000000000000000”,
              “pnl”: “0.000000000000000000”,
              “updateTime”: “2022-10-20T11:04:07+00:00”
          },
          “type”: “personal”,
          “createTime”: “2022-10-06T08:11:58+00:00”
      },
      “amount”: “98100.0”,
      “commission”: “0.000000000000000000”,
      “currency”: {
          “alphabeticCode”: “USD”,
          “name”: “USD”,
          “numericCode”: 840,
          “minorUnit”: 2
      }
  },
  “debitDetails”: null,
  “foreignExchangeRate”: “9000”,
  “method”: {
      “id”: 1,
      “name”: “аа”
  },
  “resolution”: null,
  “status”: “pending”,
  “type”: “deposit”,
  “createTime”: “2022-10-20T11:04:27+00:00",
  “updateTime”: “2022-10-20T11:04:27+00:00"
}

The Verification Level object (Front Office)

This object provides the following data about a verification level:

id integer: The identifier of a verification level.
name string: The name of a verification level.
description string: The verification level description displayed in the B2Core UI.
mailDescription string: The email text.

nextLevel integer: The identifier of a next verification level that clients can be granted after obtaining this verification level.
roleId integer: The identifier of a permission set specifying which actions clients are allowed to perform in the B2Core UI after obtaining this verification level.
wizard string: The name of a wizard used to run a verification procedure in the B2Core UI.
default boolean: If true, a verification level is the default one and assigned to all newly registered clients; otherwise, false.
visible boolean: If true, a verification level is displayed to clients in the B2Core UI; otherwise, false.
sustainable boolean: This field value must be set to false.
options object: An array of string values specifying the groups which include the documents that must be submitted by clients.

    THE VERIFICATION LEVEL OBJECT (FRONT OFFICE)
  
{
  "id": 1,
  "name": "Level 0",
  "description": "Level description",
  "mailDescription": "Mail description",
  "nextLevel": 2,
  "roleId": 1,
  "wizard": "DocumentsWizard",
  "default": true,
  "visible": true,
  "sustainable": false,
  "options": [
    "corporate",
    "Funds Proof"
  ]
}

The Widget object (Front Office)

This object provides the following data about a widget:

id integer

The widget identifier.

caption string

The widget name displayed in the B2Core UI.

name string

The widget name used in the Back Office.

sort integer

The index indicating a sorting order for widgets in the B2Core UI.

delete boolean

If true, the Close (⨯) button is displayed on a widget, allowing clients to hide it from the dashboard in the B2Core UI; otherwise, false.

showByDefault boolean

If true, a widget is displayed on the dashboard in the B2Core UI by default; otherwise, false.

width integer

The widget width, in points.

height integer

The widget height, in points.

positionX integer

The X coordinate of the upper-right corner of a widget.

positionY integer

The Y coordinate of the upper-right corner of a widget.

entity object

The details about tickers added to the Ticker Widget.

Show object fields

id integer: The ticker identifier.
platform string: The trading platform for which data is displayed.
source string: The URL of a data source streaming data for updating tickers.

symbols array

An array of objects providing data about ticker symbols.

Show object fields

id integer

The ticker symbol identifier.

show boolean

If true, a ticker symbol is displayed in a widget by default.
If false, a ticker symbol can be selected from a list and added to a widget.

symbol string

The currency pair symbol (such as BTCUSD).

    THE WIDGET OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "caption": "Ticker Widget",
    "name": "TickerWidget",
    "sort": 1,
    "delete": true,
    "showByDefault": true,
    "width": 1,
    "height": 1,
    "positionX": 1,
    "positionY": 1,
    "entity": {
      "id": 1,
      "platform": "mt4",
      "source": "https://example.website.org",
      "symbols": [
        {
          "id": 1,
          "show": true,
          "symbol": "EURUSD"
        },
        {
          "id": 2,
          "show": true,
          "symbol": "BTCUSD"
        }
      ]
    }
  }

The Withdrawal Group object (Front Office)

This object provides the following data about a withdrawal group:

id integer: The identifier of a withdrawal group.
description string: The withdrawal group description.
caption string: The withdrawal group name displayed to clients in the B2Core UI.
name string: The withdrawal group name used in the Back Office.
icon string: The filename of an image displayed as a withdrawal group icon.

    THE WITHDRAWAL GROUP OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "description": "Group description",
    "caption": "Crypto",
    "name": "Cryptocurrencies",
    "icon": "example.png"
  }

The Withdrawal Method object (Front Office)

This object provides the following data about a withdrawal method:

id integer

The identifier of a withdrawal method.

name string

The withdrawal method name displayed to clients in the B2Core UI.

icon string

The filename of an image that is displayed as a withdrawal method icon.

libraryTimeToFund string

A hint displayed to clients in the B2Core UI about the period during which a withdrawal transaction is processed.

caption string

The withdrawal method description.

provider string

The name of a payment system used to make withdrawals.

currencies array

An array of objects providing data about each transaction currency added to a withdrawal method.

Show object fields

min object

The data about the minimum amount that can be withdrawn in a transaction currency.

Show object fields

value string: The minimum allowed withdrawal amount.
scale integer: The number of decimal places displayed when representing the minimum amount in a transaction currency.

max object

The data about the maximum amount that can be withdrawn in a transaction currency.

Show object fields

value string: The maximum allowed withdrawal amount.
scale integer: The number of decimal places displayed when representing the maximum amount in a transaction currency.

icon string

The filename of an image displayed as a currency icon.

caption string

The currency name displayed to clients in the B2Core UI.

keyCaption string

The path to a list of localized strings that can be displayed as a currency caption.

currency object

The details about a transaction currency.

Show object fields

alphabeticCode string: The alphabetic code of a currency.
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The currency name.
numericCode integer: The numeric code of a currency.

psCurrencies array

An array of objects providing data about each payment currency added to a withdrawal method.

Show object fields

min object

The data about the minimum amount that can be withdrawn in a payment currency.

Show object fields

value string: The minimum allowed withdrawal amount.
scale integer: The number of decimal places displayed when representing the minimum amount in a payment currency.

max object

The data about the maximum amount that can be withdrawn in a payment currency.

Show object fields

value string: The maximum allowed withdrawal amount.
scale integer: The number of decimal places displayed when representing the maximum amount in a payment currency.

icon string

The filename of an image displayed as a currency icon.

caption string

The currency name displayed to clients in the B2Core UI.

keyCaption string

The path to a list of localized strings that can be displayed as a currency caption.

currency object

The details about a payment currency.

Show object fields

alphabeticCode string: The alphabetic code of a currency.
minorUnit integer: The number of decimal places displayed when representing amounts in a currency.
name string: The currency name.
numericCode integer: The numeric code of a currency.

vendorCommissions array

An array of objects providing data about commissions charged by a broker.

Show object fields

percent integer: The percentage of a withdrawal amount charged as a commission.
min number: The minimum commission amount.
max number: The maximum commission amount.
fix number: The fixed commission amount.
type string: The commission type.

providerCommissions array

An array of objects providing data about commissions charged by a payment system.

Show object fields

percent integer: The percentage of a withdrawal amount charged as a commission.
min number: The minimum charged commission amount.
max number: The maximum charged commission amount.
fix number: The fixed commission amount.
type string: The commission type.

hideAmount boolean: If true, the Amount field is not displayed in the B2Core UI when clients withdraw funds using a withdrawal method; otherwise, false.
hideProceed boolean: If true, the Proceed button is not displayed in the B2Core UI when clients withdraw funds using a withdrawal method; otherwise, false.
description string: The additional description of a withdrawal method.
groups array: An array of objects providing data about withdrawal groups in which a withdrawal method is included. See the Withdrawal Group object to learn more.

    THE WITHDRAWAL METHOD OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "name": "B2BinPay",
    "icon": "image.png",
    "libraryTimeToFund": "Depending on the blockchain",
    "caption": "B2BinPay",
    "pretend": true,
    "provider": "B2BinPay",
    "currencies": [
      {
        "min": {
          "value": "0.00",
          "scale": 2
        },
        "max": {
          "value": "0.00",
          "scale": 2
        },
        "currency": {
          "alphabeticCode": "BTC",
          "minorUnit": 8,
          "name": "BTC",
          "numericCode": 1000
        }
      }
    ],
    "psCurrencies": [
      {
        "min": {
          "value": "0.00",
          "scale": 2
        },
        "max": {
          "value": "0.00",
          "scale": 2
        },
        "currency": {
          "alphabeticCode": "USD",
          "minorUnit": 2,
          "name": "US Dollar",
          "numericCode": 840
        }
      }
    ],
    "vendorCommissions": [
      {
        "percent": 1,
        "min": 1,
        "max": 1,
        "fix": 1,
        "type": "default",
        "numericCode": 840
      },
      {
        "percent": 1,
        "min": 1,
        "max": 1,
        "fix": 1,
        "type": "default",
        "numericCode": 1000
      }
    ],
    "providerCommissions": [
      {
        "percent": 1,
        "min": 1,
        "max": 1,
        "fix": 1,
        "type": "default",
        "numericCode": 840
      },
      {
        "percent": 1,
        "min": 1,
        "max": 1,
        "fix": 1,
        "type": "default",
        "numericCode": 1000
      }
    ],
    "hideAmount": true,
    "hideProceed": false,
    "description": "Additional withdrawal method description",
    "groups": [
      {
        "id": 3,
        "description": "Group description",
        "caption": "Crypto",
        "name": "Cryptocurrencies",
        "icon": "image.png"
      }
    ]
  }

The Withdrawal Template object (Front Office)

This object provides the following data about a withdrawal template:

id integer

The identifier of a withdrawal template.

name string

The name of withdrawal template.

data object`

The withdrawal data.

Show object fields

account_id integer

The identifier of an account from which funds are to be withdrawn.

amount string

The withdrawal amount.

currency_code string

The numeric code of a currency in which a withdrawal transaction is made.

method_id integer

The identifier of a withdrawal method.

groupName string

The name of a group in which a withdrawal method is included.

data object

The data specific to a withdrawal method.

Show object fields

wallet_address string: The address of a wallet to which funds are to be withdrawn.
comment string: The optional comment to a withdrawal transaction.

clientId integer

The client identifier.

createTime string

The date and time when a withdrawal template was created.

updateTime string

The date and time when a withdrawal template was last updated.

    THE WITHDRAWAL TEMPLATE OBJECT (FRONT OFFICE)
  
{
    "id": 1,
    "name": "My withdrawal template",
    "data": {
      "account_id": 275,
      "amount": "0.0001",
      "currency_code": 1000,
      "method_id": 1,
      "groupName": "Crypto",
      "data": {
          "wallet_address": "2NGWBeEcAau98dLd4CPyXfFTJCUViEXo81f",
          "comment": "Withdrawal via B2BinPay"
        }
      },
    "clientId": 1,
    "createTime": "2022-01-01T00:00:00+00:00",
    "updateTime": "2022-01-01T00:00:00+00:00"
  }