Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

liquidations

withdraw-collateral

{liquidationId}

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/withdraw-collateral/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientAddress": "0x999...aaa",
    "amount": "100"
  }'

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ROUTER_OPERATOR_ROLE_MISSING",
    "message": "Issuer wallet 0x123...456 does not hold OPERATOR_ROLE on the liquidation router 0x4C1f...8e3b",
    "calldata": {
      "to": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
      "data": "0x...",
      "description": "Grant OPERATOR_ROLE to the issuer wallet on the liquidation router (requires router DEFAULT_ADMIN_ROLE)"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "WITHDRAW_PREFLIGHT_FAILED",
    "message": "Transaction reverted on-chain"
  }
}

Transfers seized collateral from the liquidation router to a recipient you nominate, so it can be sold off-platform. This is step one of the manual settlement workflow. External securities have no on-platform venue, so nothing sells automatically. The operator withdraws the collateral, arranges the sale through their own channel, and reports the proceeds back.

The recipient must satisfy the collateral token’s compliance rules. ERC-3643 transfers to an unverified or non-allowlisted address revert, surfacing as WITHDRAW_PREFLIGHT_FAILED. Verify the recipient on the token’s identity registry before calling.

Path Parameters

string

required

Global router liquidation ID from Get Pending Liquidations or from the Liquidate Loan response.

Body Parameters

string

required

Wallet or custodian address receiving the collateral. Must be a 0x-prefixed 40-character hex address.

string

required

Collateral to withdraw, as a decimal string in collateral token units. Must be greater than zero and no more than collateralRemaining.

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 market’s liquidation 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

Transaction hash.

boolean

Nested inside data on the calldata response.

string

SIGN_TRANSACTION. Returned when txHash is omitted.

object

to (the liquidation router) and data. Returned when txHash is omitted.

string

withdrawCollateralForSale. Returned when txHash is omitted.

string

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

Withdrawal is repeatable. Take the collateral out in tranches as sales are arranged. Each call reduces collateralRemaining on the router. The liquidation’s status stays PENDING throughout, so track progress through collateralRemaining rather than status.

If the liquidation ID exists on-chain but has no Trusset record, the endpoint adopts it automatically by scanning your instance’s routers. Liquidations triggered outside this API are therefore still settleable through it.

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/withdraw-collateral/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientAddress": "0x999...aaa",
    "amount": "100"
  }'

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ROUTER_OPERATOR_ROLE_MISSING",
    "message": "Issuer wallet 0x123...456 does not hold OPERATOR_ROLE on the liquidation router 0x4C1f...8e3b",
    "calldata": {
      "to": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
      "data": "0x...",
      "description": "Grant OPERATOR_ROLE to the issuer wallet on the liquidation router (requires router DEFAULT_ADMIN_ROLE)"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "WITHDRAW_PREFLIGHT_FAILED",
    "message": "Transaction reverted on-chain"
  }
}

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 already settled
`ROUTER_OPERATOR_ROLE_MISSING`	`400`	The registered wallet lacks `OPERATOR_ROLE`. The error carries grant `calldata` for the router admin
`ROUTER_NOT_CONFIGURED`	`400`	No liquidation router resolved for this market
`RELAYER_NOT_CONFIGURED`	`400`	No verified wallet is registered on this instance
`WITHDRAW_PREFLIGHT_FAILED`	`400`	Simulation reverted. Recipient compliance, an amount above `collateralRemaining`, or the router’s per-token rate limit
`WITHDRAW_TX_REVERTED`	`400`	The transaction reverted after broadcast

Get Router Stats

Report Partial Sale

curl -X POST "https://api.trusset.org/lending-external-securities/api/liquidations/withdraw-collateral/14" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientAddress": "0x999...aaa",
    "amount": "100"
  }'

{
  "success": true,
  "data": {
    "liquidationId": "14",
    "txHash": "0xabc...def"
  }
}

{
  "success": false,
  "error": {
    "code": "ROUTER_OPERATOR_ROLE_MISSING",
    "message": "Issuer wallet 0x123...456 does not hold OPERATOR_ROLE on the liquidation router 0x4C1f...8e3b",
    "calldata": {
      "to": "0x067a3feea46649adad8e31c33b3a4d8774b8d8cf",
      "data": "0x...",
      "description": "Grant OPERATOR_ROLE to the issuer wallet on the liquidation router (requires router DEFAULT_ADMIN_ROLE)"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "WITHDRAW_PREFLIGHT_FAILED",
    "message": "Transaction reverted on-chain"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Withdraw Collateral for Sale

Path Parameters

Body Parameters

Response Fields

Errors

​Path Parameters

​Body Parameters

​Response Fields

​Errors

Path Parameters

Body Parameters

Response Fields

Errors