Trusset Protocol - Infrastructure for Asset Tokenization

POST

lending-external-securities

api

positions

{marketId}

repay

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/repay" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "amount": "10000"}'

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/loan/5`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data: loan } = await loanRes.json();
const payoff = (Number(loan.principal) + Number(loan.accruedInterest)) * 1.0001;

await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/repay`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ loanId: 5, amount: payoff.toFixed(6) })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x98aD0ca091552e23C564B41C74282e5343D03E8a", "data": "0x..." },
        "functionName": "approve",
        "description": "Approve the market to pull USDC"
      },
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x70A0...", "data": "0x..." },
        "functionName": "repay"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "txHash": "0xabc...def",
    "loanId": 5,
    "repaidAmount": "10000"
  }
}

{
  "success": false,
  "error": {
    "code": "PREFLIGHT_FAILED",
    "message": "execution reverted: LoanNotActive"
  }
}

Repays part or all of a loan’s outstanding debt. Accrued interest is settled before principal. Anyone can repay any loan, so a third party can rescue a position approaching liquidation. Two transactions are required: an approval on the borrow asset, then the repayment. Both come back as ordered steps.

Path Parameters

string

required

Market ID.

Body Parameters

integer

required

On-chain loan ID. Must be a positive integer sent as a JSON number.

string

required

Amount to repay as a decimal string in borrow asset units. The contract caps repayment at the total debt, so overpaying does not transfer more than owed.

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.

Response Fields

object

Show child attributes

string

Transaction hash. Returned when confirming with txHash.

integer

Loan ID, echoed back. Returned when confirming with txHash.

string

Amount submitted, echoed back. Returned when confirming with txHash.

string

SIGN_TRANSACTIONS when txHash is omitted.

array

Ordered approve then repay transactions. Returned when txHash is omitted.

Repaying the full debt does not release collateral on its own. Follow with Close Loan to unlock the pledged tokens and mark the position repaid.

Read principal and accruedInterest from Get Loan immediately before repaying. Interest accrues per block, so a payoff quote computed even a minute earlier will leave dust behind and block the subsequent close.

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/repay" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "amount": "10000"}'

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/loan/5`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data: loan } = await loanRes.json();
const payoff = (Number(loan.principal) + Number(loan.accruedInterest)) * 1.0001;

await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/repay`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ loanId: 5, amount: payoff.toFixed(6) })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x98aD0ca091552e23C564B41C74282e5343D03E8a", "data": "0x..." },
        "functionName": "approve",
        "description": "Approve the market to pull USDC"
      },
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x70A0...", "data": "0x..." },
        "functionName": "repay"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "txHash": "0xabc...def",
    "loanId": 5,
    "repaidAmount": "10000"
  }
}

{
  "success": false,
  "error": {
    "code": "PREFLIGHT_FAILED",
    "message": "execution reverted: LoanNotActive"
  }
}

Errors

Code	HTTP	Cause
`NO_MARKET_ADDRESS`	`400`	The market has no on-chain address recorded
`PREFLIGHT_FAILED`	`400`	The repayment reverted during simulation. `message` carries the reason
`REPAY_FAILED`	`400`	The transaction failed on-chain
`VALIDATION_ERROR`	`400`	`amount` carries more decimal places than the borrow asset supports

Borrow More

Close Loan

curl -X POST "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/repay" \
  -H "X-API-Key: trusset_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"loanId": 5, "amount": "10000"}'

const loanRes = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/loan/5`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data: loan } = await loanRes.json();
const payoff = (Number(loan.principal) + Number(loan.accruedInterest)) * 1.0001;

await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/repay`,
  {
    method: 'POST',
    headers: {
      'X-API-Key': 'trusset_your_key_here',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ loanId: 5, amount: payoff.toFixed(6) })
  }
);

{
  "success": true,
  "data": {
    "action": "SIGN_TRANSACTIONS",
    "steps": [
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x98aD0ca091552e23C564B41C74282e5343D03E8a", "data": "0x..." },
        "functionName": "approve",
        "description": "Approve the market to pull USDC"
      },
      {
        "action": "SIGN_TRANSACTION",
        "transaction": { "to": "0x70A0...", "data": "0x..." },
        "functionName": "repay"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "txHash": "0xabc...def",
    "loanId": 5,
    "repaidAmount": "10000"
  }
}

{
  "success": false,
  "error": {
    "code": "PREFLIGHT_FAILED",
    "message": "execution reverted: LoanNotActive"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Repay Loan

Path Parameters

Body Parameters

Response Fields

Errors

​Path Parameters

​Body Parameters

​Response Fields

​Errors

Path Parameters

Body Parameters

Response Fields

Errors