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
- 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
- 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
| Protocol | What runs | Page |
|---|---|---|
| Aave | Supply and withdraw on many chains; borrow and repay (beta) | Aave |
| Morpho | Vault deposits and withdrawals on Base and Robinhood Chain | Morpho |
| Curve | Deposits and withdrawals in the Base 4pool; pool discovery elsewhere | Curve |
| Vaults.fyi | Vault discovery and deposits across many chains (beta) | Vaults.fyi |
| Yield.xyz | Lending, vaults and staking, with reward claims (beta) | Yield.xyz |
| Uniswap | Liquidity positions, with their own actions | Uniswap |
Solana earn (Jupiter Lend, Kamino, Meteora, SOL staking) is on the Solana page.
For developers
Catalog provider: earn
| Action | Kind | Params |
|---|---|---|
get_earning_opportunities | read | Optional 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_provider | read | providerId. Chains, capabilities and what is not enabled |
get_earn_position | read | providerId, optional opportunityId, chainId, vaultAddress, walletAddress |
deposit_earn_position | write | amount (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_position | write | providerId, opportunityId or vaultAddress, and one of amount, assetsRaw, sharesRaw, amountRaw |
claim_earn_rewards | write | Yield.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.
Related
- Chains
- Private agents: add
private: trueto a deposit or withdrawal