Calculation

How Cashback and Creator Fees Are Attributed

Cashback and creator-fee metrics come from decoded trade and claim events, with mint and account accumulators updated separately.

Trade-time earnings

MetricSource
earned_cashback_lamportsSum of nonzero TradeEvent cashback for a mint.
cashback_eventsCount of trades where cashback is greater than zero.
earned_creator_fee_lamportsCreator fee observed on TradeEvent breakdowns.
distributed_creator_fee_lamportsLegacy API field name that currently stores TradeEvent creator_fee per mint.

Claim events

  • ClaimCashbackEvent adds the claimed amount to account cashback claims and gain_with_claim.
  • CollectCreatorFeeEvent adds collected creator-fee value to account creator-fee claims and gain_with_claim.
  • DistributeCreatorFeesEvent helps map shareholders to mint flags for overview category attribution.

Cashback claim attribution

For overview breakdowns, cashback claims are attributed back across the user's observed cashback-earning mints. When a claim spans multiple categories, allocation is proportional to the recorded cashback weights.