Lido

Stake ETH for rebasing stETH on Ethereum, or unstake existing stMATIC and stSOL positions.

yield.xyz exposes three Lido liquid staking yields. ETH staking on Ethereum supports entering and exiting and mints rebasing stETH. The stMATIC and stSOL yields are exit only: you can unstake and withdraw an existing position, but you cannot open a new one through yield.xyz.

Availability

Network	Input token	Receipt token	Enter / exit
Ethereum	ETH	stETH	Both, subject to Lido’s pause state
Ethereum	POL (MATIC)	stMATIC	Exit only
Solana	SOL	stSOL	Exit only

Yield IDs: ethereum-eth-lido-staking, ethereum-matic-liquid-staking, solana-sol-lido-staking. Query GET /v1/yields?providers=lido for the Lido yields enabled for your project.

ETH staking (stETH)

Entering takes amount and mints stETH 1:1 for the ETH deposited. While Lido has staking paused, the yield’s status.enter is false; while its withdrawal queue is paused, status.exit is false.

Exiting takes amount (at most 1,000 stETH per request) and places a request in Lido’s withdrawal queue. The position runs the yield’s cooldownPeriod of 5 days, then appears as a withdrawable balance with a CLAIM_UNSTAKED pending action that releases the ETH.

stMATIC, exit only

status.enter is always false for ethereum-matic-liquid-staking, regardless of the underlying contract’s state. Exiting takes amount, runs a 3-day cooldown, and then exposes a WITHDRAW pending action that releases the POL.

stSOL, exit only

status.enter is always false for solana-sol-lido-staking. Exiting takes amount, validatorAddress, and the lidoStakeAccounts additional address (the existing Lido stake accounts to unstake from). The position runs a 3-day cooldown and a 3-day withdraw period, then exposes a WITHDRAW pending action.

Do not request enter actions for stMATIC or stSOL. Both yields exist only so existing positions can exit.

Rewards and position

stETH rebases: the balance grows as rewards accrue. stMATIC and stSOL are exchange-rate tokens: the balance stays constant while its value rises. Reward claiming is automatic on all three. Which fee types you can configure on this yield is listed in mechanics.possibleFeeTakingMechanisms; see Monetization.

List the live yields

Copy this request to list the Lido yields enabled for your project. Yield IDs change as markets and networks are added, so query the API rather than hardcoding them.

curl "https://api.yield.xyz/v1/yields?providers=lido&limit=100" \
  -H "x-api-key: $YIELD_API_KEY"

Next steps

Liquid staking

Compare every liquid staking integration.

Action lifecycle

Build the enter and exit flow, and track cooldowns to completion.