Deeplink into the widget

Open a widget deployment directly to a yield, a token, or a pending action using URL query parameters.

The yield widget reads a set of query parameters from the page’s own URL when it loads. Add them to the URL of a page where you’ve embedded the widget, for example your own site or a Widget Pro deployment, to open it straight to a specific token, yield, or pending action instead of the default entry point.

There’s no separate hosted yield.xyz app to link to: these parameters work on whatever URL your own widget deployment is served from.

Parameters

Parameter	Effect
network	Preselects the network, alongside token.
token	Preselects the token on that network.
yieldId	Preselects the yield directly; takes priority over token when both resolve to different yields.
pendingaction	Opens the named pending action (for example CLAIM_REWARDS, WITHDRAW, CLAIM_UNSTAKED) for the connected wallet’s position on yieldId, once the wallet is connected and owns that position.
validator	Narrows the pending action to a specific validator, for a validator-scoped balance.
tab	Opens a specific tab: earn, positions, manage, or activity.

The widget’s own parameter is validator, not validatoraddress.

pendingaction values match the action type values returned in a balance’s pendingActions[]; see Balances and positions.

Open a specific yield

https://your-app.example/stake?network=ethereum&token=ETH&yieldId=ethereum-eth-lido-staking

network and token alone preselect a token even without yieldId; add yieldId when you want a specific yield on that token preselected instead of the widget’s default.

Open a pending action

https://your-app.example/stake?network=cosmos&yieldId=cosmos-atom-native-staking&pendingaction=CLAIM_REWARDS

Add validator when the position is validator-scoped:

https://your-app.example/stake?network=cosmos&yieldId=cosmos-atom-native-staking&pendingaction=RESTAKE_REWARDS&validator=cosmosvaloper1yourvalidatoraddress

The widget only opens the pending action once its wallet connection resolves to the address that owns that position; deep-linking a pending action doesn’t connect a wallet on its own.

Next steps

Embed the yield widget

Every prop the widget accepts.

Balances and positions

Where pending action types come from.