Skip to main content

Omnibus account

Your omnibus account is the on-chain address Orbitum delivers ORBIS to (and that must hold ORBIS for REDEEM). You register it in the portal; Orbitum backoffice confirms it before it becomes deliverable.

Registration is asynchronous​

stateDiagram-v2
[*] --> PENDING: superadmin registers (portal, step-up)
PENDING --> ACTIVE: backoffice confirms
PENDING --> [*]: superadmin cancels pending
  • A superadmin registers or rotates the address in the portal (requires a 2FA step-up). It lands PENDING.
  • Orbitum backoffice confirms it → ACTIVE. Only an ACTIVE omnibus is delivery-eligible.
  • Learn the outcome by polling GET /api/v1/cex/portal/omnibus (portal). A rotation must target the same chain as the current active omnibus.

While an omnibus is still PENDING, a REDEEM that needs it will fail with CEX_INSUFFICIENT_OMNIBUS (nothing is staked yet to redeem against).

See Onboarding → Register omnibus for the step-by-step.