tools

Request vault deposit

Use this when the user asks to deposit USDC or USDT from one of their own wallets into a vault they chose from Investing. Request a dollar-stablecoin deposit from one of the household's tracked EVM wallets into an Upshift or Morpho vault listed by betteroff_get_vault_yields. Saves a request for the user to review; never approves, signs, or deposits. Only prepare a deposit the user asked for, into a vault the user named; never pick a vault for them. Return the review link and say it awaits the user's approval and wallet signature.

post/v1/tools/betteroff_request_vault_deposit

Request

  • Base URL: https://api.betteroff.finance
  • URL: https://api.betteroff.finance/v1/tools/betteroff_request_vault_deposit
  • Auth: one of:
    • OpenID Connect (https://app.betteroff.finance/api/auth/.well-known/openid-configuration, scopes: investments:read, transfers:vault)
    • HTTP bearer

Request body

vaultstring required

Vault address from betteroff_get_vault_yields.

chainIdinteger

The vault's chainId from betteroff_get_vault_yields; needed when an address is listed on two chains.

fromWalletstring required

Household wallet that holds the vault's deposit asset.

amountUsdstring required

Dollar amount as a decimal string, at most 6 decimals.

idempotencyKeystring

Required for outside agents. Reuse the same key when retrying the same request; use a new key for a new one.

Response

Tool result

OR

Changes

No recorded changes to this operation across all 1 revision of this API.