A bundle is a sequence of steps that settle as one intent. Use bundles when the user-facing action requires more than one swap or bridge.
Example: bridge + LP deposit
USDC on Arbitrum → 50/50 USDC/WETH LP position on Base.
When bundles beat raw quotes
Bundle vs separate calls
Calling Core endpoints separately (swap, then bridge, then deposit) requires multiple user signatures and creates intermediate state the user can lose. A bundle:
- Is one signature for the user.
- Cannot be partially executed (in the user’s favor — funds either complete the journey or refund).
- Optimizes routing across the entire path, not step-by-step.
API
See the Bundle API reference for the full request/response shape. Last modified on May 4, 2026