How Sirius.fi works

Your actual APR is what this position has really earned, annualized, not the pool's advertised estimate. We take everything the position has earned (pending fees, harvested fees, and harvested rewards), divide by its current value, then scale that up to a yearly rate by how long it's been open.

APR % = (totalEarned / valueUsd) × (365 / daysOpen) × 100

totalEarned = pending fees + harvested fees + harvested rewards   (USD)
valueUsd    = current position value (Raydium spot price)
daysOpen    = (now − position open time) in days

Be honest about what this is: a lifetime-realized, simply-annualized figure. It does not compound, and it divides earnings by the position's current value rather than a time-weighted average of the capital you actually had deployed. That makes it a fair backward-looking summary, not a forward guarantee of future yield. We hold it back entirely for the first 24 hours (too little data), flag it as provisional for the first week, and suppress implausible readings (above 999%, or when nothing has been earned yet) rather than show a misleading number.

ROI vs Holding answers one question: has actively providing liquidity actually paid off? We compare your position today (its value plus everything it earned) against the cash you put in, net of what you took out. We also show a second comparison: how you'd have done simply holding the tokens you deposited, at today's prices.

netInvested   = Σ deposits − Σ withdrawals        (USD, each priced at its tx time)
realizedGains = harvested fees + harvested rewards  (USD)
netResult     = currentValue + realizedGains − netInvested
ROI vs Holding = netResult / netInvested

vs Holding tokens:
  hodlValueNow = (net deposited token amounts) × today's prices
  delta        = currentValue + realizedGains − hodlValueNow

Each deposit and withdrawal is valued in USD at the price at that transaction's exact time, so the cash-flow figure is exact. A reinvested harvest (compound) contributes only its genuinely new capital. The re-deposited fee portion is stripped so it never double-counts.

A deliberate boundary, not a bug. If you've withdrawn most of what you put in, your net invested shrinks toward zero, and dividing by a tiny number makes the ROI percentage balloon even when the dollars are modest. Sirius handles this honestly rather than printing a dramatic but meaningless percentage:

• When net invested falls to about a dollar or less, we withhold the percentage entirely and show only the dollar figures.
• When withdrawals exceed half of deposits, we show a warning that the % is measured against the small remaining net investment, and tell you to trust the dollars first.
• If a pool holds a token we can't price historically, or the earliest transactions fall outside the synced history, we say the ROI isn't available rather than show an understated one.

We lead with dollars and treat the percentage as secondary on purpose: the dollar figures are always exact; the ratio can mislead.

Everything above depends on knowing exactly what you put in and took out. Sirius reconstructs that from your transaction history, classifying each liquidity change for a position as a deposit, a withdrawal, or a compound (a single transaction that harvests fees and reinvests them).

• Opening deposit: a position's very first liquidity comes from an open_position instruction (in any of its three variants). We read the deposited amounts from the position-creation event and the position identity from the instruction itself.
• Later adds: subsequent increase_liquidity events are deposits.
• Withdrawals: a decrease_liquidity that actually removes liquidity is a withdrawal (a decrease that removes no liquidity is just a fee claim, handled by the fees pipeline instead).
• Compounds: net new capital only, with the reinvested fee portion subtracted out.

netInvested = Σ deposits − Σ withdrawals
              (each amount × its token's USD price at the transaction's time)

We use a pure cash-flow model on purpose: when liquidity is partially withdrawn, any first-in-first-out or pro-rata assumption about which tokens left would be unverifiable. The cash-flow figure, by contrast, is exact.

Sirius distinguishes pending earnings (sitting in the position, not yet claimed) from harvested ones (already claimed in past transactions), and prices them differently, because they happened at different times.

• Pending fees are computed from on-chain fee-growth math, then valued at the current Raydium spot price.
• Harvested fees are valued at the historical price on the day you claimed them, so past earnings reflect what they were actually worth then, not today.
• Rewards (RAY and other pool emissions) are valued the same way, at the historical price on the harvest date.

pending fee USD  = fee0 × spotPrice0 + fee1 × spotPrice1    (Raydium spot, now)
harvested USD    = amount × historical price on the harvest date  (stablecoins = $1)

Where a token has no usable price source, or a historical price simply isn't available for that day, that amount is excluded and disclosed, never counted as $0 (see the rule above). For ROI, any reward tokens we couldn't price are listed as excluded, so you know precisely what the figure does and doesn't include.

Every number traces back to a public source. Which number comes from where:

• Solana RPC (via Helius) — your positions, pool and account state, transaction history, and the on-chain fee math. All read-only.
• Raydium API — current spot prices for live position value and pending fees, plus pool metadata (fee rate, the pool's own APR estimate).
• CoinGecko — historical prices, used to value harvested fees, rewards, and ROI capital changes at the time they happened.
• Jupiter — the live SOL price in the header (Price API v3), and token names and logos. Jupiter never prices your positions.