Sign in
Synapse Bridge REST API

Get swap quote for arbitrary tokens on a specific chain

Retrieve detailed swap quote exchanging any token for any other on a specified chain. Note that amounts are expressed in token's native decimals, not in human-readable format.

get/swap/v2

Query parameters

chainIdinteger required

The chain ID where the swap will occur

fromTokenstring required

The address of the token to swap from

fromAmountstring required

The amount of tokens to swap in the token's native decimals

toTokenstring required

The address of the token to swap to

toRecipientstring

Optional. The address that will receive the swapped tokens. If provided, returns transaction data.

slippagenumber

Optional. The maximum allowed slippage percentage (0-100). Defaults to 0.5%.

Response

Successful response

idstring

Unique identifier for the quote

chainIdinteger

The chain ID where the swap occurs

fromTokenstring

The address of the token being swapped from

fromAmountstring

The amount of tokens to swap in the token's native decimals

toTokenstring

The address of the token being swapped to

expectedToAmountstring

The expected amount of tokens that will be received in the token's native decimals

minToAmountstring

The minimum amount of tokens that will be received in the token's native decimals (includes slippage)

routerAddressstring

The address of the router contract

moduleNamesstring[]

The names of the swap modules used for this quote

Changes