> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jup.ag/llms.txt
> Use this file to discover all available pages before exploring further.

# FAQ

> Frequently asked questions about Offerbook

Offerbook is a peer-to-peer lending protocol on Solana. Users borrow or lend USDC against onchain collateral (the asset locked by the borrower for the duration of the loan). Loan duration is set by the offer creator (1 to 30 days), with no price-based liquidations and no oracles. This FAQ covers the most common questions.

## Assets

<AccordionGroup>
  <Accordion title="What assets can I use as collateral?">
    Any Solana asset (verified tokens on Jupiter, RWAs such as xStocks, NFTs from whitelisted collections) can be used as collateral. The collateral you choose directly affects how attractive your offer is.
  </Accordion>

  <Accordion title="What asset can I borrow or lend?">
    USDC (a dollar-pegged stablecoin) is the only asset that can be borrowed or lent on Offerbook.
  </Accordion>
</AccordionGroup>

***

## Offers

<AccordionGroup>
  <Accordion title="How do I create an offer?">
    Both borrowers and lenders can create offers through a step-by-step flow: choose a side (borrow or lend), define the collateral asset and amount, USDC amount, LTV (Loan-to-Value, the ratio between borrowed USDC and collateral value), APR (Annual Percentage Rate, for borrowers) or APY (Annual Percentage Yield, for lenders), loan duration, expiration, and partial fill preferences. The offer is then published in the offerbook.

    **Lenders:** Make sure your escrow wallet has sufficient USDC before publishing. Offers without enough balance will not be visible to other users.
  </Accordion>

  <Accordion title="Can I edit an offer after publishing it?">
    No. To change the terms of an offer, you need to remove it and create a new one. However, once an offer expires, you can renew it directly from **Positions > Offers** without recreating it (with the option to adjust the LTV before renewing).
  </Accordion>

  <Accordion title="Can I remove an offer before it expires?">
    Yes. An offer can be removed at any time before it is accepted. No fees are charged.
  </Accordion>

  <Accordion title="How long does an offer stay in the offerbook?">
    Offers expire after 1, 3, or 7 days, set by the offer creator (borrower or lender) at creation.

    This is separate from the loan duration: the loan countdown only starts when an offer is accepted, not when it is published.
  </Accordion>

  <Accordion title="Can I accept an offer partially?">
    It depends on the offer creator's settings. When creating an offer, the creator can enable or disable partial fill, and set a Minimum Fill Amount (in USD). If partial fill is enabled, you can accept any amount equal to or greater than the Minimum Fill Amount. If disabled, the offer can only be filled in full.

    When an offer is partially filled, protocol fees apply to the filled portion only, and the remaining amount stays available to other counterparties until the offer expires.

    Partial fill is not available for offers using NFT collateral.
  </Accordion>

  <Accordion title="Is there a minimum or maximum amount for an offer?">
    There is no fixed minimum or maximum at the protocol level. The Minimum Fill Amount can be set per offer when partial fill is enabled.
  </Accordion>

  <Accordion title="Is there a limit on the number of active offers?">
    No. Users can have multiple offers active at the same time.
  </Accordion>

  <Accordion title="What is a counter offer?">
    A counter offer is a proposal to modify the terms of an existing open offer before accepting it. From the offer, click **Counter** and adjust the LTV, rate (APY), duration, expiration, or partial-fill rule. The original offer creator can then accept your counter (starting the loan at those terms) or ignore it. Counter offers do not lock any funds until accepted. See [Counter Offers](/user-docs/earn/offerbook/counter-offers) for details.
  </Accordion>

  <Accordion title="Can I use an NFT as collateral?">
    Yes. NFTs from whitelisted collections can be used as collateral. Offers using NFT collateral are per-item: each offer targets one specific NFT. The exception is PFP collections with a floor price, where lend offers can be collection offers: any qualifying NFT from the collection can be pledged.

    Partial fill is not available for NFT collateral, since an NFT cannot be partially transferred. For NFT collateral with a known floor price, the LTV slider uses the floor price as the reference collateral value.
  </Accordion>
</AccordionGroup>

***

## Intents

