Using Pluribus
Pluribus lends USDC against one account that can hold SOL, staked SOL, tokenized stocks, a memecoin and concentrated-liquidity positions together. Lenders supply the USDC through a senior or a junior tranche.
Every figure the rules below depend on is a setting. The values in force are in Numbers on devnet.
Status
- The only deployment is on Solana devnet. Its tokens are mocks with no value.
- Devnet prices for SOL, NVDAx, AAPLx and BONK are written by the admin key, not read from a market. Only JitoSOL and JupSOL read live Pyth feeds.
- The program has not been audited.
- One key is both the admin and the program's upgrade authority.
- There is no hosted app. You run the web app yourself, see Try it.
Borrowing
Collateral
A credit account holds up to 5 positions. You borrow USDC against all of them together.
| Collateral | In the web app |
|---|---|
| SOL | yes |
| NVDAx, a mock tokenized stock | yes |
| Orca SOL/USDC liquidity position | yes |
| USDC | yes |
| JitoSOL and JupSOL, mock staked SOL | yes |
| AAPLx, a mock Token-2022 stock | yes |
| BONK, a mock memecoin | yes |
| Raydium SOL/USDC liquidity position | SDK only |
| Meteora DLMM SOL/USDC liquidity position | yes, opened through the app |
JitoSOL and JupSOL are priced from their live Pyth feeds. SOL, NVDAx, AAPLx and BONK use demo prices the admin sets, so the demo can crash them on purpose. BONK is priced per million tokens, since a single token is worth a tiny fraction of a cent.
Meteora DLMM
A Meteora position can never change owner, so one your wallet already holds cannot be deposited. The pool has to own it from the start, so you open a new position through Pluribus and put liquidity into it.
- Opening: on the Borrow page press Deposit, pick Meteora DLMM, enter SOL and USDC, and choose a width of 1 to 70 bins. The range is centred on the pair's active bin and the form shows its price range. The app opens the position and adds the tokens in one transaction, so your wallet asks once. If it fails nothing is opened. Opening costs about 0.06 SOL of rent, returned when you close the position, plus about 0.07 SOL for each bin array nobody has created yet.
- Adding: Add on the position's row puts more SOL and USDC into the same range. A range entirely above or below the active price takes only one of the two.
- Withdrawing: Withdraw takes back any share of the liquidity, to your wallet, as long as the debt stays within the credit limit. A withdrawal does not need the market to be live.
- Closing: once a position is empty, Close pays out its unclaimed fees and its rent and frees the slot.
- Value: counted from the position's own liquidity and the oracle price, never the pair's price, so trades in the pair cannot move it. Each bin counts as whichever of its two tokens is worth less at the price being tested.
- Liquidation: unlike an NFT position, a Meteora position is sold in part. The liquidator repays part of the debt and the pool pays out that share of every bin, plus the bonus, straight to the liquidator. A position taken whole is closed and its rent returns to you.
- Paused or not yet active: a paused market, a pair Meteora has disabled or a listing inside its activation delay takes no new positions and no added liquidity. The Deposit list shows it greyed out.
Credit limit
The program values the whole account under each crash scenario and takes the worst result:
- Each position is priced at the low end of the oracle's confidence band.
- The price is cut by the scenario's shock for that asset's group.
- The value is cut again by the asset's liquidation cost.
- The positions are added up. The lowest total across the scenarios is the credit limit.
The totals are added before the worst one is picked, so a mixed account borrows more than the same assets held in separate accounts.
A liquidity position is revalued at each crash price from its range and liquidity, and its USDC side takes the USDC shock. Only the oracle price is used, never the pool's own price.
Each asset's shock is the larger of the table value and a value from its recent volatility, z × σ × √T. In a volatile market the limit falls below the table figures.
Some collateral backs no new debt while still protecting debt already drawn:
- an asset paused by the admin or the guardian
- a listing still inside the activation delay
- a price older than
max_price_age_secs - a Token-2022 token that its issuer has paused, whose vault is frozen or short of tokens, or whose price is unclear around a split
Interest
- The rate follows pool utilization: it rises gently up to the kink and steeply above it.
- It is variable and accrues every second. There is no maturity and no repayment schedule.
- An account with debt that stays above the warning health long enough moves to a cheaper tier. Health is the liquidation limit divided by the debt.
- Falling under the warning health, or being liquidated, returns the account to the base tier.
- A tier changes only when someone sends
refresh_tier. The keeper does this.
Risk premium
- Risky collateral adds a premium to your rate: 15% a year for BONK and 3% for NVDAx and AAPLx on devnet. SOL, staked SOL, USDC and their liquidity positions add none.
- Your premium is each position's premium weighted by how much it adds to your credit limit in a crash. BONK that makes up a quarter of your borrowing power adds a quarter of its premium.
- It fades with your tier: you pay the full premium at the base tier, 60% after 7 healthy days and 30% after 30.
- It is charged as debt and paid to junior lenders, who take the first loss if risky collateral fails.
- It is recalculated when you draw or withdraw, and by the keeper about every 10 minutes. The Borrow page lists it in the rate breakdown.
Autopay
Anyone can collect the trading fees of a deposited liquidity position: an Orca position in the main SOL/USDC pool, a Raydium position or a Meteora position. Whoever collects them is paid the pool's bounty, 2% of each token, the same share a compound pays. Of the rest, the USDC repays your debt, and the SOL and any USDC beyond the debt stay in the account as collateral. The keeper does not collect fees: bounty callers do, through the SDK or the Collect fees button on the Overview page, and you can collect your own and take the bounty yourself. It cannot be switched off, but a position can compound its fees instead (see below). Any pool rewards Raydium pays out at the same time go to your own wallet.
Compounding
Instead of repaying debt, a position's fees can go back into the position. You choose per position, on the Borrow page, by the Fees button on its collateral row: repay debt (autopay, the default) or compound within a tolerance.
- What happens. Anyone can compound the position: the fees are collected, a share of them is paid to whoever compounds, the rest is added back to the position, and anything the position's range cannot take stays in your account as collateral. Compounding can only raise your health. While it is on, autopay leaves the position alone, so its fees no longer repay debt.
- Tolerance. Compounding only runs while the pool's price is within your tolerance of the oracle's price, which stops someone moving the pool price to compound at your cost. The Borrow page offers 0.5%, 1% and 2%, or a custom value up to 10%. A looser tolerance lets compounding run more often, but exposes more of the fees to price manipulation.
- Bounty. Whoever compounds is paid the same share autopay pays, set by the pool's admin, 5% at most. It is shown next to the setting.
- Every dex. Orca positions in the main pool, Raydium positions and Meteora positions all compound. A Meteora position compounds against its pair's active bin, whose price moves in bin-step steps, so a tolerance tighter than the bin step can leave it waiting even when the pair sits at the market.
Collecting for everyone. The Collect fees button on the Overview page collects every position whose fees are worth the bounty, compounding those set to compound and autopaying the rest, and the bounty goes to your wallet. You do not need a position of your own, only a wallet. The first press also makes the token accounts the bounty is paid into, which takes one extra wallet prompt. Every batch is then signed in one wallet prompt, and a batch that fails does not stop the others. When nothing is ready, it says so and sends nothing.
Repaying and withdrawing
- You can repay any amount at any time. Anyone can repay any account.
repay_from_collateralpays debt with USDC already in the account.- A withdrawal goes through when the debt is still within the credit limit afterwards.
close_accountcloses an account with no debt and no positions and returns its rent. The Borrow page offers Close account once the account is empty. A new deposit opens a fresh one.
Statements
The Statements page lists each month's draws, repayments, autopay, interest and risk premium, with the opening and closing debt. The Interest filter shows interest and risk premium together, and the month's interest total counts both.
Liquidation
An account can be liquidated when its debt is above its liquidation limit. That limit is worked out like the credit limit, with smaller shocks.
- A liquidator repays part of your debt, up to the close factor per transaction, and takes collateral worth that amount plus the bonus. Each asset can have its own bonus, never above the pool's.
- The program picks which position is taken first, not the liquidator. It is the position whose sale closes the most of the shortfall per dollar of debt repaid: the one worth least, per dollar of market value, in the crash scenario that sets your liquidation limit, with its bonus counted in. The collateral that holds up best in that scenario is taken last. Once the debt is more than 10% above the limit, any position can be taken.
- An Orca or Raydium liquidity position is sold whole. The liquidator pays its value less the bonus, and what the close factor does not let through to your debt stays in your account as USDC. A Meteora position is sold in part, see Meteora DLMM.
- Anyone can pay your debt down with USDC that is in your account. No bonus is charged for that.
- The account returns to the base rate tier.
- Liquidations repeat while the debt is above the limit.
- A stock whose price is unclear around a split cannot be taken until it is clear. Your other collateral can.
- If the collateral runs out with debt left, the rest is written off as a loss to lenders.
Lending
Tranches
| Senior | Junior | |
|---|---|---|
| Takes losses | last | first |
| Rate | the senior rate | senior rate × (1 + premium × senior ÷ junior) |
| Exit | at once from idle USDC, otherwise the withdrawal queue | through the exit queue |
Lenders receive the borrower interest left after the reserve factor and the protocol fee. Juniors earn the premium on every senior dollar they cover, so the fewer juniors there are, the more each junior dollar earns. The multiple stops rising once juniors hold under a tenth of the target share.
Interest is not paid as it arrives. It collects in a buffer, and each epoch pays out the buffer it opened with, less a margin, evenly over its length. The yield you see this week comes from last week's interest.
The Earn page also lists your own deposits, conversions, withdrawals and exit queue moves, when an indexer is connected.
Loss order
A loss is booked when a borrower's account has debt and no collateral left. It is taken from, in order:
- interest in the buffer that has not been paid out
- the insurance reserve
- protocol fees not yet collected
- junior lenders
- senior lenders
Leaving
Senior. lend_withdraw pays at once from idle USDC. When the pool is lent out it fails with InsufficientLiquidity, and the withdrawal queue takes over:
request_senior_exitmoves your shares into escrow, fixes their value and gives the exit the next ticket.- Idle USDC up to what every queued exit is owed is held back. Draws, instant senior withdrawals, junior claims in USDC and fee collection can only use cash above it.
settle_senior_exitpays the ticket at the head of the queue in full once the pool's cash covers it, into your USDC account. Anyone can send it, and the keeper does on every pass. Tickets are paid strictly in order.cancel_senior_exithands back shares worth what you queued and frees the held cash. The empty ticket is skipped when the queue reaches it.
- Queued shares earn nothing and still take losses, so an exit pays the lower of its queued value and what the shares are worth when settled.
- The steep rate above the kink is what brings repayments in to fill the queue.
Junior.
request_junior_exitmoves your shares into escrow and fixes their value. One exit per wallet at a time.- You wait out the exit delay.
- You claim inside the claim window, in USDC if the pool has it idle, or in senior shares.
- The exit fee stays with the juniors who remain.
- Queued shares earn nothing and still take losses.
- You can cancel at any time and get back shares worth what you queued.
- An exit not claimed in its window lapses. Anyone can then cancel it, which returns the shares to you.
- The admin can pause junior exits. During a pause nobody can queue or claim. Cancelling still works.
convert_to_junior turns senior shares into junior shares with no USDC moving.
Rule changes
- Tightening applies at once: raising a shock or a liquidation cost, lowering a deposit cap, pausing.
- Everything else, including a new collateral listing, waits out the activation delay. That delay is at least the junior exit delay plus the claim window, so juniors can leave before new risk arrives.
- The guardian can cancel a waiting change or pause an asset. It cannot loosen anything or pause exits.
- On devnet the admin sets prices directly, which gets around every delay.
Numbers on devnet
As read from devnet on 20 Nov 2026. doc_and_refs/TUNES.md lists every setting with its allowed range. If this page and that file disagree, the file is right.
Shocks
Draw shock, then liquidation shock, per scenario.
| Scenario | SOL | Stocks | USDC | Staked SOL | Memecoins |
|---|---|---|---|---|---|
| Crypto crash | 30% / 20% | 15% / 10% | 3% / 1% | 35% / 23% | 60% / 45% |
| Equity crash | 15% / 10% | 35% / 25% | 3% / 1% | 20% / 13% | 30% / 20% |
| Broad selloff | 25% / 17% | 25% / 17% | 3% / 1% | 30% / 20% | 50% / 38% |
What $10,000 of collateral supports
| Collateral | Liquidation cost | Credit limit | Liquidation limit |
|---|---|---|---|
| SOL | 5% | $6,650 | $7,600 |
| JitoSOL or JupSOL | 6% | $6,110 | $7,238 |
| NVDAx or AAPLx | 10% | $5,850 | $6,750 |
| USDC | 0% | $9,700 | $9,900 |
| BONK | 15% | $3,400 | $4,675 |
| $5,000 SOL + $5,000 NVDAx | $6,937.50 | $7,650 |
Held in two separate accounts, the last row would have a credit limit of $6,250.
Borrowing
| Setting | Value |
|---|---|
| Rate at 0%, 90% and 100% utilization | 2%, 10%, 70% |
| Kink | 90% utilization |
| Share of interest to the reserve, the protocol, lenders | 10%, 10%, 80% |
| Tier discounts | 0.40% after 7 healthy days, 0.80% after 30 |
| Risk premiums | BONK 15%, NVDAx and AAPLx 3%, others 0% |
| Share of the premium charged per tier | 100%, 60%, 30% |
| Warning health | 1.10 |
| Liquidation bonus | 5%, or an asset's own lower one |
| Close factor | 50% of the debt per transaction |
| Oldest price for a draw or a liquidation | 1 day for JitoSOL and JupSOL; the demo prices of SOL, NVDAx, AAPLx and BONK do not expire |
| Bounty for collecting LP fees | 2% of the fees, for autopay and compounding alike |
Lending
| Setting | Value |
|---|---|
| Junior premium | 15% |
| Junior target share | 10% of the pool |
| Junior rate at 1% of the pool or less | 15.85 × the senior rate |
| Junior rate at 5% of the pool | 3.85 × the senior rate |
| Junior rate at the target share | 2.35 × the senior rate |
| Junior rate at 50% of the pool | 1.15 × the senior rate |
| Example at 90% utilization, juniors at 10% | senior 6.34%, junior 14.91% |
| Epoch | 7 days, from Friday 00:00 UTC |
| Margin held back each epoch | 10% of the buffer |
| Junior exit delay | 6 days |
| Claim window | 2 days |
| Exit fee | 0.05% |
| Longest pause of junior exits | 90 days, with 14 days between pauses |
| Activation delay | 8 days |
Try it
On a local chain, from a clone on Linux, macOS or WSL. Tested with Rust 1.89.0, Solana CLI 4.1.2, Anchor 1.2.2 and Node 22. The scripts sign with ~/.config/solana/id.json.
npm install
anchor build --ignore-keys
npm run localnet # keep it running; the first run downloads the Orca program from devnet
npm run dev # in a second terminal, then open http://localhost:3000
- Open Borrow and connect a wallet. "Demo wallet" needs no browser extension.
- Press Get test tokens. It sends 10 SOL, 50 NVDAx, 5,000 USDC, 10 JitoSOL, 10 JupSOL, 20 AAPLx, 100,000,000 BONK and one Orca position. A faucet wallet last stocked before JitoSOL, JupSOL, AAPLx and BONK were added skips them until
npm run faucet:stockruns again. On devnet it sends 0.05 SOL instead of 10. - Deposit collateral, then draw USDC. To use a Meteora position, open one from Deposit as described in Meteora DLMM.
- Open Earn to lend into either tranche.
With no local chain running, npm run dev points at devnet. Get test tokens shows there only when the server holds the faucet key in FAUCET_SECRET.