tools

Request transfer

Use this when the user asks to move USDC between two of their own tracked wallets on Solana. Request a USDC transfer on Solana between two wallets this household tracks. Saves a request for the user to review; never approves, signs, or sends. Return the review link and say it awaits the user's approval and wallet signature.

post/v1/tools/betteroff_request_transfer

Request

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

Request body

chain'solana' | 'base' required

Use solana. Base transfer requests are paused.

fromWalletstring required

Source wallet address tracked by this household.

toWalletstring required

Destination wallet address tracked by this household.

amountUsdcstring required

USDC 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.