Skip to main content
POST
Use it when a loan’s collateral no longer covers it, for example after a fall in a stock or commodity price, or when a loan is overdue. Call Get Liquidation Quote first to see what will happen. Price alerts can tell you when to look. What happens, in one transaction:
  1. Units covering what is owed, at today’s sell price, move from the borrower’s pledged collateral to your organisation’s wallet. When the collateral is worth less than the debt, all of it moves.
  2. The rest of the collateral is released back to the borrower.
  3. The loan closes with status LIQUIDATED.
Then the units you received are listed for sale from your wallet, one sell order per token, unless you set list_for_sale to false. The sale proceeds are yours. GetEquity does not pay out the loan in cash on this path, so the price you sell at, and any shortfall, are yours to manage. You can manage the orders like any others: Get Sell Orders, Cancel Order. The borrower is told by email, push and in-app notification. You receive a loan.liquidated webhook.
A loan that is not in breach is refused with 409 and a message giving its current cover. A loan is in breach when it is past its repayment date plus grace, or its collateral is worth less than 110% of what is owed.
string
required
The id of one of your loans.
string
Your reason, kept on the liquidation record (500 characters max).
boolean
default:"true"
Put the units you receive up for sale straight away. With false they stay in your wallet, and you can sell them later with Sell Token.
object[]
Your own limit price per token, as [{ "token_id": "...", "price": 98.5 }]. A token you leave out is listed at its current sell price.
object[]
One entry per token received. status is LISTED, with the order’s reference, or NOT_LISTED, with an error (for example, trading in that token is halted, or the amount is below its minimum sale). Units that were not listed stay in your wallet.