The swap page reads query parameters on load, so you can send users a URL that lands on a live quote instead of an empty form. Nothing is submitted on their behalf: the link prefills the form, and the user still connects a wallet and confirms the deposit.

​
Parameters

All parameters are optional and independent: a link can set just the pair, just the destination side, or everything at once.

​
Token identification

A fromToken or toToken value that looks like an address is matched against the token catalog first; an address outside the catalog is resolved live from the chain, the same way a pasted address is in the token picker. Any other value is treated as a symbol and matched case-insensitively against the catalog for that chain. Symbols are unique per chain, so a symbol link is unambiguous, but only catalog tokens resolve this way; long-tail tokens need the address form. Token parameters require their chain parameter: fromToken without a resolvable fromChain is ignored, and the same holds for the destination side.

​
Validation

Invalid input never breaks the page. Each parameter that fails validation is dropped and its field falls back to the default:
  • A chain that is unknown, not configured, or currently closed for quoting drops both parameters for that side.
  • A token that resolves to nothing is dropped.
  • A non-numeric or non-positive amount, an unknown tradeType, or a toAddress that does not match the destination chain’s address format is dropped.
Parameters apply on initial page load only. The URL does not track later edits, so a shared link always reflects what the sender put in it, not what the recipient did afterwards.

​
Examples

Prefill a USDC transfer from Base to Solana by symbol:
The same pair by address, with the source chain given as an EVM chain id and a fixed recipient:
Ask for an exact amount out instead of an exact amount in: