About Earn
What is Jupiter Earn?
What is Jupiter Earn?
Jupiter Earn is the deposit-and-earn side of Jupiter Lend. Simply deposit assets and earn yield.
Why is this separate from borrowing?
Why is this separate from borrowing?
Jupiter Lend uses a unified liquidity layer where both Earn (lending) and Borrow (vault) protocols can source liquidity from. For depositors this means you earn the best possible rate at all times without having to migrate your funds when new protocols are launched on Jupiter Lend. You can supply once and earn the most up to date yield from the Jupiter Lend protocol.
Are there supply or withdraw limits?
Are there supply or withdraw limits?
There are no limits on supplying funds to the Earn Protocol. Withdrawals from Jupiter Lend utilise an Automated Debt Ceiling. Withdrawals increase every block creating a smoothing curve for withdrawals preventing any sudden large movements.
What are the risks?
What are the risks?
Jupiter Lend is a novel protocol and like all DeFi protocols contains smart contract risk, market risk and other factors which can cause loss of user funds.
What are the fees?
What are the fees?
There are no fees to use the Earn Protocol on Jupiter Lend.
Key components of Earn integration
Earn Operations
Get deposit and withdraw as raw instructions or as account context for CPI. Use the instructions to build and send transactions, or pass the context into your Anchor program.
Yield tracking
Get all lending tokens, token details (supply rate, rewards rate, totals, conversion multipliers), and a user’s position by asset (shares, underlying assets, wallet balance) using SDK.
Ways to fetch data
Public API
Tokens, positions, and earnings endpoints for pool metrics and user data.
SDK (Earn data)
Get instructions for all operations; read lending tokens, token details, and Earn user positions by asset.
Key data structures
Lending Account
The Lending account represents the per-asset state for Jupiter Lend Earn. There is one Lending account per supported underlying token mint.It links the Earn vault layer to the underlying liquidity layer and tracks pricing, reward configuration, and liquidity positions.
Account structure
| Field | Type | Description |
|---|---|---|
mint | Pubkey | Underlying SPL token mint accepted by this lending market (e.g. USDC). |
f_token_mint | Pubkey | Mint address for receipt/shares tokens (jlTokens) representing user deposit balances. |
lending_id | u16 | Unique identifier for this lending market. |
decimals | u8 | Number of decimals for the underlying asset and jlToken (same as underlying mint). |
rewards_rate_model | Pubkey | PDA of the rewards rate model used to calculate reward accrual. |
liquidity_exchange_price | u64 | Exchange price in the liquidity layer (excluding rewards), scaled (e.g. 1e12). |
token_exchange_price | u64 | Exchange price between jlToken and underlying asset (including rewards), scaled (e.g. 1e12). |
last_update_timestamp | u64 | Unix timestamp of the most recent exchange price update. |
token_reserves_liquidity | Pubkey | PDA of the liquidity program’s token reserve account for this asset. |
supply_position_on_liquidity | Pubkey | PDA of the lending program’s supply position in the liquidity layer. |
bump | u8 | PDA bump seed for this Lending account. |
Notes
liquidity_exchange_pricereflects base liquidity yield without rewards.token_exchange_priceincludes reward accrual and determines the value of jlTokens.- All prices are scaled integers and must be descaled using the appropriate precision.
