Docs
Accounts

Move an account to another server

POST
/v1/accounts/{id}/server

For a login refused because it was added under the wrong server name: keeps the stored password and tries it on server instead, so the password is not sent again. The broker's likely servers are in the account's problem.otherServers. With connect: true (the default) the account is brought online straight away, so the answer comes back in seconds — watch state, or the account's events.

409 ACCOUNT_EXISTS when that login is already connected on that server here; 409 NO_PASSWORD when no password is stored (send one to /password instead).

Authorization

apiKey
AuthorizationBearer <token>

Authorization: Bearer fx_live_<id>_<secret>.

A key is shown once, at creation. We cannot show it again or recover it for you. Keys carry a label (live or test) in the key itself, so each configuration is easy to tell apart. Both reach real brokers: test with a broker demo account.

Scopes are per key. A key without accounts:write can read accounts and nothing else.

In: header

Path Parameters

id*string
Formatuuid

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/server" \  -H "Content-Type: application/json" \  -d '{    "server": "JustMarkets-Demo"  }'
{  "data": {    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",    "label": null,    "login": "string",    "server": "string",    "mode": "always_on",    "state": "created",    "stateDetail": null,    "stateChangedAt": "2019-08-24T14:15:22Z",    "problem": null,    "currency": null,    "leverage": null,    "marginMode": null,    "tradeAllowed": null,    "brokerName": null,    "environment": "demo",    "tradingDisabled": true,    "createdAt": "2019-08-24T14:15:22Z"  }}