Configured markets

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

({
  kind: 'page',
  family: 'markets',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'market', market: ctx.market, precision: 1,
      quote: quoteUnitId, quotePrecision: 1, numerator: 1n,
      denominator: 1n, modes: 7, leverageCap: 20_000n,
    },
  ],
})

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

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

({
  kind: 'page',
  family: 'markets',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'market', market: ctx.market, precision: 1,
      quote: quoteUnitId, quotePrecision: 1, numerator: 1n,
      denominator: 1n, modes: 7, leverageCap: 20_000n,
    },
  ],
})

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

Carrier: POST /v1/exchange (encrypted binary). Read family: markets · Permission: owner or current READ agent. Governed market units, exact quote conversion and capability mask. 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: 'markets', limit: 32 },
  },
});

({
  kind: 'page',
  family: 'markets',
  revision: snapshotRevision,
  next: new Uint8Array(40),
  evaluatedAt: observedAt,
  rows: [
    {
      kind: 'market', market: ctx.market, precision: 1,
      quote: quoteUnitId, quotePrecision: 1, numerator: 1n,
      denominator: 1n, modes: 7, leverageCap: 20_000n,
    },
  ],
})

({ 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.

"markets"

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.

"markets"

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 Configured markets row fields

"market"

required

Market-row discriminator.

Uint8Array (32 bytes)

required

Configured market ID.

number (u32)

required

Market precision version, not decimal places.

Uint8Array (32 bytes)

required

Configured quote-unit ID.

number (u32)

required

Quote-unit precision version.

bigint (u64)

required

Positive numerator in exact quote-atom-per-lot-times-tick conversion.

bigint (u64)

required

Positive denominator in the same conversion.

number

required

Supported mode mask, currently 7 for GTC, ALO and IOC.

bigint (u64)

Optional maximum multiplier scaled by 10,000.

Behavior

Conversion is lots × ticks × numerator / denominator in quote atoms, subject to governed exactness rules. This is kernel configuration, not public listings, ticker labels, book depth or chart data. Native/display mappings require approved configuration; a mode bit alone does not qualify live native execution.

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

Configured markets

Request fields

Response fields

Behavior

Paging and errors

​Request fields

​Response fields

​Behavior

​Paging and errors

Request fields

Response fields

Behavior

Paging and errors