Lending, Yield, and Rewards Commands

Full reference for lend, yield, and rewards command flags and examples.

lend markets

defi lend markets --provider aave --chain 1 --asset USDC --limit 20 --results-only
defi lend markets --provider kamino --chain solana --asset USDC --limit 20 --results-only

Flags:

• --provider string (aave, morpho, kamino, moonwell) required
• --chain string required
• --asset string required
• --limit int (default 20)

lend rates

defi lend rates --provider morpho --chain 1 --asset USDC --limit 20 --results-only
defi lend rates --provider kamino --chain solana --asset USDC --limit 20 --results-only

Flags are the same as lend markets.

lend positions

defi lend positions --provider aave --chain 1 --address 0xYourEOA --type all --limit 20 --results-only
defi lend positions --provider morpho --chain 1 --address 0xYourEOA --type borrow --asset USDC --results-only

Flags:

• --provider string (aave, morpho, moonwell) required
• --chain string required
• --address string required
• --asset string optional filter (symbol/address/CAIP-19)
• --type string (all|supply|borrow|collateral, default all)
• --limit int (default 20)

yield opportunities

defi yield opportunities \
  --chain 1 \
  --asset USDC \
  --providers aave,morpho \
  --min-tvl-usd 1000000 \
  --sort liquidity_usd \
  --limit 20 \
  --results-only

Flags:

• --chain string required
• --asset string required
• --limit int (default 20)
• --min-tvl-usd float (default 0)
• --min-apy float (default 0)
• --providers string (aave,morpho,kamino,moonwell)
• --sort string (apy_total|tvl_usd|liquidity_usd, default apy_total)
• --include-incomplete bool (default false)

Output notes:

• backing_assets includes the full reported backing composition for each opportunity.
• tvl_usd and liquidity_usd are provider-sourced objective metrics (not inferred risk labels).

yield positions

defi yield positions --chain 1 --address 0xYourEOA --providers aave,morpho --limit 20 --results-only
defi yield positions --chain 1 --address 0xYourEOA --providers morpho --asset USDC --results-only

Flags:

• --chain string required
• --address string required
• --asset string optional filter (symbol/address/CAIP-19)
• --providers string (aave,morpho,kamino,moonwell)
• --limit int (default 20)
• --rpc-url string optional provider RPC override (only used by providers that need on-chain valuation)

yield history

defi yield history \
  --chain 1 \
  --asset USDC \
  --providers aave,morpho \
  --metrics apy_total,tvl_usd \
  --interval day \
  --window 7d \
  --limit 1 \
  --results-only

Flags:

• --chain string required
• --asset string required
• --providers string (aave,morpho,kamino,moonwell)
• --metrics string (apy_total,tvl_usd, default apy_total)
• --interval string (hour|day, default day)
• --window string lookback duration (for example 24h, 7d, 30d)
• --from string optional RFC3339 start time (--window is ignored when set)
• --to string optional RFC3339 end time (default now)
• --opportunity-ids string optional CSV filter from yield opportunities
• --limit int max opportunities per provider (default 20)

yield deposit|withdraw plan|submit|status

defi yield deposit plan --provider aave --chain 1 --asset USDC --amount 1000000 --wallet agent-treasury --results-only
defi yield deposit plan --provider morpho --chain 1 --asset USDC --vault-address 0xVault --amount 1000000 --wallet agent-treasury --results-only
defi yield deposit submit --action-id <action_id> --results-only

Flags (plan):

• --provider string (aave|morpho|moonwell) required
• --chain string required
• --asset string required
• --amount string or --amount-decimal string required
• --wallet string recommended primary identity input
• --from-address string local signer identity input
• --vault-address string required for --provider morpho
• --recipient string optional (defaults to sender)
• --on-behalf-of string optional (defaults to sender)
• --rpc-url string optional
• --pool-address string / --pool-address-provider string optional Aave overrides
• planning controls: --simulate
• structured input: --input-json string or --input-file string (- reads stdin)

Flags (submit):

• --action-id string required
• --input-json string optional structured payload
• --input-file string optional structured payload file or - for stdin
• wallet-backed submit uses persisted wallet_id plus DEFI_OWS_TOKEN
• local signer flags apply to actions planned with --from-address
• submit also supports sender guard / simulation / gas / policy override flags (--from-address, gas/fee flags, --allow-max-approval, --unsafe-provider-tx)
• explicit flags override structured input values

Flags (status):

• --action-id string required

lend ... plan|submit, yield ... plan|submit, and rewards ... plan|submit follow the same structured-input pattern. For rewards structured input, assets accepts a JSON string array while the CLI flag remains comma-separated.

lend supply|withdraw|borrow|repay plan|submit|status

defi lend supply plan --provider aave --chain 1 --asset USDC --amount 1000000 --wallet agent-treasury --results-only
defi lend supply plan --provider morpho --chain 1 --asset USDC --market-id 0x... --amount 1000000 --wallet agent-treasury --results-only
defi lend supply submit --action-id <action_id> --results-only

Execution providers: aave|morpho|moonwell. Morpho requires --market-id. Moonwell uses --pool-address for explicit mToken or auto-resolves by underlying asset. plan and submit accept --input-json / --input-file.

Standard EVM lending execution is wallet-first:

• Use --wallet on plan for the primary path.
• Plan with --wallet (OWS, recommended) or --from-address (local signer). See Execution & Signing.
• Wallet-backed submit uses the persisted wallet_id and DEFI_OWS_TOKEN.

rewards claim|compound plan|submit|status

defi rewards claim plan --provider aave --chain 1 --wallet agent-treasury --assets 0xAsset1,0xAsset2 --reward-token 0xReward --results-only
defi rewards claim submit --action-id <action_id> --results-only

Execution provider: aave. --assets expects comma-separated on-chain addresses (structured input accepts a JSON string array). plan and submit accept --input-json / --input-file.

Plan with --wallet (OWS, recommended) or --from-address (local signer). See Execution & Signing. Wallet-backed submit uses DEFI_OWS_TOKEN.

Provider-selection note

--providers accepts provider names, not protocol categories.

Routing note

lend and yield routes are direct-provider only (aave, morpho, kamino, moonwell). yield and lend intentionally represent different user intents:

• yield: passive deposit/withdraw flows (Morpho vaults, Aave reserve-yield alias)
• lend: loan lifecycle operations (supply|withdraw|borrow|repay; Morpho Blue uses --market-id)