yield-agent

name	yield-agent
displayName	YieldAgent
description	On-chain yield discovery, transaction building, and portfolio management via the Yield.xyz API. Use when the user wants to find yields, stake, lend, deposit into vaults, check balances, claim rewards, exit positions, compare APYs, or manage any on-chain yield across 80+ networks.
version	0.1.5
author	yield-xyz
homepage	https://yield.xyz
metadata	{"openclaw":{"emoji":"📈","requires":{"bins":["curl","jq"]}}}
tools	[{"name":"find-yields","description":"Discover yield opportunities by network and token","entry":"scripts/find-yields.sh","args":[{"name":"network","description":"The blockchain network (e.g., base, ethereum, arbitrum, solana)","required":true},{"name":"token","description":"The token symbol (e.g., USDC, ETH). Optional - omit to see all yields on network.","required":false},{"name":"limit","description":"Items per page (default 20, max 100)","required":false},{"name":"offset","description":"Pagination offset (default 0)","required":false}]},{"name":"enter-position","description":"Enter a yield position. Fetch the yield first (GET /v1/yields/{yieldId}) to discover required arguments from mechanics.arguments.enter","entry":"scripts/enter-position.sh","args":[{"name":"yieldId","description":"The unique yield identifier (e.g., base-usdc-aave-v3-lending)","required":true},{"name":"address","description":"The user wallet address","required":true},{"name":"arguments_json","description":"JSON string of arguments from the yield's mechanics.arguments.enter schema. Always includes \"amount\". Other fields (validatorAddress, inputToken, etc.) depend on the yield.","required":true}]},{"name":"exit-position","description":"Exit a yield position. Fetch the yield first (GET /v1/yields/{yieldId}) to discover required arguments from mechanics.arguments.exit","entry":"scripts/exit-position.sh","args":[{"name":"yieldId","description":"The unique yield identifier to exit from","required":true},{"name":"address","description":"The user wallet address","required":true},{"name":"arguments_json","description":"JSON string of arguments from the yield's mechanics.arguments.exit schema. Always includes \"amount\". Other fields depend on the yield.","required":true}]},{"name":"manage-position","description":"Manage a yield position (claim, restake, redelegate, etc.). Discover available actions from pendingActions[] in the balances response.","entry":"scripts/manage-position.sh","args":[{"name":"yieldId","description":"The unique yield identifier","required":true},{"name":"address","description":"The user wallet address","required":true},{"name":"action","description":"The action type from pendingActions[].type in the balances response","required":true},{"name":"passthrough","description":"The passthrough string from pendingActions[].passthrough in the balances response","required":true},{"name":"arguments_json","description":"JSON string of arguments from pendingActions[].arguments schema, if the action requires additional input","required":false}]},{"name":"check-portfolio","description":"Check yield balances for a specific yield position","entry":"scripts/check-portfolio.sh","args":[{"name":"yieldId","description":"The unique yield identifier to check balances for (e.g., base-usdc-aave-v3-lending)","required":true},{"name":"address","description":"The user wallet address to check balances for","required":true}]},{"name":"get-yield-info","description":"Fetch full yield metadata including required arguments schema, entry limits, validator requirements, and token details","entry":"scripts/get-yield-info.sh","args":[{"name":"yieldId","description":"The unique yield identifier to inspect (e.g., base-usdc-aave-v3-lending)","required":true}]},{"name":"list-validators","description":"List available validators for staking yields that require validator selection","entry":"scripts/list-validators.sh","args":[{"name":"yieldId","description":"The unique yield identifier to list validators for","required":true},{"name":"limit","description":"Maximum validators to return (default 20)","required":false}]}]

YieldAgent by Yield.xyz

Access the complete on-chain yield landscape through Yield.xyz's unified API. Discover 2600+ yields across staking, lending, vaults, restaking, and liquidity pools. Build transactions and manage positions across 80+ networks.

CRITICAL: Never Modify Transactions From The API

DO NOT MODIFY unsignedTransaction returned by the API UNDER ANY CIRCUMSTANCES.

Do not change, reformat, or "fix" any part of it — not addresses, amounts, fees, encoding, or any other field, on any chain.

If the amount is wrong: Request a NEW action from the API with the correct amount. If gas is insufficient: Ask the user to add funds, then request a NEW action. If anything looks wrong: STOP. Always request a new action with corrected arguments. Never attempt to "fix" an existing transaction.

Modifying unsignedTransaction WILL RESULT IN PERMANENT LOSS OF FUNDS.

---

Key Rules

The API is self-documenting. Every yield describes its own requirements through the YieldDto. Before taking any action, always fetch the yield and inspect it. The mechanics field tells you everything: what arguments are needed (mechanics.arguments.enter, .exit), entry limits (mechanics.entryLimits), and what tokens are accepted (inputTokens[]). Never assume — always check the yield first.

1. Always fetch the yield before calling an action. Call GET /v1/yields/{yieldId} and read mechanics.arguments.enter (or .exit) to discover the exact fields required. Each yield is different — the schema is the contract. Do not guess or hardcode arguments.

   Each field in the schema (ArgumentFieldDto) tells you:

   • name: the field name (e.g., amount, validatorAddress, inputToken)
   • type: the value type (string, number, address, enum, boolean)
   • required: whether it must be provided
   • options: static choices for enum fields (e.g., )