Trusset Protocol - Infrastructure for Asset Tokenization

GET

lending-external-securities

api

positions

{marketId}

positions

{positionId}

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

{
  "success": true,
  "data": {
    "positionId": "secpos_014",
    "onChainLoanId": "5",
    "userAddress": "0xabc...def",
    "borrowedAmount": "50000.000000",
    "collateralAmount": "1000.000000000000000000",
    "accumulatedInterest": "128.750000",
    "healthFactor": "1.842000000000000000",
    "priceAtBorrow": "104.820000",
    "status": "ACTIVE",
    "openedAt": "2025-06-10T08:00:00.000Z",
    "transactions": [
      {
        "id": "sectx_002",
        "marketId": "clx_secmarket_001",
        "positionId": "secpos_014",
        "txType": "BORROW",
        "userAddress": "0xabc...def",
        "amount": "50000",
        "txHash": "0x123...789",
        "timestamp": "2025-06-10T08:00:00.000Z"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "POSITION_NOT_FOUND",
    "message": "Position not found"
  }
}

Returns a single position record merged with live loan data from the market contract, plus every transaction recorded against it. This is the endpoint behind a position detail view. On-chain values take precedence where a linked onChainLoanId exists. Stored values are used as a fallback when the chain read returns nothing.

Path Parameters

string

required

Market ID.

string

required

Position ID.

Response Fields

object

Show child attributes

string

Position record ID.

string

Numeric loan ID on the market contract, or null when the position has no linked chain loan.

string

Borrower address.

string

Outstanding principal in borrow asset units.

string

Collateral pledged, in collateral token units.

string

Interest accrued and unpaid, in borrow asset units.

string

Health factor as a decimal string. Below 1.0 the loan is liquidatable.

string

Collateral price recorded when the loan was opened. Useful for computing price movement since origination.

string

ACTIVE, REPAID, or LIQUIDATED.

string

ISO 8601 timestamp.

array

Every transaction on this position, newest first.

status is read from the stored record and is not re-derived from chain state here. A loan repaid without a confirm call can still read ACTIVE until the next reconciliation pass. For a live view of whether the loan is open, read active from Get Loan, or call List Positions, which reconciles before returning.

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

{
  "success": true,
  "data": {
    "positionId": "secpos_014",
    "onChainLoanId": "5",
    "userAddress": "0xabc...def",
    "borrowedAmount": "50000.000000",
    "collateralAmount": "1000.000000000000000000",
    "accumulatedInterest": "128.750000",
    "healthFactor": "1.842000000000000000",
    "priceAtBorrow": "104.820000",
    "status": "ACTIVE",
    "openedAt": "2025-06-10T08:00:00.000Z",
    "transactions": [
      {
        "id": "sectx_002",
        "marketId": "clx_secmarket_001",
        "positionId": "secpos_014",
        "txType": "BORROW",
        "userAddress": "0xabc...def",
        "amount": "50000",
        "txHash": "0x123...789",
        "timestamp": "2025-06-10T08:00:00.000Z"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "POSITION_NOT_FOUND",
    "message": "Position not found"
  }
}

List Positions

Get Loan

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

{
  "success": true,
  "data": {
    "positionId": "secpos_014",
    "onChainLoanId": "5",
    "userAddress": "0xabc...def",
    "borrowedAmount": "50000.000000",
    "collateralAmount": "1000.000000000000000000",
    "accumulatedInterest": "128.750000",
    "healthFactor": "1.842000000000000000",
    "priceAtBorrow": "104.820000",
    "status": "ACTIVE",
    "openedAt": "2025-06-10T08:00:00.000Z",
    "transactions": [
      {
        "id": "sectx_002",
        "marketId": "clx_secmarket_001",
        "positionId": "secpos_014",
        "txType": "BORROW",
        "userAddress": "0xabc...def",
        "amount": "50000",
        "txHash": "0x123...789",
        "timestamp": "2025-06-10T08:00:00.000Z"
      }
    ]
  }
}

{
  "success": false,
  "error": {
    "code": "POSITION_NOT_FOUND",
    "message": "Position not found"
  }
}

Overview

MiCA Register

Customers

Stock Tokenization

Trading

Stock Lending

External Securities Lending

Get Position

Path Parameters

Response Fields

​Path Parameters

​Response Fields

Path Parameters

Response Fields