Loan requests¶
A request is the other way to borrow against an NFT: you name the amount, the rate and the term; one lender accepts and sends the money.
After the loan is issued, it is the same loan contract as in a pool: repay, sell the NFT, grace period and liquidation work the same. What differs is how the loan starts — and how you change terms later.
Fair rules still apply
Early repayment — interest only for the days you actually used. Sale or liquidation — any surplus above the settlement returns to you. Summary: Fair rules.
Two models¶
| Pools | Requests | |
|---|---|---|
| Who sets terms | The lender (pool owner) | The borrower |
| Where the money comes from | Shared pool liquidity | One specific lender |
| How much you can ask | Pool cap and % of floor | You name the amount |
| Extend the loan | Prolong / deferral | Publish new terms (refinance) |
| Lender exit | Wait for loans to close, then close the pool | Wait for repay, refinance or liquidation |
The two models do not mix: a pool does not fund a request.
The idea¶
flowchart TB
You[Borrower] -->|1. escrow NFT, publish terms| Req[Request]
Lender[Lender] -->|2. sends the amount| Req
Req -->|3. creates the loan, moves the NFT| Loan[Loan]
Req -->|4. pays the amount| You
You -->|5. repay / new terms / sale| Loan
- Request — your contract: it holds the NFT until a lender appears, shows the offer on the showcase, and later holds prepaid if you publish new terms on a live loan.
- Loan — the same contract as in a pool: collateral, debt, repayment, sale, liquidation.
The request is “a pool for one loan”. The lender can change (refinance); the loan itself does not care who the lender is.
Where in the UI¶
| Tab | URL | Who |
|---|---|---|
| Showcase | /loans/?tab=requests | Open offers: new loans and loans seeking refinance |
| My NFTs | /loans/?tab=requests_my | Create, publish, change terms, cancel, repay |
| I fund | /loans/?tab=requests_funding | Your live positions and refinance |
| My Loans | /loans/?tab=my_loans | Active loans from both models; source is Requests or the pool |
Only collections that allow requests appear in My NFTs. Currency is GRAM or USDT — you pick it when creating the request.
For borrowers¶
Create a request¶
- Open My NFTs.
- Select one or more NFTs and press Create request.
- Set currency, principal, daily rate, term, and how many days to keep on the showcase.
- Confirm in the wallet: the NFT goes into escrow, the offer appears on the showcase.
Until someone funds it, there is no prepaid — no interest has accrued yet.
Typical blockers: the collection does not allow requests; the NFT is already on sale, in a deal, rented, or in another loan; too many NFTs in one wallet transaction.
Terms you set¶
| Field | Meaning |
|---|---|
| Principal | How much you want to receive |
| Interest per day | The daily rate (the UI also shows APR ≈ rate × 365). Range is in the form |
| Term | Loan length in days. Range is in the form |
| Keep on the showcase | How long the offer stays visible (1–14 days). After that it expires and must be published again |
The lender sends exactly these terms. If you change the offer, an old “Issue loan” transaction is rejected — they must confirm the new terms.
Change terms¶
For a request that already has an offer (on the showcase or expired): select the NFT → Change terms. New amount, rate, term and showcase window. The previous offer is replaced.
On a live loan you cannot ask for more than the current principal — the debt never grows. You can keep the same amount or lower it.
Publish a live loan¶
When the loan is already issued and you want a new lender (or the current one) to accept new terms — that is the request equivalent of prolong.
- The loan must be Active, NFT in collateral (if it is listed for sale — cancel the sale first).
- Before the deadline. After it the loan can go to liquidation; publishing will not pull it back.
- In My NFTs press Publish, set the new terms and the showcase window.
- Top up prepaid if the form shows To add.
The loan status does not change. The request just goes back on the showcase as Seeking refinance.
The showcase window cannot run past the loan deadline.
Prepaid¶
Prepaid is your money on the request, used only when you publish terms on a live loan.
It must cover, up to the end of the showcase window:
- Interest already accrued plus interest through the window (days rounded up, same formula as the loan);
- Gap — if the new principal is lower than the current one, the difference.
You cannot increase the loan. Unused prepaid is returned if a lender accepts before the window ends, and also if you cancel, repay or the loan is liquidated.
The form shows Prepaid (already on the contract) and To add.
Cancel¶
| State | What Cancel does |
|---|---|
| No loan yet | Closes the request, NFT returns to you |
| Live loan, offer on the showcase | Takes the offer down, prepaid returns to you. The loan continues |
An expired offer can be taken down the same way. Closing a request that already produced a loan is not a “cancel”: the loan is closed by repayment, sale or liquidation.
After the loan is issued¶
Same path as a pool loan — details in For borrowers:
- Repay from My Loans or My NFTs. Interest for actual days (rounded up, minimum 1 day).
- Sell the NFT from My Loans. Not while the request is on the showcase — cancel the offer first (the UI will not offer Sell until you do).
- No deferral and no pool prolong. To extend — publish new terms.
- Deadline, grace period (~3 days) and liquidation are the same. After the deadline you cannot publish or open a new sale.
Statuses in My NFTs¶
| What you see | Meaning |
|---|---|
| Loan request | NFT is in the request |
| On showcase | Live offer, waiting for a lender |
| Not published | Request exists, no offer |
| Offer expired | Window ended — publish or change terms again |
| Pledged | Loan is live (see My Loans) |
| Current loan | Tooltip with the active loan (principal, debt, rate, term, deadline) |
Typical scenarios¶
Created a request → a lender issued the loan → used the funds → repaid before the deadline → NFT returned. Interest only for actual days.
The offer sat on the showcase. Lowered the amount / raised the rate → Change terms → a lender took the new offer.
Before the deadline: Publish → prepaid covers accrued interest and the new window → current or new lender accepts → loan continues on the new terms, unused prepaid comes back.
Cancelled the showcase offer (prepaid returned) → Sell in My Loans → buyer closes the debt, surplus returns to you.
For lenders¶
You pick a specific request and send the principal. You do not create a pool and you do not share liquidity with other loans.
You cannot exit on your own. You wait for repayment, refinance or liquidation.
Issue a loan¶
- Open the showcase (filter New loans if you want).
- Check the NFT, collection, amount, rate and term.
- Press Issue loan and confirm. You send the principal; the borrower receives it, the NFT moves into the loan.
You cannot fund your own request. If two lenders send at once, the first wins; the second gets the money back (gas is spent).
If the borrower changes terms between your click and the transaction, the contract rejects it — the hashes no longer match.
Refinance¶
A live loan with a new offer is marked Seeking refinance.
| You are | What you send | What you get now | What happens to the loan |
|---|---|---|---|
| New lender | The new principal | You become the lender | Previous lender is paid out of your money; interest and any gap come from the borrower’s prepaid |
| Current lender | Nothing extra | Accrued interest + gap from prepaid | The same loan continues on the new terms |
The borrower cannot raise the principal. If they lower it, the gap is paid from prepaid, not by you.
On I fund select the rows and press Refinance (bulk, not the cart). On the showcase — Refinance on that row. The modal states which of the two cases you are in.
Income¶
Interest is yours when the position closes: the borrower repaid, someone refinanced you out, or the NFT was sold / liquidated.
From interest the protocol takes its share (shown in the UI). The rest is yours.
I fund shows interest already earned across closed positions (including refinance payouts). A live loan is not earned yet.
Risks¶
The main risk is the same as for a pool: the NFT may not cover the debt at liquidation.
- If the borrower repays or another lender buys you out — you get principal and your interest.
- If the loan goes to auction — you get what the split allows: principal first, then interest (minus the protocol share), then a share of the penalty. Shortfall versus issued principal is your loss. Details: For lenders.
You choose the NFT and the terms yourself — that is the difference from a pool, where you only set bounds.
I fund¶
I fund is your current positions: status (Seeking refinance when the borrower published new terms), current vs new principal / rate, earned on closed loans.
There is no “take the NFT” button. Collateral stays in the loan until repay, sale or liquidation.
Typical scenarios¶
Found a request on the showcase → Issue loan → wait. The borrower repaid → principal and interest arrived.
The borrower published new terms. You do not send extra money. You take accrued interest and any principal gap from prepaid; the loan continues at the new rate and term.
You send the new principal. The previous lender is paid from that. Interest and gap — from the borrower’s prepaid. You become the lender under the new terms.
What is the same as a pool loan¶
- Interest by day, rounded up, minimum 1 day.
- Early repayment for actual days.
- Sale of collateral: price must cover debt for the full term plus the marketplace fee; surplus returns to the borrower.
- Grace period after the deadline (~3 days) and liquidation with a penalty; surplus above debt and penalty returns to the borrower.
- Marketplace reminders before / after the deadline if Telegram is linked.
Details: Pools, For borrowers.
What requests do not have¶
- Deferral and pool prolong — their role is Publish / refinance.
- Increasing the loan — the debt never grows.
- A lender-initiated exit.
- Funding a request from a pool.
- A request and a sale of that NFT at the same time.
Borrower checklist¶
- Name terms you can actually service — there is no pool cap to hide behind.
- Decide before the deadline: repay, publish new terms, or sell (after taking the offer down).
- On publish, check To add: that is prepaid, not a larger loan.
- Do not list for sale and keep the request on the showcase at the same time.
Lender checklist¶
- Look at the NFT and the collection, not only the rate.
- On refinance, read the modal: current lender pays nothing extra; a new lender buys out the debt.
- You cannot pull the money back while the loan is live.
- Treat liquidation the same way as in a pool: the NFT can fail to cover the principal.