Skip to main content
Cosmos Hub ATOM staking with validator selection, 21-day unbonding, and reward claiming via the unified Yield.xyz API.

What this yield is

  • Asset: ATOM (native Cosmos Hub token)
  • Mechanism: Delegate ATOM to validators to secure the network
  • Rewards: Staking rewards accrue per block; must be claimed explicitly
  • Unbonding: 21-day unbonding period; funds do not earn during unbonding

Required inputs

Fetch available validators from the validators endpoint.

Actions & lifecycle

  • Call /actions/enter with amount and validatorAddress
  • Single delegation transaction returned
  • Sign with Cosmos-compatible signer (cosmjs, Keplr, etc.)
  • Position becomes active after block confirmation
  • Rewards begin accruing immediately

Example flow

1

Fetch yield metadata

Get validator options and staking mechanics.
2

Get validators

List available validators with performance metrics.
3

Request enter action

Call enter with amount and chosen validator.
4

Sign & submit

Sign the Cosmos transaction and broadcast.
5

Track balances

Monitor rewards and manage position.

Operational notes

Unbonding cannot be cancelled. Plan exit timing accordingly. During unbonding, funds are not earning rewards and are not liquid.
Delegated ATOM is subject to slashing if the validator misbehaves. Diversify across validators to reduce exposure.
Rewards accumulate but must be claimed explicitly. Use the manage action with claim-rewards type. Rewards can also be auto-restaked.
Cosmos allows instant redelegation to a new validator without unbonding. However, you cannot redelegate again for 21 days from the destination validator.
For institutional custody flows, validate transactions with Shield before signing.

Preferred validators


Considerations

When a user delegates additional tokens to a validator they already have a staked position with, any earned rewards are automatically claimed and added to the user’s available balance. Similarly, when a user partially or fully unstakes their position, the unclaimed rewards are also automatically claimed.
In some cases, there can be a precision loss issue in the Cosmos SDK during unbonding, specifically when converting from validator shares back to tokens. The loss due to this issue can be 1 uatom.

Other Cosmos chains

The same integration pattern applies to other Cosmos SDK chains:

Osmosis

OSMO staking (14-day unbonding)

dYdX

DYDX staking (30-day unbonding)

Injective

INJ staking

Non-EVM Overview

All Cosmos chains