> For the complete documentation index, see [llms.txt](https://docs.gage.cash/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gage.cash/earn/outcomes.md).

# Loan outcomes

Repayment brings the fixed cost into the share price over the term; a written-off loan leaves it; recovered collateral belongs in kind to the holders of record, and the strategy's record counts it at

Each loan keeps its own principal, cap and dates. Every share carries the same part of every loan. You may end up holding the collateral instead of USDG.

| State       | What it means for the share price                                                                                                                                                                                                                                                                                                          |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Funding     | The strategy has bought quarters of a listing that has not sold out. The principal is counted at cost; nothing accrues yet. The curator can release the quarters before the loan starts, and a listing that misses its 24-hour funding window is refunded.                                                                                 |
| Active      | All four quarters are sold and the loan runs to the end of its term. The principal is counted at cost plus the return earned so far, spread evenly over the term. The borrower can repay until the term ends and not after.                                                                                                                |
| Repaid      | The borrower reclaimed the collateral before the term ended. At settlement the strategy's quarters of the cap arrive as cash, the fee is taken, and any part of the return not yet accrued is booked at once.                                                                                                                              |
| Written off | The term ended without repayment: the loan defaulted that second. At settlement the default is finalized on the engine, the principal and the return accrued for that loan leave the price, and the holders of record are snapshotted. The collateral is then recovered into side pockets for them in a separate step that can be retried. |
| Refunded    | The loan never started: the curator released the quarters, the borrower cancelled the listing or its funding window closed. The principal returns as cash with no fee and no return.                                                                                                                                                       |

Anyone can call **settle**; the keeper normally does, and nothing moves to the caller. The manage page shows the public **Settle**, **Recover** and **Claim fees** actions. While the earliest open loan sits past the end of its term unsettled, the strategy prices nothing: deposits and withdrawals wait, and the strategy page offers **Book the outcome**. The settlement only records what the engine already decided. A repayment whose cash has not yet reached the strategy, for example while USDG is paused, stays open and is retried by the next settlement.

## Repayment

The repayment lands as strategy cash. It can fund the next listing the limit buy qualifies or return to External lending, and it is part of the free liquidity a withdrawal draws on. There is no queue anywhere: nothing is owed to earlier withdrawal requests, because there are none. [The fee example](https://docs.gage.cash/earn/fees.md) shows the amounts for a loan's term.

## Collateral

Recovered assets are set aside in proportion to the shares held when the loan was written off, and each holder claims their part themselves. An ERC-20 default gives a claim to that token. An LP default removes the position into its two underlying assets, in kind, whatever the pool's price, with a separate pocket for each asset recovered, native ETH included. A side with no recovered amount creates no pocket. Both sides use the same holders and proportions recorded at the write-off.

The right survives a later withdrawal. Earn keeps these claims separate from the share price and never swaps the recovered assets. A collateral outcome pays no fee. Its market value can be lower than the written-off principal, including zero for a meme.

LP pool or position restrictions can delay recovery. A token pause or transfer restriction can delay delivery to your wallet. A recorded entitlement does not remove the issuer's controls. Memes can go to zero. If the borrower walks away, you hold it.

## How the strategy page counts them

The share price alone would read every walk-away as a loss, since the collateral leaves the price for the side pockets. The strategy's record counts both parts:

* **Performance** is what 100 USDG deposited at the start of the period is worth: its shares at the share price plus the collateral those shares received from walked-away loans, each pocket valued in USDG when it was opened, that is when the borrower walked away. History does not move with later prices. A walk-away whose collateral was worth less than the loan still shows as a drop.
* **Loans ended**, on the Earn card and over the strategy's loans, is the result of every loan that has ended: how many, and their return, `(USDG returned by repaid loans + collateral kept from walked-away loans − principal) ÷ principal`, with the repaid and walked-away counts and what the collateral was worth against those loans (for example "collateral worth 1.9× the loans"). A walk-away shows as a gain when its collateral was worth more than the loan, and as a loss when it was worth less.
* **Net earned**, under the deposit card for the whole strategy, and the **earned** figure beside your deposit, are what is held today: the USDG result plus the collateral received, at **today's** price, so they move with the collateral's market after the walk-away.

A pocket no route can price is left out of both figures, and the page says so rather than showing a drop.

## Rewards

sGAGE rewards are accounted for separately. They do not convert a collateral loss into a fixed USDG return. The keeper collects the rewards released for the strategy's loans and spreads each collection over the shares held at that moment. Rewards collected when nobody holds shares are not passed to later depositors. Recorded rewards remain claimable after you withdraw.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.gage.cash/earn/outcomes.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