<AccordionGroup>
  <Accordion title="What is an intent?">
    An intent is a free, off-chain advertisement of the lending or borrowing terms you want. It locks no funds and cannot be filled directly. Offerbook matches it against live onchain offers and surfaces the matches in your dashboard. See [Intents](/user-docs/earn/offerbook/intents).
  </Accordion>

  <Accordion title="Does posting an intent lock my funds or cost anything?">
    No. Posting, editing and cancelling an intent only require a wallet signature. There is no transaction, no gas, no account rent and no protocol fee, and your funds stay in your wallet. For large intents, around \$100,000 in value or more, Offerbook checks that your wallet and escrow balances hold the relevant asset before accepting the intent.
  </Accordion>

  <Accordion title="How do I act on someone else's intent?">
    Create a regular onchain offer with the same token pair and terms close to the advertised ones: APY and LTV (Loan-to-Value) within 10%, duration within one day. Your offer then surfaces automatically in the intent creator's dashboard, and they can fill it through the standard flow.
  </Accordion>

  <Accordion title="How long does an intent last?">
    The loan terms you advertise can run from 1 to 90 days. The intent itself stays active until you cancel it or it expires automatically.
  </Accordion>
</AccordionGroup>

***

## Loans

<AccordionGroup>
  <Accordion title="How does a loan start?">
    A loan starts when an offer is accepted. Once matched, the collateral is locked onchain via a smart contract (a PDA, or Program Derived Address, which is a program-owned account on Solana with no private key) and the USDC is transferred. All loan terms are fixed and immutable from that point. The loan duration begins at this moment.
  </Accordion>

  <Accordion title="How long does a loan last?">
    Loan duration is set by the offer creator (borrower or lender) and can range from 1 to 30 days. The interface offers presets depending on the flow (such as 3D, 7D, 30D or 7d, 14d, 30d). The countdown starts when the offer is accepted, not when it is published. Once the loan starts, the duration cannot be changed.
  </Accordion>

  <Accordion title="What is the difference between offer expiration and loan duration?">
    Offer expiration is how long the offer stays visible in the offerbook (1, 3, or 7 days, set at creation). Loan duration is how long the loan lasts once the offer is accepted (1 to 30 days). These are two separate timers.
  </Accordion>

  <Accordion title="Can a borrower repay the loan early?">
    Yes. Borrowers can repay the loan at any time before maturity. The **full interest** for the agreed loan duration is owed regardless of when the repayment occurs. There is no partial interest or fee reduction for early repayment.
  </Accordion>

  <Accordion title="What happens at maturity if the loan is not repaid?">
    After the loan duration ends, the lender can claim the collateral by signing a transaction. This action triggers the collateral transfer: the collateral is sent directly to the lender (not sold on the market). A 0.1% fee is deducted from the collateral at transfer (no fee on NFT/RWA).

    **The collateral transfer is not automatic.** It only happens when the lender claims. The borrower can still repay and recover the collateral at any time, as long as the lender has not claimed it.

    <Warning>
      Do not rely on this window. The lender can claim at any moment after maturity. Always plan to repay before the loan expires.
    </Warning>
  </Accordion>

  <Accordion title="Can a loan be affected by market movements during its duration?">
    No price-based liquidation, margin call, or forced closure can occur during the loan. However, the collateral is still exposed to price fluctuations. If its value changes significantly, this affects the outcome at maturity for both sides.
  </Accordion>

  <Accordion title="What are the loan statuses?">
    A loan can have one of four statuses:

    * **Active:** the loan is running, between offer acceptance and maturity.
    * **Repaid:** the borrower has repaid the loan, the collateral has been returned to their wallet.
    * **Expired:** the loan has passed maturity without being repaid. The lender can claim the collateral, and the borrower can still repay until they do.
    * **Defaulted:** the lender has claimed the collateral after maturity. The loan is closed.
  </Accordion>

  <Accordion title="Where is the collateral stored during the loan?">
    The collateral is locked onchain via a smart contract (a PDA, or Program Derived Address, which is a program-owned account on Solana with no private key) for the full duration of the loan. Neither the borrower nor the lender can access it during this period.
  </Accordion>

  <Accordion title="What happens when a borrower repays?">
    The borrower pays the principal plus the full interest for the loan duration. The collateral is returned directly to the borrower's wallet. The lender receives the USDC (principal + interest, minus the 10% repayment fee) in their escrow wallet.
  </Accordion>

  <Accordion title="What happens if my collateral is a yield-bearing token (e.g., an LST)?">
    For tokens where yield accrues in the token value itself (such as liquid staking tokens), the collateral value will grow during the loan. For tokens where yield must be actively claimed, the yield may not be accessible while the collateral is locked.
  </Accordion>
</AccordionGroup>

***

## Fees

