Skip to main content

​
Basic ranking

defi yield opportunities --chain 1 --asset USDC --limit 20 --results-only

​
Select providers explicitly

defi yield opportunities --chain 1 --asset USDC --providers aave,morpho --limit 20 --results-only
defi yield opportunities --chain solana --asset USDC --providers kamino --limit 20 --results-only
--providers expects provider names from defi providers list.

​
Filter with objective metrics

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

​
Key opportunity fields

  • apy_total: total APY percentage points (2.3 means 2.3%).
  • tvl_usd: total supplied/managed USD reported by the provider.
  • liquidity_usd: currently available withdrawable/borrowable USD from the provider.
  • backing_assets: full backing composition list with per-asset share_pct.

​
Incomplete opportunities

defi yield opportunities --chain 1 --asset USDC --include-incomplete --results-only
When enabled, warnings may indicate missing APY/TVL and combined-provider counts.

​
Historical series

defi yield history --chain 1 --asset USDC --providers aave,morpho --metrics apy_total --interval day --window 7d --limit 1 --results-only
defi yield history --chain 1 --asset USDC --providers morpho --metrics apy_total,tvl_usd --interval day --window 30d --limit 1 --results-only
defi yield history --chain solana --asset USDC --providers kamino --metrics apy_total,tvl_usd --interval day --window 7d --limit 1 --results-only
Optional time filters: 
defi yield history --chain 1 --asset USDC --providers aave --metrics apy_total --from 2026-02-20T00:00:00Z --to 2026-02-26T00:00:00Z --interval hour --limit 1 --results-only

​
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
Supported providers: aave, morpho, moonwell.

​
Execution (deposit, withdraw)

defi yield deposit plan --provider aave --chain 1 --asset USDC --amount 1000000 --wallet agent-treasury --results-only
export DEFI_OWS_TOKEN=...
defi yield deposit submit --action-id <action_id> --results-only
Morpho yield execution requires --vault-address: 
defi yield deposit plan --provider morpho --chain 1 --asset USDC --vault-address 0xVault --amount 1000000 --wallet agent-treasury --results-only
yield and lend are split by intent: yield for passive deposits/withdrawals, lend for loan lifecycle (supply|withdraw|borrow|repay). Plan with --wallet (OWS) or --from-address (local signer). See Execution & Signing for submit auth details.

​
Important caveats

  • APY values are percentage points (2.3 = 2.3%).
  • Morpho may produce extreme APY for very small markets; use --min-tvl-usd.
  • Kamino yield routes currently support Solana mainnet only (read only, no execution).
  • Moonwell yield routes are supported on Base and Optimism; Moonwell does not support --on-behalf-of.
  • yield opportunities no longer includes subjective risk/score fields.
  • yield history --metrics supports apy_total and tvl_usd; Aave currently supports apy_total only.
  • Aave history is lookback-window based and effectively ends near current time.
  • action_policy_error can indicate an OWS policy denial on wallet-backed submit.