CPlugin

MT5 :: Configuration Databases :: Groups

API v1 (stable) · MT5 · 3 operations · base URL https://cloud.mywebapi.com · OpenAPI v1 (JSON) · Redoc

Every call needs Authorization: Bearer $TOKEN — an OAuth 2.0 client-credentials token from https://auth.cplugin.net/connect/token (scope webapi). $TRADE_PLATFORM_ID is the id of a trade platform registered in Toolbox.

Operations

Group by name (pumping)

GET /api/MT5/{tradePlatform}/GroupGet/{group}

Timeout: 10 s by default, adjustable per request with the X-Request-Timeout header. When the trade server does not answer in time: Nothing was changed; the request is safe to repeat.

Parameters

NameInTypeRequiredDescription
tradePlatform path string (uuid) yes Trade platform id
group path string yes Name of the configuration
X-Request-Timeout header number (double) no How long to wait for the trade server, in seconds (1–300). Default for this operation: 10 s (read). The query parameter requestTimeout does the same for clients that cannot set headers. The applied value is returned in the X-Request-Timeout-Applied response header.

Responses

Example

curl "https://cloud.mywebapi.com/api/MT5/$TRADE_PLATFORM_ID/GroupGet/$GROUP" \
  -H "Authorization: Bearer $TOKEN"

Group by name

GET /api/MT5/{tradePlatform}/GroupRequest/{group}

Timeout: 10 s by default, adjustable per request with the X-Request-Timeout header. When the trade server does not answer in time: Nothing was changed; the request is safe to repeat.

Parameters

NameInTypeRequiredDescription
tradePlatform path string (uuid) yes Trade platform id
group path string yes Name of the configuration
X-Request-Timeout header number (double) no How long to wait for the trade server, in seconds (1–300). Default for this operation: 10 s (read). The query parameter requestTimeout does the same for clients that cannot set headers. The applied value is returned in the X-Request-Timeout-Applied response header.

Responses

Example

curl "https://cloud.mywebapi.com/api/MT5/$TRADE_PLATFORM_ID/GroupRequest/$GROUP" \
  -H "Authorization: Bearer $TOKEN"

Groups by mask

GET /api/MT5/{tradePlatform}/GroupRequestArray/{mask}

Timeout: 10 s by default, adjustable per request with the X-Request-Timeout header. When the trade server does not answer in time: Nothing was changed; the request is safe to repeat.

Parameters

NameInTypeRequiredDescription
tradePlatform path string (uuid) yes Trade platform id
mask path string yes One or more groups separated by commas. Specify the full name of the group, including the path. For example, demo\demoforex. The group name can be obtained using the IMTConGroup::Group method. Groups can also be specified using wildcard characters: "*" (any value) and "!" (exclude). For example: "demo*,!demoforex" — all groups whose names begin with 'demo', except for the group demoforex.
X-Request-Timeout header number (double) no How long to wait for the trade server, in seconds (1–300). Default for this operation: 10 s (read). The query parameter requestTimeout does the same for clients that cannot set headers. The applied value is returned in the X-Request-Timeout-Applied response header.

Responses

Example

curl "https://cloud.mywebapi.com/api/MT5/$TRADE_PLATFORM_ID/GroupRequestArray/$MASK" \
  -H "Authorization: Bearer $TOKEN"

Schemas

Types the operations above take and return, with their first-level properties; * marks a required one. The full graph is in the OpenAPI specification.

MT5ConGroup

PropertyTypeDescription
group string, nullable group name
server integer (int64), nullable group trade server ID
permissionsFlags EnPermissionsFlags EnPermissionsFlags
authMode EnAuthMode EnAuthMode
authPasswordMin integer (int32), nullable minimal password length
company string, nullable company name
companyPage string, nullable company web page URL
companyEmail string, nullable company email
companySupportPage string, nullable company support site URL
companySupportEmail string, nullable company support email
companyCatalog string, nullable company catalog name (for reports and email templates)
currency string, nullable deposit currency
currencyDigits integer (int32), nullable
reportsMode EnReportsMode EnReportsMode
reportsFlags EnReportsFlags EnReportsFlags
reportsSMTP string, nullable reports SMTP server address:ports
reportsSMTPLogin string, nullable reports SMTP server login
reportsSMTPPass string, nullable reports SMTP server password
newsMode EnNewsMode EnNewsMode
newsCategory string, nullable news category filter string
newsLang integer (int32)[] Setter not yet implemented. If you want to send this value to MT5, ask vendor to implement this feature. Exception will be thrown if you send anything but null here. allowed news languages (Windows API LANGID used)
mailMode EnMailMode EnMailMode
tradeFlags EnTradeRightsFlags EnTradeFlags
tradeInterestRate number (double), nullable interest rate for free deposit money
tradeVirtualCredit number (double), nullable virtual credit
marginFreeMode EnFreeMarginMode EnFreeMarginMode
marginSOMode EnStopOutMode EnStopOutMode
marginCall number (double), nullable Margin Call level value
marginStopOut number (double), nullable Sto-Out level value
demoLeverage integer (int32), nullable default demo accounts leverage
demoDeposit number (double), nullable default demo accounts deposit
limitHistory EnHistoryLimit EnHistoryLimit
limitOrders integer (int32), nullable max. order limit
limitSymbols integer (int32), nullable max. selected symbols limit
commissions map<string, MT5ConCommission> /// Setter not yet implemented. If you want to send this value to MT5, ask vendor to implement this feature. Exception will be thrown if you send anything but null here.
marginFreeProfitMode integer (int32), nullable margin free profit accounting mode
marginMode EnMarginMode group risk management mode - EnMarginMode
authOTPMode EnAuthOTPMode OTP authentication mode - EnAuthOTPMode
tradeTransferMode EnTransferMode deposit transfer mode - EnTransferMode
marginFlags EnMarginCalcFlags margin calculation flags EnMarginFlags
limitPositions integer (int32), nullable max. positions limit
reportsEmail string, nullable reports SMTP email account
companyDepositPage string, nullable company deposit URL
companyWithdrawalPage string, nullable company deposit URL
demoInactivityPeriod integer (int32), nullable demo groups in days, orders and positions will be deleted after this period