<AccordionGroup>
  <Accordion title="What fees does Offerbook charge?">
    Offerbook applies fees at three stages:

    1. **At loan start:** 25% of the estimated total interest is taken immediately (USDC), paid by the borrower.
    2. **At repayment:** 10% of the interest is deducted from the lender's return.
    3. **At collateral transfer:** If the borrower does not repay and the lender claims the collateral, 0.1% is deducted from the collateral (no fee on NFT/RWA).
  </Accordion>

  <Accordion title="Who pays the fees?">
    The borrower pays the fee at loan start (25% of estimated interest). The lender pays the fee at repayment (10% deducted from interest received) and at collateral transfer (0.1% deducted from collateral received).
  </Accordion>

  <Accordion title="What is Effective APR / APY?">
    The Effective APR (borrower) and Effective APY (lender) account for platform fees and are displayed in the offer summary.

    * **Effective APR** is higher than the offer APR because the 25% upfront fee is added on top of the interest. *Example:* an offer at 30% APR becomes 37.5% Effective APR (30% × 1.25).
    * **Effective APY** is lower than the offer APY because the 10% fee is deducted from the interest received. *Example:* an offer at 5% APY becomes 4.5% Effective APY (5% × 0.9).
  </Accordion>

  <Accordion title="How does the fee at loan start work in practice?">
    If a lender fills a borrow offer, the borrower receives the USDC amount minus the fee. If a borrower fills a lend offer, the borrower pays the fee right after receiving the USDC.
  </Accordion>

  <Accordion title="Is interest reduced if I repay early?">
    No. The full interest for the agreed loan duration is always owed, regardless of when the repayment occurs.
  </Accordion>

  <Accordion title="Are there other costs apart from protocol fees?">
    Yes, two other types. Offerbook has three cost types in total:

    1. **Network fees** — Solana gas, around 0.000005 SOL per signature. Never refunded.
    2. **Account rent** — a refundable deposit Solana requires for each new account. Most of it comes back when the account is closed.
    3. **Protocol fees** — Offerbook's cut in USDC (see [Fees & Costs](/user-docs/earn/offerbook/fees-and-costs#protocol-fees)). Never refunded.

    Rule of thumb: fees are gone, rent is a deposit (most of it is returned when the account is closed). The full rent table by account type is in [Fees & Costs → Account Rent](/user-docs/earn/offerbook/fees-and-costs#account-rent).
  </Accordion>

  <Accordion title="What is the referral program?">
    Offerbook offers a referral system that applies at every stage where a fee is charged. By default, each fee is split:

    * **Referred user:** 20% of the fee
    * **Referrer:** 30% of the fee
    * **Protocol:** 50% of the fee

    The referred-user share is always credited to whoever is paying the fee at that stage, and the 30% share goes to that user's referrer: the borrower at loan start, the lender at repayment and collateral transfer. See [Affiliate & Referrals](/user-docs/earn/offerbook/affiliate-and-referrals) for the full program.
  </Accordion>

  <Accordion title="Can fees change?">
    Yes. Fees are set in the onchain configuration and can be updated by protocol admins. The rates described in [Fees & Costs](/user-docs/earn/offerbook/fees-and-costs) are the current defaults.
  </Accordion>
</AccordionGroup>

***

## Risks

<AccordionGroup>
  <Accordion title="What are the main risks for borrowers?">
    If you do not repay before the end of the loan duration, the lender can claim your entire collateral at any moment. While you can technically still repay until the lender claims, do not rely on this window. Repayment timing is your responsibility. The full interest is always owed, even if you repay early.
  </Accordion>

  <Accordion title="What are the main risks for lenders?">
    Collateral value is not monitored during the loan. If the collateral loses significant value before maturity and the borrower does not repay, you receive the collateral token directly (not USDC), and may need to sell it at a loss. The higher the LTV (Loan-to-Value, the ratio between borrowed USDC and collateral value), the higher this risk. You must also manually claim the collateral after maturity.
  </Accordion>

  <Accordion title="Are there price-based liquidations?">
    No. Offerbook loans are time-based. Market price movements during the loan do not trigger any liquidation or margin call. After maturity, if the borrower has not repaid, the lender can claim the collateral by signing a transaction. This is a direct transfer, not a sale on the market.
  </Accordion>

  <Accordion title="Has Offerbook been audited?">
    Yes. Offerbook has been audited by Cantina. The full report is available here: [Cantina Audit (May 21, 2026)](https://github.com/jup-ag/docs/blob/main/static/files/audits/offerbook-cantina-may-2026.pdf).
  </Accordion>
</AccordionGroup>

***

## Escrow Wallet

<AccordionGroup>
  <Accordion title="What is the escrow wallet?">
    A dedicated wallet, separate from your main Solana wallet, used to hold funds while interacting with Offerbook. Each user has one escrow wallet. All funds transit through the escrow when creating or accepting offers.

    For lenders, the escrow is visible in the interface. For borrowers, it is used in the background and is not visible.
  </Accordion>

  <Accordion title="Do lenders need to deposit USDC into the escrow before creating an offer?">
    An offer cannot be created without the USDC backing it, but you do not need to deposit beforehand: the required USDC is deposited from your wallet into the escrow as part of offer creation.
  </Accordion>

  <Accordion title="Can my escrow balance support multiple offers?">
    Yes. Lenders can create multiple lend offers from the same USDC balance, and all of them are visible at the same time. When one offer is accepted and the USDC leaves the escrow, any remaining offers that are no longer covered by the balance are hidden automatically.
  </Accordion>

  <Accordion title="Can I withdraw from my escrow at any time?">
    Yes. You can withdraw USDC at any time. If withdrawing makes your balance insufficient to cover active offers, those offers are automatically hidden.
  </Accordion>

  <Accordion title="What happens to repaid funds?">
    When a borrower repays a loan, the USDC (principal + interest, minus the 10% fee) returns to the lender's escrow. It can be reused for new offers without withdrawing to your wallet first.
  </Accordion>

  <Accordion title="How does the escrow work for borrowers?">
    For borrowers, the escrow is invisible. Collateral transits through the escrow automatically in a single transaction when creating or accepting an offer. When the borrower repays, collateral is returned directly to their wallet.
  </Accordion>

  <Accordion title="What are the costs to use the escrow wallet?">
    Depositing an asset into your escrow requires funding a Solana account: 0.00203928 SOL the first time you deposit a given asset. This rent is a deposit rather than a fee: it is refunded when you withdraw the asset.

    A separate escrow account is required for each distinct asset, so borrowers typically open more of them over time than lenders, who generally only need a USDC account.

    See [Fees & Costs → Account Rent](/user-docs/earn/offerbook/fees-and-costs#account-rent) for the other account types.
  </Accordion>
</AccordionGroup>

***

## Notifications & Settings

<AccordionGroup>
  <Accordion title="How do I enable notifications?">
    Open the **Settings** page (gear icon in the navigation header), then go to the **General** tab and connect a notification channel: Telegram or Email. Connecting a channel requires signing a message to prove you own the wallet.

    Once at least one channel is connected, the **Notifications** tab becomes active. You can then toggle individual notification types on or off (Offer accepted, Counter offer received, Loan due soon, etc.). See [Settings & Notifications](/user-docs/earn/offerbook/settings-and-notifications) for the full list.
  </Accordion>

  <Accordion title="What if I'm using a hardware wallet?">
    Hardware wallets (Ledger and others) cannot sign arbitrary messages. To connect a notification channel with a hardware wallet, enable **I'm using a hardware wallet** in the General settings. Authentication then uses a signed transaction instead of a signed message.
  </Accordion>

  <Accordion title="What is auto top-up?">
    Auto top-up is the mechanism that automatically deposits the required funds from your main wallet into your escrow when you create an offer: collateral for a borrow offer, USDC for a lend offer.

    Two toggles for it are visible in the Escrow Settings but are not yet active (greyed out); for now, the deposit always happens automatically as part of offer creation.
  </Accordion>

  <Accordion title="What is Pro Mode?">
    Pro Mode is a planned toggle to unlock advanced options and controls across the interface. It is not currently available.
  </Accordion>
</AccordionGroup>

***

## Chat

<AccordionGroup>
  <Accordion title="How do I start a chat?">
    Click the floating green button in the bottom-right corner of the interface and choose **Messages**. The first time you open Chat, approve the wallet signature to authenticate. You can then join public Channels (currently just General) or send a Direct message to another user by username or wallet address. See [Chat](/user-docs/earn/offerbook/chat) for the full overview.
  </Accordion>

  <Accordion title="How do I sign in to Chat with a Ledger?">
    Hardware wallets cannot sign arbitrary messages. When you click **Connect to chat** with a Ledger, the app detects the failure and offers to switch to a memo transaction signature instead. Approve the empty memo transaction in your wallet to complete sign-in. Your wallet needs a small SOL balance to pay the network fee.
  </Accordion>

  <Accordion title="How do I share an offer in chat?">
    From any conversation (channel or DM), click the **+** button on the left of the message input and choose **Send an offer**. A list of your open offers appears; select the one you want to share. The recipient sees a preview card with the offer terms (principal, collateral, APY, duration, LTV) and can open the full offer with one click.
  </Accordion>
</AccordionGroup>