Skip to main content

LoanTerm

Per-loan fixed-term detail attached to a Lista DAO broker user position (LendingPosition.term). One per open loan; the flexible/dynamic position uses isDynamic = true and the type(uint128).max loanId sentinel.

loanIdstring

The broker's posId for this loan; pass to /v1/actions/lending/repay?loanId=…. The flexible/dynamic position uses 340282366920938463463374607431768211455 (type(uint128).max).

Example: 450
termIdintegernullable

The rate-card term this loan was opened against (matches a MarketTerm.termId). Omitted for the dynamic/flex position.

Example: 2
isDynamicbooleannullable

True for the flexible/variable position (e.g. a matured fixed loan auto-refinanced into the dynamic position). Omitted/false for fixed-term loans.

Example: false
debtstring

Outstanding debt for this loan in token units (incl. accrued interest).

Example: 14.5003
aprnumbernullable

Fixed APR locked for this loan, in percent. Omitted for the dynamic position (it tracks the variable rate).

Example: 3.85
maturitynumbernullable

Unix timestamp (seconds) when the fixed term ends. After maturity interest is frozen and the loan may be refinanced into the dynamic position. Omitted for the dynamic position.

Example: 1781789025
termDaysnumbernullable

Term length in days.

Example: 7
accruedIntereststringnullable

Interest accrued so far on this loan, in token units.

Example: 0.000358
earlyRepayPenaltystringnullable

Cost (token units) to close this loan before maturity, on top of principal + accrued interest (≈ half the remaining-term interest). 0 once the loan has matured. To fully close fund debt + earlyRepayPenalty; the broker refunds any excess.

Example: 0.001211
isMaturedbooleannullable

True once the fixed term has ended. Interest is frozen; the loan will be auto-converted into the dynamic position by a keeper, so a matured fixed loan may later reappear as the isDynamic row.

Example: false
LoanTerm
{
  "loanId": "450",
  "termId": 2,
  "isDynamic": false,
  "debt": "14.5003",
  "apr": 3.85,
  "maturity": 1781789025,
  "termDays": 7,
  "accruedInterest": "0.000358",
  "earlyRepayPenalty": "0.001211",
  "isMatured": false
}