Settlement Status

Query the status of settlement batches.

Get Batch Status

GET /settlement/status/{batchId}

Auth: Authorization: Bearer <access_token>.

Example

curl https://api.godarkdex.com/api/v1/settlement/status/batch_01HXYZ123 \
  -H "Authorization: Bearer $TOKEN"

Response

{
  "code": 0,
  "data": {
    "batch_id": "batch_01HXYZ123",
    "status": "SETTLED",
    "tx_signature": "5xKXtg2CW87d9Z...",
    "trade_count": 42,
    "created_at": "2026-04-20T10:30:00.123Z",
    "settled_at": "2026-04-20T10:30:00.520Z"
  },
  "timestamp": "2026-04-20T10:30:01.000Z",
  "request_id": "req_01HXYZ..."
}

Status Values

Status	Description
`PENDING`	Batch is being assembled
`PROCESSING`	Settlement transaction submitted
`SETTLED`	On-chain settlement confirmed
`FAILED`	Settlement failed (will retry)

Settlement Timing

Stage	Typical Duration
Batch assembly	1–2 seconds
On-chain confirmation	Typically begins around Solana slot time (~400ms); finalized settlement follows Solana finality
Total end-to-end	< 5 seconds typical

Verifying Settlement

Each settlement transaction can be verified on-chain using the returned tx_signature:

Use a Solana block explorer (e.g. Solscan, Solana Explorer).
Look up the tx_signature to view transaction detail.
Verify shielded-pool state updates, aggregate collateral movement, and fee transfers.

For aggregate, account-agnostic settlement and reserve data, see Transparency.