> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# List Positions
> List every borrowing position recorded for a market
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
Market ID.
## Response Fields
Position records ordered by `openedAt` descending.
Position ID.
Market ID.
Numeric loan ID on the market contract. Null when the position was recorded without a linked chain loan.
Borrower address, lowercased.
Collateral posted, in collateral token units.
Outstanding principal, in borrow asset units.
Interest accrued and unpaid, in borrow asset units.
Health factor as a decimal string. At or above `1.0` the loan is healthy. Below `1.0` it is liquidatable.
Collateral price recorded when the loan was opened.
One of `ACTIVE`, `REPAID`, `LIQUIDATED`.
Whether the position was liquidated.
ISO 8601 timestamp of liquidation, or null.
ISO 8601 timestamp of closure, or null.
ISO 8601 timestamp the position was recorded.
ISO 8601 timestamp of the last write.
The five most recent transactions on this position, newest first.
Unix seconds this loan falls due. Absent on a market that makes open-ended loans.
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.
The loan's term state, read live from the contract. Absent on a loan with no due date.
Unix seconds the loan falls due.
The due date actually applied, which is the earlier of the loan's own date and any terminal date on the market.
Unix seconds the grace period ends. The term penalty applies past it.
`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](/endpoints/lending/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.
```bash cURL theme={null}
curl "https://api.trusset.org/lending-external-securities/api/positions/{marketId}/positions" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
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);
```
```json Response theme={null}
{
"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"
}
]
}
]
}
}
```