Skip to main content
Understanding when staking becomes active and when unstaking completes is important for managing staking positions. This page covers how to track the full lifecycle of staked assets, from initial stake request through activation to unstaking completion.

Staking Activation

After a stake transaction is submitted and approved, there is a delay before the staked assets begin earning rewards. This activation period varies by network and depends on protocol-level queues and processing times.

Ethereum (ETH)

After a deposit transaction is processed, the validator enters the activation queue. The queue processes validators based on a per-epoch churn limit, resulting in variable wait times depending on network demand. Top-up deposits to existing active validators have a shorter activation delay than new validator activations. Historical activation times for validators are available in the Prime UI. Tracking Validator Status The Query Transaction Validators endpoint returns the per-validator status that determines when rewards begin accruing.
Validator StatusDescription
VALIDATOR_STATUS_PENDINGValidator is activating and not yet earning rewards
VALIDATOR_STATUS_ACTIVEValidator is staked and actively earning rewards
VALIDATOR_STATUS_EXITINGValidator is in the process of unstaking
VALIDATOR_STATUS_EXITEDValidator has completed unstaking
VALIDATOR_STATUS_WITHDRAWNValidator funds have been withdrawn
The validator_status field reflects the underlying protocol state. A validator must reach VALIDATOR_STATUS_ACTIVE before it begins earning rewards.

Solana (SOL)

Solana staking becomes active at the next epoch boundary after processing. Each epoch takes roughly 2-3 days depending on remaining slots and block times. Balance Tracking Considerations While polling balances can provide directional insight, note that bonded_balance does not directly indicate whether assets are actively earning rewards. Rewards accrue at epoch boundaries, and timing depends on Solana’s epoch schedule.

Unstaking and Withdrawal

Ethereum (ETH)

ETH unstaking has two different forms:
  • Full Validator Exit - Unstaking that reduces the staked balance to zero triggers a validator exit. This is subject to the exit queue, which has variable wait times depending on network conditions.
  • Partial Withdrawal - Unstaking while keeping at least 32 ETH staked does not result in the validator exiting the network.
Tracking Unstaking Progress The Get Unstaking Status endpoint monitors ETH unstaking progress and provides:
  • Estimated completion timestamp
  • Hours remaining until funds become withdrawable
  • Amount being unstaked
  • Whether it’s a partial or full unstake
{
  "portfolio_id": "<string>",
  "wallet_id": "<string>",
  "wallet_address": "<string>",
  "current_timestamp": "2025-10-17T15:30:00.000Z",
  "validators": [
    {
      "validator_address": "<string>",
      "statuses": [
        {
          "amount": "16",
          "estimate_type": "UNSPECIFIED",
          "estimate_description": "Live estimate based on current network conditions",
          "unstake_type": "UNSTAKE_TYPE_UNSPECIFIED",
          "finishing_at": "2025-10-27T00:00:00.000Z",
          "remaining_hours": 672,
          "requested_at": "2025-09-29T12:00:00.000Z"
        }
      ]
    }
  ]
}
Previewing Unstake Amounts Since rewards continue to accumulate during the unbonding period, the final amount received may differ from the originally staked amount. The Preview Unstake endpoint shows the estimated total that will be received, including any rewards earned while unbonding. Unstaking Transactions During and after the ETH unstaking process, the following transaction types are generated:
Transaction TypeDescription
COMPLETE_UNBONDINGGenerated when unstaking completes and funds become withdrawable
REWARDReward transactions may continue to arrive during the unbonding period as the validator remains active in the exit queue
These transaction types can be tracked using the List Portfolio Transactions or List Wallet Transactions endpoints. Claiming Rewards Claiming rewards via Prime and partial unstaking (where at least 32 ETH remains staked) both use the same underlying Ethereum partial withdrawal mechanism, but differ in what can be withdrawn. Claim Rewards restricts withdrawals to accumulated rewards only, whereas unstake allows withdrawal of both principal and rewards. The Claim Wallet Staking Rewards endpoint initiates a reward claim. Transaction-level execution rewards are automatically deposited into the Staking Transaction Rewards wallet and do not require manual claiming.
POST /v1/portfolios/{portfolio_id}/wallets/{wallet_id}/staking/claim_rewards
An amount can optionally be specified, or omitted to claim the maximum available.

Solana (SOL)

Solana unstaking completes at the next epoch boundary, the same as staking activation. Each epoch takes roughly 2-3 days. During this cooldown period, the funds appear in unbonding_amount and cannot be withdrawn. Once the cooldown ends, funds are automatically credited to the withdrawable balance.

API Reference

EndpointPurposeSupported Assets
Query Transaction ValidatorsMonitor validator activation statusETH
Get Unstaking StatusTrack unstaking completion timeETH
Preview UnstakeEstimate total unstake amount including rewardsETH
Claim Wallet Staking RewardsClaim accumulated staking rewardsETH