Docs
History

List orders

GET
/v1/orders

Every order this workspace has placed, newest first, across all accounts unless accountId narrows it. Filter by state to find what needs attention — state=unknown is the set whose result we are still confirming with the broker.

Paginated by cursor rather than offset: an offset shifts as new orders arrive, so page two would silently skip rows.

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 an environment (live or test) in the key itself, so a test key pasted into a production config fails immediately instead of at the worst possible moment.

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

In: header

Query Parameters

accountId?string

Narrow to one account.

Formatuuid
state?string

unknown is the set whose result we are still confirming with the broker.

Value in

  • "accepted"
  • "validating"
  • "sending"
  • "working"
  • "completed"
  • "filled"
  • "partially_filled"
  • "rejected"
  • "failed"
  • "unknown"
  • "cancelled"
  • "expired"
symbol?string
Lengthlength <= 32
since?string
Formatdate-time
until?string
Formatdate-time
limit?integer
Range1 <= value <= 200
Default50
cursor?string

The nextCursor from the previous page.

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/orders"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "accountId": "3d07c219-0a88-45be-9cfc-91e9d095a1e9",      "clientOrderId": null,      "symbol": "string",      "side": "buy",      "type": "market",      "intent": "open",      "brokerPositionId": null,      "volume": null,      "stopLoss": null,      "takeProfit": null,      "state": "accepted",      "stateDetail": null,      "needsReconciliation": true,      "retcode": null,      "retcodeText": null,      "brokerOrderId": null,      "brokerDealId": null,      "filledVolume": null,      "filledPrice": null,      "sentAt": null,      "settledAt": null,      "reconciledAt": null,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "page": {    "hasMore": true,    "nextCursor": null  }}

Fetch one order GET

The authoritative record of one order: what was asked for, what the broker returned, and its own return code unmodified. Poll this after an `ORDER_UNRESOLVED` response — the order moves out of `unknown` as soon as we have confirmed the result with the broker.

Cancel a multi-account order before it is sent POST

Only while nothing has been sent. Once orders are going out there is no cancelling them — `cancelled` would claim nothing was sent, and that is exactly the promise we can no longer make.