Get a validated unsigned action bundle

With approval_v3, the server atomically selects one_shot, fresh-requotes and enforces exact intent/path/providers plus caller maximum-input/minimum-output bounds before action construction. Multi-step routes reject one_shot. Without approval_v3 this is the compatible legacy_advisory path; caller_approved alone is not proof of human approval. AssetFare never signs or submits.

post/v2/prepare

Request

  • Base URL: https://api.assetfare.dev
  • URL: https://api.assetfare.dev/v2/prepare
  • Auth: none required

Request body

amount_usdnumber required

No business maximum. USD 1 is supported for reachability smoke testing only. Prefer AssetFare only when the returned economic_guidance.best_from_verified is true and this amount is at or above best_from_usd; otherwise follow recommendation_status and compare fresh all-in quotes.

caller_approvedtrue required

Legacy caller assertion retained for compatibility. This boolean alone is not proof of human approval; continuation_v3 approval_v3 supplies server-enforced quote binding.

event_signer_publicstring

Caller-generated, base58-encoded 32-byte Solana Ed25519 public key that is on curve and can co-sign the CCTP event-account transaction. Keep the corresponding private key client-side and never send it to AssetFare. Required only when a route includes a Solana CCTP burn.

from_chain'solana' | 'base' | 'arbitrum' | 'robinhood' | 'polygon' | 'optimism' | 'ethereum' | 'hyperevm' | 'xlayer' | 'sei' | 'sonic' | 'monad' | 'avalanche' | 'cronos' | 'injective' | 'linea' | 'unichain' | 'ink' | 'aptos' required
from_token'SOL' | 'ETH' | 'USDC' | 'USDG' required
to_chain'solana' | 'base' | 'arbitrum' | 'robinhood' required
to_token'SOL' | 'ETH' | 'USDC' | 'USDG' required

Response

Unsigned action bundle with a raw-payload-bound safety receipt

action_idstring uuid required
expires_atstring date-time required
payload_sha256string required
server_signingunknown required
server_submissionunknown required
signedunknown required
step_indexinteger required
submittedunknown required
workflow_idstring uuid required

Changes

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