Bridge

Get a Swap or Bridge Quote

Get a live quote for swapping or bridging tokens without executing anything. Specify the exact input amount (exact='input') or the exact output amount (exact='output') and the other side is returned, along with the route steps. The quote is indicative and subject to change; use /v1/bridge/swap to execute.

Maps to /v1/bridge/swap as: originChainId/originTokenAddress = tokenIn, destinationChainId/destinationTokenAddress = tokenOut.

Authentication: Pass x-client-id header for frontend usage from allowlisted origins or x-secret-key for backend usage.

get/v1/bridge/quote

Query parameters

exact'input' | 'output'

Whether amount is the exact input amount (sell) or the exact output amount (buy).

Whether amount is the exact input amount (sell) or the exact output amount (buy).

originChainIdinteger required

Chain ID of the input token.

Example:1

Chain ID of the input token.

originTokenAddressstring required

Input token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for the native token).

Input token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for the native token).

destinationChainIdinteger required

Chain ID of the output token.

Example:1

Chain ID of the output token.

destinationTokenAddressstring required

Output token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for the native token).

Output token address (use 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for the native token).

amountstring required

Amount in wei. The input amount when exact='input', the output amount when exact='output'.

Amount in wei. The input amount when exact='input', the output amount when exact='output'.

Response

Quote for the requested swap or bridge.

Example response

{
  "result": {
    "originAmount": "1000000",
    "destinationAmount": "1003745",
    "blockNumber": "496935617",
    "timestamp": 1787334467125,
    "estimatedExecutionTimeMs": 0,
    "steps": [],
    "intent": {
      "originChainId": 42161,
      "originTokenAddress": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "destinationChainId": 42161,
      "destinationTokenAddress": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
      "amount": "1000000",
      "maxSteps": 1
    }
  }
}

Changes