Documentation Index
Fetch the complete documentation index at: https://docs.raydium.io/llms.txt
Use this file to discover all available pages before exploring further.
A farm distributes reward tokens to users who stake a specific staking mint, typically a CPMM or AMM v4 LP token. Farm v6 is the current generation and the only one accepting new farm creation.
When to create a farm
Create a farm when:- You need to attract liquidity to a specific pool.
- You want to reward LPs beyond native swap fees.
- You are distributing treasury tokens to protocol-aligned LPs.
What you need
- Staking mint: usually the LP token of an existing CPMM or AMM v4 pool.
- Reward mint(s): 1-5 mints to distribute.
- Reward budget: amount per reward mint for the full schedule.
- Wallet SOL: about 0.1 SOL for creation rent, token accounts, and priority fees.
Farm version choice
| Version | Status | Use |
|---|---|---|
| v3 | Legacy | Existing farms only |
| v5 | Legacy | Existing farms only |
| v6 | Current | All new farms |
Designing the reward schedule
For each reward mint, decide:- Total reward amount: the budget you will fund up front.
- Start time: now or a scheduled future timestamp.
- End time: usually 30-90 days after start.
- Target APR: your intended annualized reward relative to expected TVL.
UI walkthrough
On raydium.io/farms/create:- Pick staking mint. Paste the LP mint address. Confirm it matches the pool you want to incentivize.
- Add reward mints. Add 1-5 rewards with total amount, start time, and end time.
- Review APR and budget. Check the projected APR, total reward spend, and per-reward breakdown.
- Create the farm. Sign the farm creation transaction.
- Fund rewards. Sign the funding transaction that moves reward tokens into the vault.
- Wait for indexing. The farm should appear on Raydium within a few minutes.
Monitoring the farm
Stake progress
Check total staked LP, number of stakers, and TVL after launch. If TVL is far below expectations, the displayed APR may be higher than planned.Realized APR
Compare the displayed APR against your target. If token price or TVL changes materially, decide whether to top up, extend, or let the farm finish.Remaining reward balance
Monitor remaining rewards before the end date. If rewards run dry early, users may see pending rewards that cannot be harvested until the vault is refilled.Top-up and extension
Use the farm management UI to add more rewards or extend a running schedule when available. Keep the same public communication standard as launch: announce changes before users rely on the APR. If a farm has ended, create a new schedule or restart incentives according to the UI options available for that farm.Reclaiming unused rewards
Unused rewards can be reclaimed only by the farm admin and only after the reward stream ends. Do not reclaim rewards early unless you have clearly announced the wind-down.Troubleshooting
Under-funded vault
If the reward vault balance is lower than the schedule requires, harvests can fail near the end. Fund the full budget up front.Wrong staking mint
Creating a farm against the wrong LP mint is a serious mistake. Double-check the pool and LP mint before signing.Farm is not a pool
A farm does not create liquidity. It only rewards users who stake an existing LP token.Priced per second
Farm v6 emits rewards over time. Think in tokens per day or total budget over duration, not slots or blocks.Tokens with transfer fees
If your reward mint has transfer fees, users receive less than the displayed gross reward. Disclose this in launch communications.CLMM positions do not use Farm v6
CLMM has built-in position rewards. Do not create a Farm v6 farm for CLMM position NFTs unless the UI explicitly supports that flow.Pointers
products/farm-staking/overview— farm concept.products/farm-staking/instructions— instruction-level reference.user-flows/add-remove-liquidity— user-side harvest and collect flow.algorithms/constant-product— LP share economics.