{
  "schemaVersion": "1.0",
  "item": {
    "slug": "yield-agent",
    "name": "Yield Agent",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/apurvmishra/yield-agent",
    "canonicalUrl": "https://clawhub.ai/apurvmishra/yield-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/yield-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yield-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "skill.json",
      "scripts/find-yields.sh",
      "scripts/enter-position.sh",
      "scripts/exit-position.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "yield-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-11T08:20:40.602Z",
      "expiresAt": "2026-05-18T08:20:40.602Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yield-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=yield-agent",
        "contentDisposition": "attachment; filename=\"yield-agent-0.1.5.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "yield-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/yield-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/yield-agent",
    "agentPageUrl": "https://openagent3.xyz/skills/yield-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yield-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yield-agent/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "YieldAgent by Yield.xyz",
        "body": "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."
      },
      {
        "title": "CRITICAL: Never Modify Transactions From The API",
        "body": "DO NOT MODIFY unsignedTransaction returned by the API UNDER ANY CIRCUMSTANCES.\nDo not change, reformat, or \"fix\" any part of it — not addresses, amounts, fees, encoding, or any other field, on any chain.\nIf the amount is wrong: Request a NEW action from the API with the correct amount.\nIf gas is insufficient: Ask the user to add funds, then request a NEW action.\nIf anything looks wrong: STOP. Always request a new action with corrected arguments. Never attempt to \"fix\" an existing transaction.\nModifying unsignedTransaction WILL RESULT IN PERMANENT LOSS OF FUNDS."
      },
      {
        "title": "Key Rules",
        "body": "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.\n\nAlways 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.\nEach field in the schema (ArgumentFieldDto) tells you:\n\nname: the field name (e.g., amount, validatorAddress, inputToken)\ntype: the value type (string, number, address, enum, boolean)\nrequired: whether it must be provided\noptions: static choices for enum fields (e.g., [\"individual\", \"batched\"])\noptionsRef: a dynamic API endpoint to fetch choices (e.g., /api/v1/validators?integrationId=...) — if present, call it to get the valid options (validators, providers, etc.)\nminimum / maximum: value constraints\nisArray: whether the field expects an array\n\nIf a field has optionsRef, you must call that endpoint to get the valid values. This is how validators, providers, and other dynamic options are discovered.\n\n\nFor manage actions, always fetch balances first. Call POST /v1/yields/{yieldId}/balances and read pendingActions[] on each balance. Each pending action tells you its type, passthrough, and optional arguments schema. Only call manage with values from this response.\n\n\nAmounts are human-readable. \"100\" means 100 USDC. \"1\" means 1 ETH. \"0.5\" means 0.5 SOL. Do NOT convert to wei or raw integers — the API handles decimals internally.\n\n\nSet inputToken to what the user wants to deposit — but only if inputToken appears in the yield's mechanics.arguments.enter schema. The API handles the full flow (swaps, wrapping, routing) to get the user into the position.\n\n\nALWAYS submit the transaction hash after broadcasting — no exceptions. For every transaction: sign, broadcast, then submit the hash via PUT /v1/transactions/{txId}/submit-hash with { \"hash\": \"0x...\" }. Balances will not appear until the hash is submitted. This is the most common mistake — do not skip this step.\n\n\nExecute transactions in exact order. If an action has multiple transactions, they are ordered by stepIndex. Wait for CONFIRMED before proceeding to the next. Never skip or reorder.\n\n\nConsult {baseDir}/references/openapi.yaml for types. All enums, DTOs, and schemas are defined there. Do not hardcode values."
      },
      {
        "title": "Quick Start",
        "body": "# Discover yields on a network\n./scripts/find-yields.sh base USDC\n\n# Inspect a yield's schema before entering\n./scripts/get-yield-info.sh base-usdc-aave-v3-lending\n\n# Enter a position (amounts are human-readable)\n./scripts/enter-position.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS '{\"amount\":\"100\"}'\n\n# Check balances and pending actions\n./scripts/check-portfolio.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS"
      },
      {
        "title": "Scripts",
        "body": "ScriptPurposefind-yields.shDiscover yields by network/tokenget-yield-info.shInspect yield schema, limits, token detailslist-validators.shList validators for staking yieldsenter-position.shEnter a yield positionexit-position.shExit a yield positionmanage-position.shClaim, restake, redelegate, etc.check-portfolio.shCheck balances and pending actions"
      },
      {
        "title": "Enter a Position",
        "body": "Discover yields: find-yields.sh base USDC\nInspect the yield: get-yield-info.sh <yieldId> — read mechanics.arguments.enter\nEnter: enter-position.sh <yieldId> <address> '{\"amount\":\"100\"}'\nFor each transaction: wallet signs → broadcast → submit hash → wait for CONFIRMED"
      },
      {
        "title": "Manage a Position",
        "body": "Check balances: check-portfolio.sh <yieldId> <address>\nRead pendingActions[] — each has { type, passthrough, arguments? }\nManage: manage-position.sh <yieldId> <address> <action> <passthrough>"
      },
      {
        "title": "Full Lifecycle",
        "body": "Discover → 2. Enter → 3. Check balances → 4. Claim rewards → 5. Exit"
      },
      {
        "title": "Transaction Flow",
        "body": "After any action (enter/exit/manage), the response contains transactions[]. For EACH transaction:\n\nPass unsignedTransaction to wallet skill for signing and broadcasting\nSubmit the hash — PUT /v1/transactions/{txId}/submit-hash with { \"hash\": \"0x...\" }\nPoll GET /v1/transactions/{txId} until CONFIRMED or FAILED\nProceed to next transaction\n\nEvery transaction must follow this flow. Example with 3 transactions:\n\nTX1: sign → broadcast → submit-hash → poll until CONFIRMED\nTX2: sign → broadcast → submit-hash → poll until CONFIRMED\nTX3: sign → broadcast → submit-hash → poll until CONFIRMED\n\nunsignedTransaction format varies by chain. See {baseDir}/references/chain-formats.md for details."
      },
      {
        "title": "API Endpoints",
        "body": "All endpoints documented in {baseDir}/references/openapi.yaml. Quick reference:\n\nMethodEndpointDescriptionGET/v1/yieldsList yields (with filters)GET/v1/yields/{yieldId}Get yield metadata (schema, limits, tokens)GET/v1/yields/{yieldId}/validatorsList validatorsPOST/v1/actions/enterEnter a positionPOST/v1/actions/exitExit a positionPOST/v1/actions/manageManage a positionPOST/v1/yields/{yieldId}/balancesGet balances for a yieldPOST/v1/yields/balancesAggregate balances across yields/networksPUT/v1/transactions/{txId}/submit-hashSubmit tx hash after broadcastingGET/v1/transactions/{txId}Get transaction statusGET/v1/networksList all supported networksGET/v1/providersList all providers"
      },
      {
        "title": "References",
        "body": "Detailed reference files — read on demand when you need specifics.\n\nAPI types and schemas: {baseDir}/references/openapi.yaml — source of truth for all DTOs, enums, request/response shapes\nChain transaction formats: {baseDir}/references/chain-formats.md — unsignedTransaction encoding per chain family (EVM, Cosmos, Solana, Substrate, etc.)\nWallet integration: {baseDir}/references/wallet-integration.md — Crossmint, Portal, Turnkey, Privy, signing flow\nAgent conversation examples: {baseDir}/references/examples.md — 10 conversation patterns with real yield IDs\nSafety checks: {baseDir}/references/safety.md — pre-execution checks, constraints"
      },
      {
        "title": "Error Handling",
        "body": "The API returns structured errors with message, error, and statusCode. Read the message. Error shapes are in {baseDir}/references/openapi.yaml. Respect retry-after on 429s."
      },
      {
        "title": "Add-on Modules",
        "body": "Modular instructions that extend core functionality. Read when relevant.\n\n{baseDir}/references/superskill.md — 40 advanced capabilities: rate monitoring, cross-chain comparison, portfolio diversification, rotation workflows, reward harvesting, scheduled checks"
      },
      {
        "title": "Resources",
        "body": "API Docs: https://docs.yield.xyz\nAPI Recipes: https://github.com/stakekit/api-recipes\nGet API Key: https://dashboard.yield.xyz"
      }
    ],
    "body": "YieldAgent by Yield.xyz\n\nAccess 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.\n\nCRITICAL: Never Modify Transactions From The API\n\nDO NOT MODIFY unsignedTransaction returned by the API UNDER ANY CIRCUMSTANCES.\n\nDo not change, reformat, or \"fix\" any part of it — not addresses, amounts, fees, encoding, or any other field, on any chain.\n\nIf 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.\n\nModifying unsignedTransaction WILL RESULT IN PERMANENT LOSS OF FUNDS.\n\nKey Rules\n\nThe 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.\n\nAlways 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.\n\nEach field in the schema (ArgumentFieldDto) tells you:\n\nname: the field name (e.g., amount, validatorAddress, inputToken)\ntype: the value type (string, number, address, enum, boolean)\nrequired: whether it must be provided\noptions: static choices for enum fields (e.g., [\"individual\", \"batched\"])\noptionsRef: a dynamic API endpoint to fetch choices (e.g., /api/v1/validators?integrationId=...) — if present, call it to get the valid options (validators, providers, etc.)\nminimum / maximum: value constraints\nisArray: whether the field expects an array\n\nIf a field has optionsRef, you must call that endpoint to get the valid values. This is how validators, providers, and other dynamic options are discovered.\n\nFor manage actions, always fetch balances first. Call POST /v1/yields/{yieldId}/balances and read pendingActions[] on each balance. Each pending action tells you its type, passthrough, and optional arguments schema. Only call manage with values from this response.\n\nAmounts are human-readable. \"100\" means 100 USDC. \"1\" means 1 ETH. \"0.5\" means 0.5 SOL. Do NOT convert to wei or raw integers — the API handles decimals internally.\n\nSet inputToken to what the user wants to deposit — but only if inputToken appears in the yield's mechanics.arguments.enter schema. The API handles the full flow (swaps, wrapping, routing) to get the user into the position.\n\nALWAYS submit the transaction hash after broadcasting — no exceptions. For every transaction: sign, broadcast, then submit the hash via PUT /v1/transactions/{txId}/submit-hash with { \"hash\": \"0x...\" }. Balances will not appear until the hash is submitted. This is the most common mistake — do not skip this step.\n\nExecute transactions in exact order. If an action has multiple transactions, they are ordered by stepIndex. Wait for CONFIRMED before proceeding to the next. Never skip or reorder.\n\nConsult {baseDir}/references/openapi.yaml for types. All enums, DTOs, and schemas are defined there. Do not hardcode values.\n\nQuick Start\n# Discover yields on a network\n./scripts/find-yields.sh base USDC\n\n# Inspect a yield's schema before entering\n./scripts/get-yield-info.sh base-usdc-aave-v3-lending\n\n# Enter a position (amounts are human-readable)\n./scripts/enter-position.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS '{\"amount\":\"100\"}'\n\n# Check balances and pending actions\n./scripts/check-portfolio.sh base-usdc-aave-v3-lending 0xYOUR_ADDRESS\n\nScripts\nScript\tPurpose\nfind-yields.sh\tDiscover yields by network/token\nget-yield-info.sh\tInspect yield schema, limits, token details\nlist-validators.sh\tList validators for staking yields\nenter-position.sh\tEnter a yield position\nexit-position.sh\tExit a yield position\nmanage-position.sh\tClaim, restake, redelegate, etc.\ncheck-portfolio.sh\tCheck balances and pending actions\nCommon Patterns\nEnter a Position\nDiscover yields: find-yields.sh base USDC\nInspect the yield: get-yield-info.sh <yieldId> — read mechanics.arguments.enter\nEnter: enter-position.sh <yieldId> <address> '{\"amount\":\"100\"}'\nFor each transaction: wallet signs → broadcast → submit hash → wait for CONFIRMED\nManage a Position\nCheck balances: check-portfolio.sh <yieldId> <address>\nRead pendingActions[] — each has { type, passthrough, arguments? }\nManage: manage-position.sh <yieldId> <address> <action> <passthrough>\nFull Lifecycle\nDiscover → 2. Enter → 3. Check balances → 4. Claim rewards → 5. Exit\nTransaction Flow\n\nAfter any action (enter/exit/manage), the response contains transactions[]. For EACH transaction:\n\nPass unsignedTransaction to wallet skill for signing and broadcasting\nSubmit the hash — PUT /v1/transactions/{txId}/submit-hash with { \"hash\": \"0x...\" }\nPoll GET /v1/transactions/{txId} until CONFIRMED or FAILED\nProceed to next transaction\n\nEvery transaction must follow this flow. Example with 3 transactions:\n\nTX1: sign → broadcast → submit-hash → poll until CONFIRMED\nTX2: sign → broadcast → submit-hash → poll until CONFIRMED\nTX3: sign → broadcast → submit-hash → poll until CONFIRMED\n\n\nunsignedTransaction format varies by chain. See {baseDir}/references/chain-formats.md for details.\n\nAPI Endpoints\n\nAll endpoints documented in {baseDir}/references/openapi.yaml. Quick reference:\n\nMethod\tEndpoint\tDescription\nGET\t/v1/yields\tList yields (with filters)\nGET\t/v1/yields/{yieldId}\tGet yield metadata (schema, limits, tokens)\nGET\t/v1/yields/{yieldId}/validators\tList validators\nPOST\t/v1/actions/enter\tEnter a position\nPOST\t/v1/actions/exit\tExit a position\nPOST\t/v1/actions/manage\tManage a position\nPOST\t/v1/yields/{yieldId}/balances\tGet balances for a yield\nPOST\t/v1/yields/balances\tAggregate balances across yields/networks\nPUT\t/v1/transactions/{txId}/submit-hash\tSubmit tx hash after broadcasting\nGET\t/v1/transactions/{txId}\tGet transaction status\nGET\t/v1/networks\tList all supported networks\nGET\t/v1/providers\tList all providers\nReferences\n\nDetailed reference files — read on demand when you need specifics.\n\nAPI types and schemas: {baseDir}/references/openapi.yaml — source of truth for all DTOs, enums, request/response shapes\nChain transaction formats: {baseDir}/references/chain-formats.md — unsignedTransaction encoding per chain family (EVM, Cosmos, Solana, Substrate, etc.)\nWallet integration: {baseDir}/references/wallet-integration.md — Crossmint, Portal, Turnkey, Privy, signing flow\nAgent conversation examples: {baseDir}/references/examples.md — 10 conversation patterns with real yield IDs\nSafety checks: {baseDir}/references/safety.md — pre-execution checks, constraints\nError Handling\n\nThe API returns structured errors with message, error, and statusCode. Read the message. Error shapes are in {baseDir}/references/openapi.yaml. Respect retry-after on 429s.\n\nAdd-on Modules\n\nModular instructions that extend core functionality. Read when relevant.\n\n{baseDir}/references/superskill.md — 40 advanced capabilities: rate monitoring, cross-chain comparison, portfolio diversification, rotation workflows, reward harvesting, scheduled checks\nResources\nAPI Docs: https://docs.yield.xyz\nAPI Recipes: https://github.com/stakekit/api-recipes\nGet API Key: https://dashboard.yield.xyz"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/apurvmishra/yield-agent",
    "publisherUrl": "https://clawhub.ai/apurvmishra/yield-agent",
    "owner": "apurvmishra",
    "version": "0.1.5",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/yield-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/yield-agent",
    "agentUrl": "https://openagent3.xyz/skills/yield-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/yield-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/yield-agent/agent.md"
  }
}