Skip to main content
GET
Get Liquidation Quote
Values the loan’s collateral at today’s sell price, the price it can be sold for, and tells you whether the loan is in breach. A loan can be liquidated when either:
  • it is overdue: past its repayment date plus its grace period, or
  • it is under-collateralised: its collateral is worth less than coverage_threshold (110%) of the amount owed.
The quote also shows how the collateral would be split. You get enough units of each holding to cover what is owed at today’s price, and the borrower gets the rest back. When the collateral is worth less than the debt, you get all of it and the difference is reported as shortfall.
string
required
The id of one of your loans.
number
Amount still owed, in major units (naira).
number
Collateral at today’s sell price.
number
collateral_value / outstanding. 1.05 means the collateral covers 105% of the debt.
boolean
Whether Liquidate Loan would succeed now.
string[]
OVERDUE and/or UNDER_COLLATERALISED.
string
Present only when liquidatable is false. Says why.
object[]
Per holding: quantity, price, value, and the split: to_creditor (units you would receive), to_creditor_value, to_borrower (units returned).
number
The part of the debt the units you receive are worth at today’s price.
number
The part the collateral cannot cover. 0 unless the loan is under water.