Error

A valid request URL is required to generate request examples

{
  "version": "external-open-orders/v1",
  "accountId": "<string>",
  "orders": [
    {
      "orderId": "<string>",
      "accountId": "<string>",
      "marketId": "<string>",
      "side": "buy",
      "status": "open",
      "priceAtoms": "<string>",
      "quantityAtoms": "<string>",
      "filledQuantityAtoms": "<string>",
      "remainingQuantityAtoms": "<string>",
      "reduceOnly": true,
      "sequence": 1,
      "receivedAtEpochMs": 1,
      "createdJournalSequence": 1,
      "updatedJournalSequence": 1,
      "priceScale": 1,
      "quantityScale": 1
    }
  ],
  "openOrderCount": 1,
  "truncated": true,
  "snapshotSequence": 1,
  "resync": {
    "stream": "account.orders",
    "fromSequence": 1
  },
  "marketId": "<string>"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

Accounts

Get live open orders

Returns the account’s currently working orders read from the matching engine’s in-memory book. This is live state, unlike the order-history surface, which pages a lagging projection of submitted commands and carries no outcome. The page is bounded: truncated and openOrderCount report any shortfall, and resync is only meaningful when truncated is false. Amounts are exact atoms and each order carries its own market’s scales, because a list can span markets that disagree on scale.

Method and path: GET /v1/accounts//orders/open

Authentication: DFNS trader bearer required.

Request schema: none.

Response schema: ExternalOpenOrdersResponse.

Error envelope: ExternalRestError (external-rest-error/v1).

GET

accounts

{accountId}

orders

open

Error

A valid request URL is required to generate request examples

{
  "version": "external-open-orders/v1",
  "accountId": "<string>",
  "orders": [
    {
      "orderId": "<string>",
      "accountId": "<string>",
      "marketId": "<string>",
      "side": "buy",
      "status": "open",
      "priceAtoms": "<string>",
      "quantityAtoms": "<string>",
      "filledQuantityAtoms": "<string>",
      "remainingQuantityAtoms": "<string>",
      "reduceOnly": true,
      "sequence": 1,
      "receivedAtEpochMs": 1,
      "createdJournalSequence": 1,
      "updatedJournalSequence": 1,
      "priceScale": 1,
      "quantityScale": 1
    }
  ],
  "openOrderCount": 1,
  "truncated": true,
  "snapshotSequence": 1,
  "resync": {
    "stream": "account.orders",
    "fromSequence": 1
  },
  "marketId": "<string>"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

{
  "version": "external-rest-error/v1",
  "requestId": "<string>",
  "code": "invalid_request",
  "safeMessage": "<string>",
  "retryable": true,
  "recoveryActions": [
    "none"
  ],
  "occurredAtEpochMs": 1,
  "realtimeTicketFailure": "invalid"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

accountId

string

required

Minimum string length: 1

Query Parameters

marketId

string

Optional market filter.

Minimum string length: 1

limit

integer

default:500

Page size, from 1 to 500. Defaults to 500.

Required range: x <= 500

Response

Success

version

string

required

Allowed value: "external-open-orders/v1"

accountId

string

required

Minimum string length: 1

orders

object[]

required

Maximum array length: 500

Show child attributes

openOrderCount

integer

required

Required range: x >= 0

truncated

boolean

required

snapshotSequence

integer

required

Required range: x >= 0

resync

object

required

Show child attributes

marketId

string

Minimum string length: 1

Account policy

External REST API

Get live open orders

Authorizations

Path Parameters

Query Parameters

Response