Skip to main content

Read settlements

Daily settlement batches (CXS-YYYYMMDD-NNN). See the settlement concept.

List​

GET /api/v1/cex/settlements — keyset-paginated.

ParamNotes
statusPENDING | UNDER_REVIEW | SETTLED | VOID | FAILED
producte.g. ORBIS
chainChain filter
businessDateFrom / businessDateToYYYY-MM-DD
cursor, limit1–200 (default 50)

Row: batchRef, businessDate, product, chain, status, netUsdt (signed string), netUnits (signed string), settledAt (nullable).

Detail​

GET /api/v1/cex/settlements/{batchRef} — one batch plus per-user lines:

{
"requestId": "req_8f3c1a",
"data": {
"batchRef": "CXS-20260902-001",
"businessDate": "2026-09-02",
"product": "ORBIS",
"status": "SETTLED",
"netUsdt": "10000.00",
"netUnits": "9771.290000",
"settledAt": "2026-09-03T00:10:00.000Z",
"userLines": [
{ "exchangeUserId": "user-123", "netUnits": "9771.290000", "netUsdt": "10000.00" }
]
}
}

An unknown or cross-partner batchRef returns CEX_SETTLEMENT_NOT_FOUND (404).

CSV export​

GET /api/v1/cex/settlements/export — CSV of the filtered list. Not enveloped; 5/min.