Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities

api

positions

{marketId}

escrowed-collateral

{holderAddress}

curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/escrowed-collateral/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/escrowed-collateral/${holder}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const claimable = data.escrowedCollateralRaw !== '0';

{
  "success": true,
  "data": {
    "holderAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "adapterAddress": "0x4d2b93f70e18c6a5d34b027fe95c81a6730d77ae",
    "escrowedCollateral": "250.000000000000000000",
    "escrowedCollateralRaw": "250000000000000000000"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_CUSTODY_MODE",
    "message": "Escrow only applies to custody-mode markets"
  }
}

Returns the collateral a custody-mode adapter is holding in escrow for a specific address. Escrow is a fail-safe rather than a failure. When a custody adapter returns collateral and the token’s compliance rules block the transfer, the adapter escrows the balance instead of reverting the whole operation. The holder later reclaims it through Claim Escrowed Collateral. Read this endpoint first, because claiming an empty escrow reverts.

Custody-mode markets only. A FREEZE market never escrows, because collateral never leaves the borrower’s wallet, and the call is refused with NOT_CUSTODY_MODE.

Path Parameters

string

required

Market ID.

string

required

Address to read the escrow for.

Response Fields

object

Show child attributes

string

The address queried, lowercased.

string

Custody adapter holding the escrow.

string

Escrowed amount as a decimal string in the collateral token’s decimals. 0.0 when nothing is held.

string

The same amount in the token’s smallest unit.

curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/escrowed-collateral/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/escrowed-collateral/${holder}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const claimable = data.escrowedCollateralRaw !== '0';

{
  "success": true,
  "data": {
    "holderAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "adapterAddress": "0x4d2b93f70e18c6a5d34b027fe95c81a6730d77ae",
    "escrowedCollateral": "250.000000000000000000",
    "escrowedCollateralRaw": "250000000000000000000"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_CUSTODY_MODE",
    "message": "Escrow only applies to custody-mode markets"
  }
}

Error Codes

Code	HTTP	Cause
`NOT_CUSTODY_MODE`	`400`	The market runs in `FREEZE` mode
`ESCROW_UNREADABLE`	`400`	The custody adapter escrow could not be read from the network right now
`VALIDATION_ERROR`	`400`	`holderAddress` is not a valid address
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance

curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/escrowed-collateral/0xabc7f1093d5e26b804a1c3f78de025916b47c0d3" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/escrowed-collateral/${holder}`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const claimable = data.escrowedCollateralRaw !== '0';

{
  "success": true,
  "data": {
    "holderAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
    "adapterAddress": "0x4d2b93f70e18c6a5d34b027fe95c81a6730d77ae",
    "escrowedCollateral": "250.000000000000000000",
    "escrowedCollateralRaw": "250000000000000000000"
  }
}

{
  "success": false,
  "error": {
    "code": "NOT_CUSTODY_MODE",
    "message": "Escrow only applies to custody-mode markets"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Stock Trading

External Securities Trading

Commodity Trading

Stock Lending

External Securities Lending

Vaults

Get Escrowed Collateral

Path Parameters

Response Fields

Error Codes

​Path Parameters

​Response Fields

​Error Codes

Path Parameters

Response Fields

Error Codes