Confirm pending results with the broker now
Confirms the result of every opening order on this account still in unknown, and brings its deals and positions up to date with the broker. A close, stop change or cancel in unknown is not settled from deal history — its stateDetail says to check the position or order at the broker.
This happens automatically; call it when you do not want to wait. It is safe to call at any time and safe to call twice — nothing is recorded or settled twice.
ambiguous counts orders whose result the broker's records do not settle unambiguously. Those are left in unknown on purpose: a wrong guess produces a history that looks settled and is wrong, which is worse than the gap. They need a human.
skipped is no-runtime when the account is offline: bring it online and call again.
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
application/json
curl -X POST "https://example.com/v1/accounts/497f6eca-6276-4993-bfeb-53cbbbba6f08/reconcile"{ "data": { "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9", "examined": 0, "resolved": 0, "stillUnknown": 0, "ambiguous": 0, "historyNotReady": 0, "historyReady": null, "dealsIngested": 0, "positionsOpen": 0, "positionsClosed": 0, "skipped": null }}Close a position POST
Closes a position in whole, or partly if you send a `volume`. **Send an `Idempotency-Key`.** It matters more here than on an opening order: a retried close does not close twice, it opens an opposing position, and the account ends up with exposure nobody chose. The three failure modes are the same as for an opening order, and `ORDER_UNRESOLVED` means the same thing — **do not resend**, poll the order. An unresolved close is the case where you might believe you are flat and not be.
Margin required, or profit at a price POST
Opens nothing and is safe to call freely. This is how you find out an order will be refused for margin *before* sending it, rather than collecting a `10019` from the broker. The account must be online: an offline account is refused with 409 `NO_RUNTIME`. A null `value` means the broker would not answer, which is not the same as zero.