Skip to content



Metatrader account model


Name Type Required Description
_id string Yes account id
login string Yes metaTrader account number. Only digits are allowed
name string Yes human-readable account name
server string metaTrader server name to connect to
provisioningProfileId string id of the provisioning profile that was used as the basis for creating this account
magic number magic value the trades should be performed using
application string Yes application to connect MetaTrader terminal to, enum: MetaApi, CopyFactory
connectionStatus string Yes connection status of the MetaTrader terminal to the application, enum: CONNECTED, DISCONNECTED, DISCONNECTED_FROM_BROKER
state string Yes current account state, enum: CREATED, DEPLOYING, DEPLOYED, UNDEPLOYING, UNDEPLOYED, DELETING
type string Yes Account type. Executing accounts as cloud-g2 is faster and cheaper. Cloud and cloud-g2 are aliases, enum: cloud, cloud-g1, cloud-g2, default: cloud
accessToken string Yes authorization access token to be used for accessing single account data. Intended to be used in browser API.
region string Yes Region id to deploy account at. One of returned by the /users/current/regions endpoint
manualTrades boolean Flag indicating if trades placed on this account are manual trades. Default is false. Supported for G2 only.
slippage number Default trade slippage in points. Should be greater or equal to zero. If not specified, system internal setting will be used which we believe is reasonable for most cases
quoteStreamingIntervalInSeconds number Quote streaming interval in seconds. Set to 0 in order to receive quotes on each tick. Default value is 2.5 seconds. Intervals less than 2.5 seconds are supported only for G2.
extensions Array<Extension> API extensions
tags Array User-defined account tags
metadata object Extra information which can be stored together with your account. Total length of this field after serializing it to JSON is limited to 1024 characters
reliability string Used to increase the reliability of the account. Allowed values are regular and high. Default is regular. 'high' is a recommended value for production environment
baseCurrency string 3-character ISO currency code of the account base currency. Default value is USD. The setting is to be used for copy trading accounts which use national currencies only, such as some Brazilian brokers. You should not alter this setting unless you understand what you are doing.
copyFactoryRoles Array Account roles for CopyFactory2 application. Allowed values are PROVIDER and SUBSCRIBER
resourceSlots number Number of resource slots to allocate to account. Allocating extra resource slots results in better account performance under load which is useful for some applications. E.g. if you have many accounts copying the same strategy via CooyFactory API, then you can increase resourceSlots to get a lower trade copying latency. Please note that allocating extra resource slots is a paid option. Default is 1
copyFactoryResourceSlots number Number of CopyFactory 2 resource slots to allocate to account. Allocating extra resource slots results in lower trade copying latency. Please note that allocating extra resource slots is a paid option. Please also note that CopyFactory 2 uses redundant infrastructure so that each CopyFactory resource slot is billed as 2 standard resource slots. You will be billed for CopyFactory 2 resource slots only if you have added your account to CopyFactory 2 by specifying copyFactoryRoles field. Default is 1
accountReplicas Array<MetatraderAccountReplica> MetaTrader account replicas. Only primary account can have replicas
connections Array<AccountConnection> Yes active account connections
riskManagementApiEnabled boolean Flag indicating that risk management API should be enabled on account. Default is false


  "_id": "1eda642a-a9a3-457c-99af-3bc5e8d5c4c9",
  "login": "login",
  "name": "mt5a",
  "server": "ICMarketsSC-Demo",
  "provisioningProfileId": "f9ce1f12-e720-4b9a-9477-c2d4cb25f076",
  "magic": 123456,
  "application": "MetaApi",
  "connectionStatus": "DISCONNECTED",
  "state": "DEPLOYED",
  "type": "cloud",
  "manualTrades": true,
  "quoteStreamingIntervalInSeconds": 2.5,
  "connections": [{"region": "vint-hill", "zone": "a", "application": "MetaApi"}]