Skip to main content
Staking-related transaction events can be tracked using either the List Portfolio Transactions or List Wallet Transactions endpoints. Both endpoints return identical response structures; the wallet-level endpoint simply scopes the results to a single wallet. You can use these APIs to monitor staking lifecycle events (e.g., initiation, exit) and to track reward distribution over time. For all non-ETH assets, rewards are deposited directly into the wallet from which the asset was staked.

​
Tracking Rewards

To track all reward distributions over time, use the List Portfolio Transactions or List Wallet Transactions endpoints and filter for REWARD transaction type. Below is an example of querying for staking rewards at the portfolio level.
  • Java
  • .NET
  • Go
  • Python
  • TS/JS
  • CLI 
TransactionsService transactionsService = PrimeServiceFactory.createTransactionsService(client);

ListPortfolioTransactionsRequest request = new ListPortfolioTransactionsRequest.Builder()
.portfolioId("PORTFOLIO_ID_HERE")
.types(new TransactionType[] { TransactionType.REWARDS })
.build();

ListPortfolioTransactionsResponse response = transactionsService.listPortfolioTransactions(request);
To learn more about this SDK, please visit the Prime Java SDK.

​
Rewards by Asset

​
Solana (SOL)

Balance Types
Balance TypeCalculationConditions
bondable_amountSpendable - pending delegationReturns 0 if already bonded since the wallet is already staking. Excludes a small amount to ensure that the account is in good standing.
bonded_amountstaked + pending delegationSum of active + pending stakes
unbonding_amountpending undelegationSOL has a cooldown after the unstake tx is processed
withdrawable_amounttotal - stakingWithdrawals are subject to Solana’s rent-exempt minimum; approximately 0.0023 SOL must remain in the account.
Rewards
  • MEV Rewards are distributed as liquid SOL. Once distributed, they increase the Withdrawable balance.
  • Inflationary Rewards are automatically added to stake. Once distributed, they increase the Bonded balance.
  • Block Reward Sweeps are a special category of rewards, only distributed to clients running dedicated validators.
  • Rewards accrue at the epoch boundary; timing of availability is dependent on Solana’s epoch schedule.

​
Ethereum (ETH)

Balance Types
Balance TypeCalculationConditions
bondable_amountWithdrawable balanceReturns 0 for Staking Transaction Rewards wallet. Requires minimum 32 ETH
bonded_amountPulled from validator status directlyRequires at least one validator active
unbonding_amountPulled from validator status directlyRepresents funds awaiting exit but not yet withdrawable; exits may take multiple days depending on validator queue
unbondable_amountPulled from validator status directlyValidator status should be active for 256 epochs
Rewards ETH staking rewards are earned in the form of Consensus Layer and Execution Layer rewards.
  • Consensus Layer Rewards are credited directly to the same vault wallet that is actively staked. There is a sweep delay for all rewards above the max effective balance. For all new validators running on Pectra, the max effective balance is set to 2048 ETH and requires a partial withdrawal to retrieve pending rewards until that maximum is reached.
  • Execution Layer Rewards (MEV and Transaction Rewards) are paid out to the Staking Transaction Rewards wallet as liquid ETH and are not automatically staked.

​
Cardano (ADA)

Balance Types
Balance TypeCalculationConditions
bondable_amountAvailable balance for staking - 2Returns 0 if already bonded since wallet is already staking. Requires 2 ADA bond deposit. Cannot stake if already bonded
bonded_amountStaked balance
pending_rewards_amountUses stake address metadataRewards available for claim
withdrawable_amountWallet balance - 1 if staking, 0 if not
Rewards
  • Rewards are not distributed automatically. Instead, they accrue in the Pending Rewards balance until they are manually claimed.
  • Any rewards that are earned but not yet distributed are reflected in the Pending Rewards field.

​
Polkadot (DOT)

Balance Types
Balance TypeCalculationConditions
bondable_amountSpendable + bonded balancesExcludes a small amount to ensure that the account is in good standing. Returns 0 if negative.
bonded_amountDirect mapping from chain state
unbonding_amountDirect mapping from chain stateTakes 28 days
withdrawable_amountTotal balance - max lock; subtracts existential deposit
reserved_amountDirect from chain stateCannot be spent or staked
unvested_amountDirect from chain stateCan be staked but not withdrawn. These funds typically “unlock” on a rolling basis, with an amount that varies by account
Rewards
  • Rewards are automatically distributed to the client address.
  • Once distributed, they are added directly to the Bonded balance since rewards autocompound.

​
Sui (SUI)

Balance Types
Balance TypeCalculationConditions
bondable_amountTotal balance if conditions metRequires minimum 1 SUI. Returns 0 if already bonded since wallet is already staking. Full staking only.
bonded_amountDirect mapping from chain stateCurrently delegated/staked amount
pending_rewards_amountDirect mapping from chain stateRewards available for claim
Rewards
  • Rewards accrue in the Pending Rewards balance and must be unstaked to be claimed.
  • Pending rewards are deposited approximately 24 hours after unstaking.