Get the status of a withdrawal.
GET/v1/withdrawals/:withdrawal_id
Returns the full withdrawal record. state progresses through
pending_finality → broadcast → finalized — the only path in V0/V0.1, where the
in-process MockChain always succeeds and finalizes instantly. The failed terminal
state is defined but never reached until real Solana custody (V1.7).
Request
Responses
- 200
- 400
- 401
- 404
- 503
Withdrawal record.
Request was malformed or failed validation. The error.code field carries the
machine-readable reason; common values include invalid_request, invalid_json,
invalid_order_id, invalid_instrument_id, invalid_credential_id,
invalid_resolution, and operation-specific codes documented per endpoint.
Missing or invalid Authorization header.
No such withdrawal — or it belongs to another account.
A required downstream (matching engine, ClickHouse, custody, instrument service) is unreachable. The request was not processed; retry with backoff.