Create account .

POST

Request

/accounts

Body

{
    "account_name": "Demo",
    "mt_version": 4,
    "account_number": 123456,
    "password":"password",
    "broker_server_id": 1
}

Response

{
    "result": "success",
    "status": 200,
    "data": {
        "id": 90,
        "created_at": "2021-03-18T15:26:19.000000Z",
        "updated_at": "2021-03-18T15:26:19.000000Z",
        "mt_version": 4,
        "account_name": "Demo",
        "account_number": 123456,
        "password": "password",
        "broker_server_id": 1,
        "broker_server_address": null,
        "status": "allocating",
        "login_response": null
    }
}

Attributes

Field Required Accepted Description
mt_version yes 4 or 5 MT version of account
account_name yes string A reference name
account_number yes integer MT account number
password yes string MT account password
broker_server_id yes (if not using broker_server_address) integer Valid broker server ID
broker_server_address yes (if not using broker_server_id) string The real address found in the srv file, this can only be added for MT4 accounts

Account connection status

When you add an account it can take up to 1 minute to know whether the connection was successful. To know the result of a connection you need to check the status field. We recommend you poll once every 10 seconds for the latest status. See Get account for more details.

Fail codes

Code Status Description
too_many_accounts 422 You are at the maximum amount of accounts for your subscription package
broker_server_address_only_mt4 422 Broker server address only available for MT4

Stay in the loop..

Sign up to our newsletter to keep up-to-date.