EnPermissionsFlags

Flags: names of the set bits joined by ", " ("CertConfirm, EnableConnection"), "None" when none is set; a set bit without a name is "Bit<n>" (bit number). Bits: CertConfirm = 0x1, EnableConnection = 0x2, ResetPassword = 0x4, ForcedOtpUsage = 0x8, RiskWarning = 0x10, RegulationProtect = 0x20, NotifyDeals = 0x40, NotifyOrders = 0x80, NotifyBalances = 0x100. Accepted on input, never written: NotifyAll = NotifyDeals, NotifyOrders, NotifyBalances; All = CertConfirm, EnableConnection, ResetPassword, ForcedOtpUsage, RiskWarning, RegulationProtect, NotifyDeals, NotifyOrders, NotifyBalances.

EnAuthMode

Values: Standard, Rsa1024, Rsa2048, RsaCustom

EnReportsMode

Values: Disabled, Full, EODOnly, EOMOnly

EnReportsFlags

Flags: names of the set bits joined by ", " ("Email, Support"), "None" when none is set; a set bit without a name is "Bit<n>" (bit number). Bits: Email = 0x1, Support = 0x2, Statements = 0x4. Accepted on input, never written: All = Email, Statements.

EnNewsMode

Values: Disabled, Headers, Full

EnMailMode

Values: Disabled, Full

EnTradeRightsFlags

Flags: names of the set bits joined by ", " ("Swaps, Trailing"), "None" when none is set; a set bit without a name is "Bit<n>" (bit number). Bits: Swaps = 0x1, Trailing = 0x2, Experts = 0x4, Expiration = 0x8, SignalsAll = 0x10, SignalsOwn = 0x20, SOCompensation = 0x40, SOFullyHedged = 0x80, FifoClose = 0x100, HedgeProhibit = 0x200, DealCost = 0x400, SOCompensationCredit = 0x800. Accepted on input, never written: Default = Swaps, Trailing, Experts, Expiration, SignalsAll; All = Swaps, Trailing, Experts, Expiration, SignalsAll, SignalsOwn, SOCompensation, SOFullyHedged, FifoClose, HedgeProhibit, DealCost, SOCompensationCredit.

EnFreeMarginMode

Values: NotUsePL, UsePL, Profit, Loss

EnStopOutMode

Values: Percent, Money

EnHistoryLimit

Values: All, Months1, Months3, Months6, Year1, Year2, Year3

MT5ConCommission

PropertyTypeDescription
name string, nullable commission name
description string, nullable description
path string, nullable symbols path
mode EnCommMode EnCommMode
rangeMode EnCommRangeMode EnCommRangeMode
chargeMode EnCommChargeMode EnCommChargeMode
tiers MT5ConCommTier[] commission tiers. Index in array from 0 means Position of the range.
turnoverCurrency string, nullable - turnover calculation currency
entryMode EnCommEntryMode EnCommEntryMode
actionMode EnCommActionMode EnCommActionMode
profitMode EnCommProfitMode EnCommProfitMode
reasonFlags EnCommReasonFlags EnCommReasonFlags

EnMarginMode

Values: Retail, ExchangeDiscount, RetailHedged

EnAuthOTPMode

Values: Disabled, TotpSha256, TotpSha256Web

EnTransferMode

Values: TransferModeDisabled, TransferModeName, TransferModeGroup, TransferModeNameGroup

EnMarginCalcFlags

Flags: names of the set bits joined by ", " ("ClearAcc"), "None" when none is set; a set bit without a name is "Bit<n>" (bit number). Bits: ClearAcc = 0x1.