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.

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.

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"
          }
        ]
      }
    ]
  }
}

Claim Escrowed Collateral

Get Position

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

Stock Tokenization

Trading

Stock Lending

External Securities Lending

List Positions

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields