Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-stocks

api

liquidations

{marketId}

liquidate

{loanId}

curl -X POST "https://api.trusset.org/lending-stocks/api/liquidations/{marketId}/liquidate/7" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"autoSell": true}'

{
  "success": true,
  "data": {
    "loanId": 7,
    "liquidationId": "4",
    "auctionId": null,
    "txHash": "0xabc...def",
    "collateralSeized": "50.000000000000000000",
    "debtRepaid": "4272.500000",
    "orchestratorResult": {
      "success": true,
      "status": "FULLY_SOLD",
      "tradesExecuted": 2
    },
    "orchestratorError": null
  }
}

{
  "success": false,
  "error": {
    "code": "LIQUIDATION_FAILED",
    "message": "execution reverted: LoanStillHealthy"
  }
}

Triggers liquidation of an unhealthy loan. The oracle is updated automatically if stale. Depending on market configuration, this creates either an instant liquidation (collateral sent to the router) or a Dutch auction. When autoSell is true (default), the orchestrator attempts to sell the seized collateral through the configured order book and settle proceeds back to the lending pool.

This is a write operation. Requires LIQUIDATOR_ROLE granted to the registered wallet on the market contract.

Path Parameters

string

required

Market ID.

integer

required

On-chain loan ID.

Body Parameters

boolean

default:"true"

Whether to automatically route seized collateral through the order book.

string

Hash of the transaction you broadcast for this operation. Send it to confirm the transaction and record the result. Omit it to receive the calldata.

curl -X POST "https://api.trusset.org/lending-stocks/api/liquidations/{marketId}/liquidate/7" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"autoSell": true}'

{
  "success": true,
  "data": {
    "loanId": 7,
    "liquidationId": "4",
    "auctionId": null,
    "txHash": "0xabc...def",
    "collateralSeized": "50.000000000000000000",
    "debtRepaid": "4272.500000",
    "orchestratorResult": {
      "success": true,
      "status": "FULLY_SOLD",
      "tradesExecuted": 2
    },
    "orchestratorError": null
  }
}

{
  "success": false,
  "error": {
    "code": "LIQUIDATION_FAILED",
    "message": "execution reverted: LoanStillHealthy"
  }
}

Get Liquidatable Loans

Settle Liquidation

curl -X POST "https://api.trusset.org/lending-stocks/api/liquidations/{marketId}/liquidate/7" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"autoSell": true}'

{
  "success": true,
  "data": {
    "loanId": 7,
    "liquidationId": "4",
    "auctionId": null,
    "txHash": "0xabc...def",
    "collateralSeized": "50.000000000000000000",
    "debtRepaid": "4272.500000",
    "orchestratorResult": {
      "success": true,
      "status": "FULLY_SOLD",
      "tradesExecuted": 2
    },
    "orchestratorError": null
  }
}

{
  "success": false,
  "error": {
    "code": "LIQUIDATION_FAILED",
    "message": "execution reverted: LoanStillHealthy"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Liquidate Loan

Path Parameters

Body Parameters

​Path Parameters

​Body Parameters

Path Parameters

Body Parameters