Read settlements
Daily settlement batches (CXS-YYYYMMDD-NNN). See the
settlement concept.
List
GET /api/v1/cex/settlements — keyset-paginated.
| Param | Notes |
|---|---|
status | PENDING | UNDER_REVIEW | SETTLED | VOID | FAILED |
product | e.g. ORBIS |
chain | Chain filter |
businessDateFrom / businessDateTo | YYYY-MM-DD |
cursor, limit | 1–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.