logo
User GuideManaging Positions

Managing Positions

Monitoring your fixed-rate loans, maintaining health, and closing positions.

The Dashboard

Once your loan is settled, you can view the active position via the /dashboard or /positions tab in the IRIS Protocol app.

Loan Cards

Each active loan is represented as a "Card" displaying:

  • Principal (Borrow Amount): The fixed amount you borrowed.
  • Collateral: The asset and amount backing your loan in the isolated LoanPod.
  • Fixed Rate (APY): Your locked-in interest rate.
  • Maturity Date: When the loan term expires and repayment is due.
  • Health Factor: The critical metric for avoiding liquidation by the underlying venue.

Understanding Health Factors

While IRIS Protocol guarantees your interest rate, your collateral is still deposited into a strictly-governed, over-collateralized lending venue (like Aave).

Because your collateral value can fluctuate against the value of your debt, you must maintain a safe Health Factor.

Health Factor > 1.0: Your collateral safely covers your borrowing power according to the venue's rules.

Health Factor < 1.0: You are undercollateralized and eligible for liquidation.

The IRIS Protocol app calculates your Health Factor dynamically based on the specific venue where your Solver has actively deployed your loan.

Why is this important?

IRIS Protocol imposes no internal liquidation logic based on collateral ratios. The security of the funds relies entirely on the underlying venue (e.g., Aave, Compound). If the venue liquidates your position due to a drop in collateral value, you only face the standard liquidation mechanics of the venue hosting your collateral.


Adding Margin (Protecting Collateral)

If market volatility causes your collateral's value to drop, your Health Factor will decrease. If it nears 1.0, you risk a standard Venue Liquidation by the underlying variable-rate venue.

Borrowers can use the 'add Margin' feature via the /positions page. This pulls additional collateral from your wallet, deposits it into the venue through your isolated LoanPod, and gives your loan more breathing room against volatility.

You can also withdraw excess margin if your collateral has significantly appreciated, provided the withdrawal doesn't breach the minimum health boundaries.


Early Repayments (Yield-Preserving)

Borrowers are permitted to repay and close their loans early through the 'Repay And Close' flow.

During normal Solver-backed operation, early repayment remains yield-preserving. The protocol preserves the economics of the agreed fixed term while Solver bond protection is still active, so closing early does not erase the fixed-rate amount that was priced into the loan.

Fallback changes that boundary. Once a position has entered fallback, the fixed-rate wrapper is no longer being maintained. From that point onward, coupon preservation stops, and repayment is calculated only through the interval during which fixed protection was actually live.

In practical terms: before fallback, early close preserves the fixed-rate economics; after fallback, it becomes a straightforward closeout of the remaining venue debt.