DeFi Yield Strategies

Discover yield opportunities across DeFi protocols (Aave, Compound, and others), deposit tokens to earn yield, and withdraw when ready. This is a full lifecycle skill covering discovery through to exit.

Confirm wallet is authenticated

fdx status

If the wallet is not authenticated, refer to the authenticate skill.

Step 1: Discover Yield Strategies

Search for available yield opportunities:

# Browse all available strategies
fdx call discoverYieldStrategies

# Filter by chain
fdx call discoverYieldStrategies --chainKey ethereum

# Filter by token
fdx call discoverYieldStrategies --chainKey ethereum --tokenAddress 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48

# Filter by minimum APY and risk level
fdx call discoverYieldStrategies --chainKey ethereum --minApy 5 --maxRisk low

# Sort results
fdx call discoverYieldStrategies --chainKey ethereum --sortBy apy

discoverYieldStrategies Parameters

Parameter	Required	Description
--chainKey	No	Filter by blockchain (e.g. ethereum, polygon, arbitrum, base)
--tokenAddress	No	Filter by token contract address
--minApy	No	Minimum APY percentage (e.g. 5 for 5%)
--maxRisk	No	Maximum risk level filter (e.g. low, medium, high)
--sortBy	No	Sort results (e.g. apy, risk)

Step 2: Deposit for Yield

Once a strategy is selected, deposit tokens into it:

fdx call depositForYield \
  --chainKey <chain> \
  --strategyId <strategyId> \
  --amount <amount>

depositForYield Parameters

Parameter	Required	Description
--chainKey	Yes	Blockchain where the strategy runs
--strategyId	Yes	Strategy identifier from discoverYieldStrategies results
--amount	Yes	Amount to deposit (human-readable)
--tokenAddress	No	Token to deposit (if strategy accepts multiple tokens)

Step 3: Withdraw from Yield

Exit a position and retrieve tokens:

fdx call withdrawFromYield \
  --chainKey <chain> \
  --positionId <positionId>

withdrawFromYield Parameters

Parameter	Required	Description
--chainKey	Yes	Blockchain of the position
--positionId	Yes	Position identifier from the deposit result
--amount	No	Amount to withdraw (omit for full withdrawal)
--recipient	No	Custom recipient address (defaults to own wallet)

Example Session

# Check auth and balance
fdx status
fdx call getWalletOverview --chainKey ethereum

# Discover USDC yield strategies on Ethereum with at least 3% APY
fdx call discoverYieldStrategies \
  --chainKey ethereum \
  --tokenAddress 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 \
  --minApy 3 \
  --sortBy apy

# Deposit 1000 USDC into a chosen strategy
fdx call depositForYield \
  --chainKey ethereum \
  --strategyId <strategyId-from-discovery> \
  --amount 1000

# Later: withdraw the full position
fdx call withdrawFromYield \
  --chainKey ethereum \
  --positionId <positionId-from-deposit>

Flow

1. Check authentication with fdx status
2. Check available balance with fdx call getWalletOverview --chainKey <chain>
3. Discover strategies with fdx call discoverYieldStrategies — present options to the human
4. Human selects a strategy — confirm the choice, risks, and deposit amount
5. Execute deposit with fdx call depositForYield
6. When the human wants to exit, withdraw with fdx call withdrawFromYield

Important: DeFi protocols carry smart contract risk. Always present the risk level to your human and let them make the final decision on which strategy to use and how much to deposit.

Prerequisites

• Must be authenticated (fdx status to check, see authenticate skill)
• Wallet must hold sufficient balance of the deposit token on the target chain
• If insufficient funds, suggest using the fund-wallet skill or swap-tokens skill to acquire the needed token

Error Handling

• "Not authenticated" — Run fdx setup first, or see authenticate skill
• "Insufficient balance" — Check balance; see fund-wallet skill
• "Invalid strategyId" — Re-run discoverYieldStrategies to get current strategy IDs
• "Invalid positionId" — The position may have already been withdrawn