Open orders

const response = await client.request({
  id: ctx.id,
  epoch: ctx.epoch,
  expiresAt: ctx.expiresAt,
  command: {
    kind: 'read',
    query: { family: 'openOrders', limit: 32 },
  },
});

({
  kind: 'page',
  family: 'openOrders',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'operation',
      committedAt: observedAt,
      command: {
        kind: 'order', market: ctx.market, lots: 2n,
        minimum: 90n, maximum: 110n, fee: 1n,
        tif: 'IOC', reduceOnly: false, goodUntil: ctx.goodUntil,
      },
      receipt: {
        kind: 'receipt',
        id: ctx.originalOrderId,
        digest: recordedIntentDigest,
        policy: approvedPolicyVersion,
        outcome: 'unknown',
        filled: 1n,
        paid: 0n,
        railFees: 0n,
        feeCap: 2n,
        possiblyExposed: true,
        allowPartial: false,
      },
    },
  ],
})

({ kind: 'error', code: 'conflict' })

const response = await client.request({
  id: ctx.id,
  epoch: ctx.epoch,
  expiresAt: ctx.expiresAt,
  command: {
    kind: 'read',
    query: { family: 'openOrders', limit: 32 },
  },
});

({
  kind: 'page',
  family: 'openOrders',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'operation',
      committedAt: observedAt,
      command: {
        kind: 'order', market: ctx.market, lots: 2n,
        minimum: 90n, maximum: 110n, fee: 1n,
        tif: 'IOC', reduceOnly: false, goodUntil: ctx.goodUntil,
      },
      receipt: {
        kind: 'receipt',
        id: ctx.originalOrderId,
        digest: recordedIntentDigest,
        policy: approvedPolicyVersion,
        outcome: 'unknown',
        filled: 1n,
        paid: 0n,
        railFees: 0n,
        feeCap: 2n,
        possiblyExposed: true,
        allowPartial: false,
      },
    },
  ],
})

({ kind: 'error', code: 'conflict' })

Carrier: POST /v1/exchange (encrypted binary). Read family: openOrders · Permission: owner or current READ agent. Nonterminal private orders, including uncertain and cancel-pending orders. Results are private to the bound account. The same query is available over HTTP and WebSocket, including subscriptions.

These are signed SDK fields and decoded results, not a plaintext JSON HTTP body. The shared carrier accepts encrypted application/octet-stream.

const response = await client.request({
  id: ctx.id,
  epoch: ctx.epoch,
  expiresAt: ctx.expiresAt,
  command: {
    kind: 'read',
    query: { family: 'openOrders', limit: 32 },
  },
});

({
  kind: 'page',
  family: 'openOrders',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'operation',
      committedAt: observedAt,
      command: {
        kind: 'order', market: ctx.market, lots: 2n,
        minimum: 90n, maximum: 110n, fee: 1n,
        tif: 'IOC', reduceOnly: false, goodUntil: ctx.goodUntil,
      },
      receipt: {
        kind: 'receipt',
        id: ctx.originalOrderId,
        digest: recordedIntentDigest,
        policy: approvedPolicyVersion,
        outcome: 'unknown',
        filled: 1n,
        paid: 0n,
        railFees: 0n,
        feeCap: 2n,
        possiblyExposed: true,
        allowPartial: false,
      },
    },
  ],
})

({ kind: 'error', code: 'conflict' })

Request fields

Use the configured client and envelope. Each request supplies id, current epoch and authentication expiresAt, as shown in the example.

"read"

required

Read-command discriminator.

"openOrders"

required

Selects this exact private projection.

number

required

Integer from 1 to 64 rows. The example requests 32.

Uint8Array (40 bytes)

Omit or use all-zero bytes to start. For another page, use the prior page’s next under the same snapshot revision.

Response fields

Illustrative decoded SDK values are shown at the right; absent optional fields mean unavailable, not zero. Empty rows is valid.

"page"

required

Paged-response discriminator.

"openOrders"

required

The requested family.

Uint8Array (32 bytes)

required

Commitment to the permitted snapshot and query identity, not a global activity counter.

Uint8Array (40 bytes)

required

Next cursor; all-zero means no more retained rows.

bigint (u64)

required

Qualified Cinder evaluation time, in milliseconds.

ReadRow[]

required

At most the requested limit.

Show Open orders row fields

"operation"

required

Same row shape as operations.

bigint (u64)

required

Qualified Cinder transaction-observation time, in milliseconds.

Order

required

Original bounded order command.

Receipt

required

Current order outcome and actual attributed fill progress.

Behavior

Includes order operations whose outcome is neither complete nor rejected. Unknown and cancel-pending exposure stays visible. A cancel acknowledgement is not evidence that no late fill can arrive.

Paging and errors

Read queries do not change financial state or consume order budgets. Permissions filter rows before paging. Changed permitted rows return encrypted conflict; restart at zero instead of combining revisions. End-of-pages covers retained rows, not complete external venue history. See paging, errors, limits and availability. A disconnected subscription needs fresh attestation, current authority and a replacement snapshot.

Overview

Commands

Private reads

WebSocket

Request fields

Response fields

Behavior

Paging and errors

​Request fields

​Response fields

​Behavior

​Paging and errors

Request fields

Response fields

Behavior

Paging and errors