Skip to main content

Documentation Index

Fetch the complete documentation index at: https://yieldxyz.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

ArgumentRequiredDescription
amountYesAmount of ATOM to stake
validatorAddressYesValidator operator address (cosmosvaloper…)
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.
curl --request GET \
  --url https://api.yield.xyz/v1/yields/cosmos-atom-native-staking \
  --header 'accept: application/json' \
  --header 'x-api-key: <API_KEY>'

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

ValidatorAddress
Figmentcosmosvaloper1hjct6q7npsspsg3dgvzk3sdf89spmlpfdn6m9d
Chorus Onecosmosvaloper15urq2dtp9qce4fyc85m6upwm9xul3049e02707
Staking Facilitiescosmosvaloper1x88j7vp2xnw3zec8ur3g4waxycyz7m0mahdv3p
Stakedcosmosvaloper1we6knm8qartmmh2r0qfpsz6pq0s7emv3e0meuw
Coinbase Cloudcosmosvaloper1crqm3598z6qmyn2kkcl9dz7uqs4qdqnr6s8jdn
Chainflowcosmosvaloper1j0vaeh27t4rll7zhmarwcuq8xtrmvqhudrgcky
Everstakecosmosvaloper1tflk30mq5vgqjdly92kkhhq3raev2hnz6eete3
Stakelycosmosvaloper16yupepagywvlk7uhpfchtwa0stu5f8cyhh54f2

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