Earn

Find vaults, lending markets and pools across protocols and enter or exit them from your agent's wallet, with one set of actions.

Your agent can put idle funds to work: lend them, deposit them into vaults, or provide liquidity. Earn is one set of actions for all of these. The agent finds opportunities across protocols, deposits, reads its position and withdraws, the same way whichever protocol is behind it.

Category: Earn ยท Protocol page: thirdfy.com/protocols/earn

Find an opportunity

Using Thirdfy, find USDC earn opportunities on Base I can deposit into, highest APR first.
Using Thirdfy, show Morpho vaults on Base with at least $1M deposited.
  • The agent filters by chain, token, protocol, minimum TVL and minimum APR, and sorts by score, APR or TVL.
  • The answer separates the opportunities the agent can deposit into from those it can only read. A vault that is full can't take deposits but can still be withdrawn from.
  • Rates move. An APR is what the protocol pays now, not a promise.
  • Opportunities marked experimental or high risk carry a risk notice. Every Vaults.fyi and Yield.xyz row is marked experimental.

Deposit and withdraw

Using Thirdfy, deposit 25 USDC into that vault.
Using Thirdfy, show my earn positions on Base.
Using Thirdfy, withdraw 10 USDC from my Aave USDC position on Base.
  • The funds stay with the agent. Deposits are made for the agent's own wallet, and withdrawals come back to it. On a wallet you control with your own signed policy, a withdrawal can only go to the agent, your wallet or your payout address.
  • Gas. Thirdfy pays the gas for deposits and withdrawals on Base, Optimism, Gnosis, Polygon, Arbitrum and Robinhood Chain, and for withdrawals on Ethereum too. Elsewhere the wallet pays.
  • Approvals. When a token needs approving first, the agent sends the approval, waits until it lands, then deposits. If the deposit then fails, it is retried once, and only when it surely didn't run.
  • Your limits apply. Each deposit counts against the agent's per-action and daily limits, and must be allowed in its mandate.
  • Earn doesn't harvest, compound or rebalance for you.

Protocols

ProtocolWhat runsPage
AaveSupply and withdraw on many chains; borrow and repay (beta)Aave
MorphoVault deposits and withdrawals on Base and Robinhood ChainMorpho
CurveDeposits and withdrawals in the Base 4pool; pool discovery elsewhereCurve
Vaults.fyiVault discovery and deposits across many chains (beta)Vaults.fyi
Yield.xyzLending, vaults and staking, with reward claims (beta)Yield.xyz
UniswapLiquidity positions, with their own actionsUniswap

Solana earn (Jupiter Lend, Kamino, Meteora, SOL staking) is on the Solana page.

For developers

Catalog provider: earn

ActionKindParams
get_earning_opportunitiesreadOptional providerId, opportunityId, chainId, asset, strategyType, minTvlUsd, minApr, executionSupport (read or write), limit (up to 100), sortBy (score, apr, tvl), responseFormat (concise, detailed). Returns opportunities and writableOpportunities
get_earn_providerreadproviderId. Chains, capabilities and what is not enabled
get_earn_positionreadproviderId, optional opportunityId, chainId, vaultAddress, walletAddress
deposit_earn_positionwriteamount (whole tokens, for example "25"), providerId and opportunityId or vaultAddress; Aave, Morpho and Curve also take tokenAddress. Optional receiver (default: the agent wallet), private
withdraw_earn_positionwriteproviderId, opportunityId or vaultAddress, and one of amount, assetsRaw, sharesRaw, amountRaw
claim_earn_rewardswriteYield.xyz rewards only: providerId: "yield-xyz", opportunityId

get_earn_opportunities is an alias of get_earning_opportunities. A provider without a position reader answers positionAvailable: false. With a wallet that only prepares transactions, deposits and withdrawals return unsigned transactions to sign yourself.

MCP
CLI
walletExecute { action: "get_earning_opportunities", chainId: 8453, runMode: "agent_wallet",
  params: { asset: "USDC", executionSupport: "write", sortBy: "apr", limit: 10 } }