How It Works
Each clearing system connection (BIC) maintains separate nostro accounts for SCT (SEPA Credit Transfer) and INST (SEPA Instant). The liquidity engine periodically checks these balances against your configured minimums and takes action when needed.Balance Thresholds
You configure four values that control the engine’s behavior:Configuration
Configure liquidity settings through the Dashboard under Settings > Liquidity.Enable Auto-Liquidity
- Navigate to Settings > Liquidity
- Enable Auto-Liquidity
- Set SCT Minimum, INST Minimum, and Transfer Amount
- Optionally set a Warning Balance above the critical minimum
- Save the configuration
What-If Calculator
The settings page includes a what-if calculator. Enter hypothetical SCT and INST balances to see what the engine would do - which alerts fire, whether a transfer is triggered, and in which direction. Use the sliders to explore thresholds.Automatic Transfers
When auto-liquidity is enabled and a scheme balance drops below its minimum, the engine:- Checks if the opposite scheme account has enough surplus (its own minimum + transfer amount)
- If yes, initiates a transfer of the configured amount from the surplus account to the deficit account
- The transfer is sent to the clearing system as a dedicated liquidity transfer instruction, not a regular customer payment - it is recorded as an Adjustment transaction and cannot be cancelled or returned
Notifications
Configure webhook URLs to receive alerts when balance thresholds are breached or when automatic transfers occur.Low Balance Notification
Payload
string
required
Which limit was breached. One of:
RECOMMENDED_TOTAL_MINIMUM_BREACHED, ABSOLUTE_TOTAL_MINIMUM_BREACHED, SCT_MINIMUM_BREACHED_NO_TRANSFER, INST_MINIMUM_BREACHED_NO_TRANSFERarray
required
IBANs of the impacted nostro accounts
number
required
The configured limit that was breached
number
required
The balance at the time of the alert
Liquidity Transfer Notification
Payload
integer
required
Liquidity transfer identifier
string
Identifier of the SEPA message carrying the transfer
string
required
Source nostro account IBAN
string
required
Destination nostro account IBAN
number
required
Transfer amount
string
required
Currency code (ISO 4217)
string
required
Transfer status. One of:
CREATED, SENT_TO_CLEAR, ACCEPTED, REJECTED, COMPLETEDAPI Reference
Get Nostro Balances
View current nostro account balances
Initiate Transfer
Manually transfer funds between nostro accounts
Transfer History
View past liquidity transfers
Account Statements
View nostro account statements