Poll lifecycle state
The endpoint to poll after bringing an account online. Cheap enough to call every second or two; state reaches ready when the account is logged in and ready to trade.
Authorization
apiKey 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
uuidResponse Body
application/json
application/json
application/json
curl -X GET "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/status"{ "data": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "state": "created", "detail": null, "since": "2019-08-24T14:15:22Z", "mode": "always_on", "tradingDisabled": true }}Move an account to another server POST
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).
Replace an account's password POST
Gives a connected account a new trading password — after the member changed it at the broker, or when the account is in `invalid_credentials` because the one it had was wrong. Send `server` as well to correct the server name. The account is taken offline first (refused with `409` while an order is in flight), the new password is encrypted and stored, and only then is the old one erased — a failure leaves the old credential in place. The account lands in `created` and comes online on the next order or when you bring it online; bring it online straight away to check the new password while the member is still there. The password is never returned or logged.