Skip to main content

Daily cutoff & settlement

Orders are grouped by a daily cutoff into a settlement batch, identified CXS-YYYYMMDD-NNN. A batch nets the day's SUBSCRIBE and REDEEM activity per product and chain into a single delivery, then reconciles it on-chain.

Draft — subject to change

The exact cutoff time and timezone, and the full batch state list, are pending final confirmation from ORB-1199. The mechanics below are stable.

This page is a work in progress. Do not build production integrations against it.

Reading settlements​

Use the read API to track batches:

  • GET /api/v1/cex/settlements — list your batches (keyset-paginated).
  • GET /api/v1/cex/settlements/{batchRef} — one batch plus per-user lines (userLines[], each { exchangeUserId, netUnits, netUsdt }).
  • GET /api/v1/cex/settlements/export — CSV of the filtered list.

A batch carries a collapsed status (PENDING, UNDER_REVIEW, SETTLED, VOID, FAILED), a signed netUsdt/netUnits (string), and settledAt.

Payment confirmation (advanced)​

If enabled for your partner, you can fast-track a batch's inbound leg by submitting your payment transaction hash — see Confirm payment.