API Reference

Prepare an unsigned Cosmos staking transaction

Prepare an unsigned transaction for Cosmos staking operations.

Transaction Types:

delegate: Stake tokens to earn rewards from a validator

  • Purpose: Start earning staking rewards immediately
  • Requirements: Sufficient balance for delegation amount + gas fees
  • Effects: Tokens become bonded, rewards start accruing next block
  • Timeline: Rewards begin immediately, can undelegate anytime (21-day unbonding period)
  • Minimum: Network-specific minimum delegation amounts may apply

undelegate: Unstake tokens and begin 21-day unbonding period

  • Purpose: Exit staking position and recover tokens
  • Requirements: Active delegation with the specified validator
  • Effects: Begins 21-day unbonding period, stops earning rewards immediately
  • Timeline: Tokens become available after exactly 21 days
  • Amount: Must specify amount in micro units

redelegate: Move delegation from another validator to Stakefish instantly

  • Purpose: Switch to Stakefish validator without unbonding penalty or delay
  • Requirements: Active delegation with a non-Stakefish validator
  • Effects: Tokens move to Stakefish immediately, continue earning rewards
  • Timeline: Instant switch, but 21-day cooldown before re-redelegating same tokens
  • Restrictions: Cannot redelegate from same validator again for 21 days

claim_rewards: Claim accumulated staking rewards

  • Purpose: Transfer earned rewards to your available balance
  • Requirements: Pending rewards from one or more delegations
  • Effects: Rewards transferred to balance, delegation principal unchanged
  • Timeline: Rewards available next block
  • Optimization: Can claim from multiple validators in single transaction

Important Notes:

  • Gas fees are paid in the native token (e.g., ATOM for Cosmos Hub)
  • Slashing events can reduce delegation amounts (validator misbehavior)
  • Rewards auto-compound if not claimed regularly
  • Commission rates can change (subject to validator max change rate)
  • Network governance can modify staking parameters
Language
Credentials
Header
Click Try It! to start a request and see the response here!