Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

liquidations

report-partial-sale

{liquidationId}

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "collateralSold": "100",
    "usdcProceeds": "9800.00"
  }'

// Report each tranche as it clears
for (const tranche of tranches) {
  await fetch(
    `https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/${liquidationId}`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'trusset_your_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        collateralSold: tranche.units,
        usdcProceeds: tranche.proceeds
      })
    }
  );
}

// Then close it out, forwarding what the router already holds
await fetch(
  `https://api.trusset.org/lending-external-securities/api/liquidations/settle/${liquidationId}`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ usdcProceeds: "0" })
  }
);

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "collateralSold": "100",
    "usdcProceeds": "9800.00",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ALREADY_SETTLED",
    "message": "Already settled"
  }
}

Records proceeds from a partial sale of seized collateral and transfers them from the registered wallet into the liquidation router. Use it when a position is being sold down in tranches and you want proceeds banked as they arrive, rather than held off-platform until the final settlement. The endpoint is repeatable. Each call increases the router’s proceedsCollected.

The registered wallet must be holding the proceeds. This call pulls the borrow asset from the registered wallet wallet into the router, so fund the registered wallet before calling. An insufficient balance surfaces as PARTIAL_SALE_PREFLIGHT_FAILED.

Path Parameters

string

required

Global router liquidation ID.

Body Parameters

string

required

Collateral disposed of in this tranche, as a decimal string in collateral token units. Must be greater than zero.

string

required

Proceeds realised, as a decimal string in the market’s borrow asset. Must be greater than zero.

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.

The signing wallet must hold OPERATOR_ROLE on the router. If it does not, the calldata is not returned: the response carries ROUTER_OPERATOR_ROLE_MISSING along with the calldata that grants the role.

Response Fields

object

Show child attributes

string

Liquidation ID, echoed back.

string

Collateral reported, echoed back.

string

Proceeds deposited.

string

Transaction hash.

boolean

Nested inside data on the calldata response.

string

SIGN_TRANSACTIONS. Returned when txHash is omitted.

array

Ordered approve on the borrow asset, then reportPartialSale. Returned when txHash is omitted.

string

Address that signed, read from the receipt. Returned when confirming with txHash.

collateralSold is recorded in the on-chain event as an audit trail. It does not reduce collateralRemaining on the router, because the collateral left the router when you called Withdraw Collateral for Sale. Only that endpoint moves the balance.

Proceeds deposited here stay in the router until Settle Liquidation forwards the cumulative total to the market. Reporting partial sales alone never closes a liquidation, and the record stays PENDING.

Settling After Partial Sales

Once every tranche has been reported, call Settle Liquidation with usdcProceeds of "0". Settlement forwards the full proceedsCollected balance already sitting at the router, so a zero final payment is valid and expected in this flow.

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "collateralSold": "100",
    "usdcProceeds": "9800.00"
  }'

// Report each tranche as it clears
for (const tranche of tranches) {
  await fetch(
    `https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/${liquidationId}`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'trusset_your_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        collateralSold: tranche.units,
        usdcProceeds: tranche.proceeds
      })
    }
  );
}

// Then close it out, forwarding what the router already holds
await fetch(
  `https://api.trusset.org/lending-external-securities/api/liquidations/settle/${liquidationId}`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ usdcProceeds: "0" })
  }
);

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "collateralSold": "100",
    "usdcProceeds": "9800.00",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ALREADY_SETTLED",
    "message": "Already settled"
  }
}

Errors

Code	HTTP	Cause
`LIQUIDATION_NOT_FOUND`	`404`	No liquidation with that ID on your instance, and none could be adopted from chain
`ALREADY_SETTLED`	`400`	The liquidation is settled or written off
`ROUTER_OPERATOR_ROLE_MISSING`	`400`	The registered wallet lacks `OPERATOR_ROLE`. The error carries grant `calldata`
`ROUTER_NOT_CONFIGURED`	`400`	No liquidation router resolved for this market
`PARTIAL_SALE_PREFLIGHT_FAILED`	`400`	Simulation reverted, commonly an insufficient balance on the signing wallet
`PARTIAL_SALE_TX_REVERTED`	`400`	The transaction reverted after broadcast

Withdraw Collateral for Sale

Settle Liquidation

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "collateralSold": "100",
    "usdcProceeds": "9800.00"
  }'

// Report each tranche as it clears
for (const tranche of tranches) {
  await fetch(
    `https://api.trusset.org/lending-external-securities/api/liquidations/report-partial-sale/${liquidationId}`,
    {
      method: 'POST',
      headers: {
        'X-API-Key': 'trusset_your_key_here',
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        collateralSold: tranche.units,
        usdcProceeds: tranche.proceeds
      })
    }
  );
}

// Then close it out, forwarding what the router already holds
await fetch(
  `https://api.trusset.org/lending-external-securities/api/liquidations/settle/${liquidationId}`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ usdcProceeds: "0" })
  }
);

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "collateralSold": "100",
    "usdcProceeds": "9800.00",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ALREADY_SETTLED",
    "message": "Already settled"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Report Partial Sale

Path Parameters

Body Parameters

Response Fields

Settling After Partial Sales

Errors

​Path Parameters

​Body Parameters

​Response Fields

​Settling After Partial Sales

​Errors

Path Parameters

Body Parameters

Response Fields

Settling After Partial Sales

Errors