Fetch one account
One connected account: its login, server, label, mode, current state and when it last changed. The password is never included. Another workspace's account is 404. Balance, equity and margin are the last read from the terminal (figuresObservedAt); GET /v1/accounts/{id}/figures?fresh=true asks it now.
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"{ "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": "netting", "tradeAllowed": null, "brokerName": null, "environment": "demo", "tradingDisabled": true, "createdAt": "2019-08-24T14:15:22Z", "balance": "10012.25000000", "equity": "10012.25000000", "margin": "10012.25000000", "freeMargin": "10012.25000000", "marginLevel": "10012.25000000", "credit": "10012.25000000", "profit": "10012.25000000", "figuresObservedAt": null }}Delete an account and its history DELETE
Removes the account for good: its terminal is stopped, its password erased, and the record deleted with its orders, deals and positions. **This cannot be undone.** To stop trading on an account but keep its history readable, disconnect it instead. Refused with `409` while an order is in flight (`ACCOUNT_EXECUTING`), while a multi-account order that includes it has not finished (`ACCOUNT_IN_WAVE`), and when our last look found open positions (`ACCOUNT_HAS_POSITIONS`): those stay open at the broker with their stops, but could no longer be shown or closed here. Close them first, or send `force=true` to delete anyway. Alert hooks stop sending to the account; a hook left with no accounts is switched off. This month's usage is unaffected. The same login and server can be connected again afterwards, as a new account.
List connected accounts GET
Every account in this workspace, newest first.