Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities-v2

api

markets

{marketId}

exit-liquidity

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/exit-liquidity" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/exit-liquidity`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.disclosure);

{
  "success": true,
  "data": {
    "reserveRatioBps": 500,
    "borrowableLiquidity": "712500.000000",
    "availableLiquidity": "762500.000000",
    "totalBorrowed": "237500.000000",
    "bookEmpty": false,
    "latestDueAt": "1789516800",
    "exitHorizon": {
      "horizon": "1789776000",
      "bounded": true,
      "applies": true,
      "basis": "OPEN_LOANS"
    },
    "disclosure": "Every open loan carries a term: absent new borrows, the whole book can have turned liquid by 1789776000 (unix seconds). The honest LP-facing words are \"withdrawals may take up to that date\", never \"instant\"."
  }
}

Reads the market’s exit position live from the chain: the reserve held back from borrowing, what a new borrow could draw, and what a withdrawal could reach. It also gives the date by which every open loan is due and past its grace. disclosure puts the answer in one sentence for a liquidity provider. A withdrawal can take liquidity only while it sits unlent in the pool. The reserve ratio earmarks a share of the pool against borrowing, not against withdrawals, so it serves whichever provider exits first and guarantees no one an exit. Where loans without a term are outstanding, no exit date exists at all.

Path Parameters

string

required

Market ID.

Response Fields

object

Show child attributes

integer

Share of total liquidity held back from borrowing, in basis points. Set with Set Reserve Ratio.

string

What a new borrow can draw from the pool now, in borrow asset units: unlent liquidity less the reserve. It does not count what registered vaults could add at borrow time.

string

Unlent liquidity in the pool, in borrow asset units. This is what withdrawals can reach, reserve included. null when it could not be read.

string

Amount lent out, in borrow asset units. null when it could not be read.

boolean

true when nothing is lent out. null when it could not be read.

string

The latest maturity any loan on this market has carried, in unix seconds. It only ever rises. null when no loan has carried one.

object

When the whole book can have turned liquid, absent new borrows.

Show child attributes

string

Unix seconds: the latest maturity plus its grace. null when no loan has carried a term.

boolean

false when a loan without a term is outstanding, so no horizon exists.

boolean

true when a bounded horizon exists and the book is not empty.

string

OPEN_LOANS when taken from the open loans’ own maturities, HIGH_WATER_MARK when it falls back to latestDueAt plus the longest grace. Present only when applies is true.

string

The exit position in one sentence, fit to show a liquidity provider. It never promises an instant exit.

Read the Disclosure

disclosure takes one of three forms, and each carries a different promise.

Situation	What `disclosure` says
A loan without a term is outstanding	No bounded exit horizon exists, and withdrawals depend on borrower repayment
Nothing is lent out	Withdrawals are limited only by liquidity already in the pool
Every open loan carries a term	Absent new borrows, the whole book can have turned liquid by `horizon`, so withdrawals may take up to that date

The horizon holds only absent new borrows. A new loan with a later maturity pushes it out, and a new loan without a term removes it.

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/exit-liquidity" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/exit-liquidity`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.disclosure);

{
  "success": true,
  "data": {
    "reserveRatioBps": 500,
    "borrowableLiquidity": "712500.000000",
    "availableLiquidity": "762500.000000",
    "totalBorrowed": "237500.000000",
    "bookEmpty": false,
    "latestDueAt": "1789516800",
    "exitHorizon": {
      "horizon": "1789776000",
      "bounded": true,
      "applies": true,
      "basis": "OPEN_LOANS"
    },
    "disclosure": "Every open loan carries a term: absent new borrows, the whole book can have turned liquid by 1789776000 (unix seconds). The honest LP-facing words are \"withdrawals may take up to that date\", never \"instant\"."
  }
}

Error Codes

Code	HTTP	Cause
`MISSING_MARKET_ID`	`400`	The `marketId` path segment is longer than 100 characters
`MARKET_NOT_FOUND`	`404`	No market with this ID on your instance
`INTERNAL_ERROR`	`500`	The reserve ratio, the borrowable figure or the exit horizon could not be read. Retry shortly

curl "https://api.trusset.org/lending-external-securities-v2/api/markets/{marketId}/exit-liquidity" \
  -H "X-API-Key: trusset_your_key_here"

const res = await fetch(
  `https://api.trusset.org/lending-external-securities-v2/api/markets/${marketId}/exit-liquidity`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.disclosure);

{
  "success": true,
  "data": {
    "reserveRatioBps": 500,
    "borrowableLiquidity": "712500.000000",
    "availableLiquidity": "762500.000000",
    "totalBorrowed": "237500.000000",
    "bookEmpty": false,
    "latestDueAt": "1789516800",
    "exitHorizon": {
      "horizon": "1789776000",
      "bounded": true,
      "applies": true,
      "basis": "OPEN_LOANS"
    },
    "disclosure": "Every open loan carries a term: absent new borrows, the whole book can have turned liquid by 1789776000 (unix seconds). The honest LP-facing words are \"withdrawals may take up to that date\", never \"instant\"."
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

Get Exit Liquidity

Path Parameters

Response Fields

Read the Disclosure

Error Codes

​Path Parameters

​Response Fields

​Read the Disclosure

​Error Codes

Path Parameters

Response Fields

Read the Disclosure

Error Codes