Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities

api

positions

{marketId}

positions

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

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/positions`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const atRisk = data.positions.filter(p => parseFloat(p.healthFactor) < 1.1);

{
  "success": true,
  "data": {
    "positions": [
      {
        "id": "secpos_014",
        "marketId": "clx_secmarket_001",
        "onChainLoanId": "5",
        "userAddress": "0xabc...def",
        "collateralAmount": "1000.000000000000000000",
        "borrowedAmount": "50000.000000",
        "interestAccrued": "128.750000",
        "healthFactor": "1.842000000000000000",
        "priceAtBorrow": "104.820000",
        "status": "ACTIVE",
        "liquidated": false,
        "liquidatedAt": null,
        "closedAt": null,
        "openedAt": "2025-06-10T08:00:00.000Z",
        "lastUpdated": "2025-06-15T11:58:00.000Z",
        "transactions": [
          {
            "id": "sectx_002",
            "txType": "BORROW",
            "amount": "50000",
            "txHash": "0x123...789",
            "timestamp": "2025-06-10T08:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Returns all positions for a market, newest first, each with its five most recent transactions. The endpoint reconciles against the chain before reading. Loan state is pulled from the market contract and written back to the position records, so healthFactor, collateralAmount, borrowedAmount, and status reflect current chain state rather than the last value the backend happened to write. If the RPC is unavailable the reconciliation is skipped and stored values are returned unchanged. Live state is fetched for the first 50 open positions only. Beyond that the stored values are served, so a market with more than 50 open loans returns a mix. status is never inferred from that read. A terminal label is written only by the confirm calls and the event sweep that can attest to it. A loan the chain reports as closed therefore keeps its recorded status until its evidence arrives.

Path Parameters

string

required

Market ID.

Response Fields

object

Show child attributes

array

Position records ordered by openedAt descending.

Show child attributes

string

Position ID.

string

Market ID.

string

Numeric loan ID on the market contract. Null when the position was recorded without a linked chain loan.

string

Borrower address, lowercased.

string

Collateral posted, in collateral token units.

string

Outstanding principal, in borrow asset units.

string

Interest accrued and unpaid, in borrow asset units.

string

Health factor as a decimal string. At or above 1.0 the loan is healthy. Below 1.0 it is liquidatable.

string

Collateral price recorded when the loan was opened.

string

One of ACTIVE, REPAID, LIQUIDATED.

boolean

Whether the position was liquidated.

string

ISO 8601 timestamp of liquidation, or null.

string

ISO 8601 timestamp of closure, or null.

string

ISO 8601 timestamp the position was recorded.

string

ISO 8601 timestamp of the last write.

array

The five most recent transactions on this position, newest first.

string

Unix seconds this loan falls due. Absent on a market that makes open-ended loans.

integer

The rate stamped onto this loan when it opened, in basis points. Absent when the market’s model stamps nothing. It does not move with the pool’s rate.

object

The loan’s term state, read live from the contract. Absent on a loan with no due date.

Show child attributes

string

Unix seconds the loan falls due.

string

The due date actually applied, which is the earlier of the loan’s own date and any terminal date on the market.

string

Unix seconds the grace period ends. The term penalty applies past it.

boolean

true once the loan can be liquidated on term alone, whatever its health factor. This is the second liquidation trigger and it is not reported by Get Liquidatable Loans.

Positions are recorded when a loan is opened through this API on confirm, and are backfilled from chain events during reconciliation. A loan opened by a wallet signing calldata directly is picked up on the next reconciliation pass rather than at broadcast time.

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

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/positions`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const atRisk = data.positions.filter(p => parseFloat(p.healthFactor) < 1.1);

{
  "success": true,
  "data": {
    "positions": [
      {
        "id": "secpos_014",
        "marketId": "clx_secmarket_001",
        "onChainLoanId": "5",
        "userAddress": "0xabc...def",
        "collateralAmount": "1000.000000000000000000",
        "borrowedAmount": "50000.000000",
        "interestAccrued": "128.750000",
        "healthFactor": "1.842000000000000000",
        "priceAtBorrow": "104.820000",
        "status": "ACTIVE",
        "liquidated": false,
        "liquidatedAt": null,
        "closedAt": null,
        "openedAt": "2025-06-10T08:00:00.000Z",
        "lastUpdated": "2025-06-15T11:58:00.000Z",
        "transactions": [
          {
            "id": "sectx_002",
            "txType": "BORROW",
            "amount": "50000",
            "txHash": "0x123...789",
            "timestamp": "2025-06-10T08:00:00.000Z"
          }
        ]
      }
    ]
  }
}

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

const res = await fetch(
  `https://api.trusset.org/lending-external-securities/api/positions/${marketId}/positions`,
  { headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
const atRisk = data.positions.filter(p => parseFloat(p.healthFactor) < 1.1);

{
  "success": true,
  "data": {
    "positions": [
      {
        "id": "secpos_014",
        "marketId": "clx_secmarket_001",
        "onChainLoanId": "5",
        "userAddress": "0xabc...def",
        "collateralAmount": "1000.000000000000000000",
        "borrowedAmount": "50000.000000",
        "interestAccrued": "128.750000",
        "healthFactor": "1.842000000000000000",
        "priceAtBorrow": "104.820000",
        "status": "ACTIVE",
        "liquidated": false,
        "liquidatedAt": null,
        "closedAt": null,
        "openedAt": "2025-06-10T08:00:00.000Z",
        "lastUpdated": "2025-06-15T11:58:00.000Z",
        "transactions": [
          {
            "id": "sectx_002",
            "txType": "BORROW",
            "amount": "50000",
            "txHash": "0x123...789",
            "timestamp": "2025-06-10T08:00:00.000Z"
          }
        ]
      }
    ]
  }
}

Overview

MiCA Register

Customers

Tokenization

Trading

Lending

Asset Register

Vaults

List Positions

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields