Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

hooks

{marketId}

{hookId}

execute

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanData": {"healthFactor": "0.92", "debtValue": "4272.50"}}'

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "fields": [
      { "path": "ageHours", "value": 12, "operator": "<", "threshold": 36, "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": false,
    "checkResults": [
      { "parameter": "healthFactor", "value": "0.92", "operator": "<", "threshold": "0.95", "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "status": 200
  }
}

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

{
  "success": false,
  "error": {
    "code": "MISSING_LOAN_DATA",
    "message": "Loan data required"
  }
}

Triggers one run of a hook and returns the result synchronously. Useful for validating a new hook before enabling it. The run is recorded in the execution log exactly like a scheduled run. What the request body must carry depends on the hook type:

`hookType`	Required body	Behaviour
`monitorRisk`	None	Fetches `riskUri` and evaluates every entry in `riskFields`
`beforeLiquidation`	`loanData`	Evaluates `parameterChecks` against the supplied loan state
`afterLiquidation`	`liquidationData`	Runs the configured `buy` or `inform` action

A hook with actionType set to buy submits a real bid through the registered wallet when the conditions pass. Test with inform first, or set maxBuyPrice to a value the live auction cannot reach.

Path Parameters

string

required

Market ID.

string

required

Hook ID.

Body Parameters

object

Required for beforeLiquidation hooks. Supply the parameters your parameterChecks reference, for example healthFactor, collateralValue, debtValue, collateralRatio, interestAccrued.

object

Required for afterLiquidation hooks.

Show child attributes

string

On-chain loan ID.

string

Auction ID, when the liquidation produced a Dutch auction.

string

Collateral seized.

string

Debt outstanding at liquidation.

string

Borrower address.

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanData": {"healthFactor": "0.92", "debtValue": "4272.50"}}'

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "fields": [
      { "path": "ageHours", "value": 12, "operator": "<", "threshold": 36, "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": false,
    "checkResults": [
      { "parameter": "healthFactor", "value": "0.92", "operator": "<", "threshold": "0.95", "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "status": 200
  }
}

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

{
  "success": false,
  "error": {
    "code": "MISSING_LOAN_DATA",
    "message": "Loan data required"
  }
}

Result Semantics

data.success reports whether the hook ran without error. data.result reports the outcome of the evaluation. A hook that runs cleanly and evaluates to false returns success: true with result: false, which is not an API error. Skipped buy actions return result: false with a reason field, for example Price exceeds max buy price or Auction not active. An insufficient balance on the bidding wallet returns success: false with an error describing the shortfall in the market’s borrow asset.

Toggle Hook

Get Hook Executions

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{}'

curl -X POST "https://api.trusset.org/lending-external-securities/api/hooks/{marketId}/{hookId}/execute" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanData": {"healthFactor": "0.92", "debtValue": "4272.50"}}'

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "fields": [
      { "path": "ageHours", "value": 12, "operator": "<", "threshold": 36, "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": false,
    "checkResults": [
      { "parameter": "healthFactor", "value": "0.92", "operator": "<", "threshold": "0.95", "pass": true }
    ]
  }
}

{
  "success": true,
  "data": {
    "success": true,
    "result": true,
    "status": 200
  }
}

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

{
  "success": false,
  "error": {
    "code": "MISSING_LOAN_DATA",
    "message": "Loan data required"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Execute Hook

Path Parameters

Body Parameters

Result Semantics

​Path Parameters

​Body Parameters

​Result Semantics

Path Parameters

Body Parameters

Result Semantics