Sign in

v8

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-01124480.3 KB
Advanced

Discover advanced route plans

Returns ranked route plans with explicit steps. These routes are estimates; call /v1/advanced/stepTransaction for each selected step to get live executable transaction data.

post/v1/advanced/routes

Headers

x-api-keystring

Optional API key for higher rate limits and fee rules.

Request body

senderAddressstring required

Sender wallet address on the origin chain.

receiverAddressstring

Receiver wallet address. Defaults to senderAddress for same chain-type routes (EVM -> EVM or SVM -> SVM) and is required when crossing chain types (EVM -> SVM or SVM -> EVM).

originChainIdnumber required

Origin chain ID.

destinationChainIdnumber required

Destination chain ID.

amountstring required

Exact input amount in token base units as a positive integer string, before Delora and integrator fees.

originCurrencystring required

Origin token address, or native asset marker supported by the backend.

destinationCurrencystring required

Destination token address, or native asset marker supported by the backend.

integratorstring

Integrator identifier used for fee attribution. Required when fee is provided.

feenumber

Optional integrator fee fraction taken from the input amount. 0.01 means 1%. Must be between 0 and 0.1 inclusive and can be provided only with integrator.

slippagenumber

Optional slippage fraction. 0.005 means 0.5%.

includeBridgesstring

Comma-separated bridge adapter keys from /v1/tools to include. Only bridge-capable or multi-capability adapters are valid.

includeExchangesstring

Comma-separated exchange adapter keys from /v1/tools to include. Only exchange-capable or multi-capability adapters are valid.

excludeBridgesstring

Comma-separated bridge adapter keys from /v1/tools to exclude. Only bridge-capable or multi-capability adapters are valid.

excludeExchangesstring

Comma-separated exchange adapter keys from /v1/tools to exclude. Only exchange-capable or multi-capability adapters are valid.

maxRoutesnumber

Maximum number of ranked advanced routes to return.

Example request

{
  "senderAddress": "0x1111111111111111111111111111111111111111",
  "receiverAddress": "0x2222222222222222222222222222222222222222",
  "originChainId": 8453,
  "destinationChainId": 42161,
  "amount": "1000000",
  "originCurrency": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "destinationCurrency": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
  "integrator": "partner-app",
  "fee": 0.01,
  "slippage": 0.005,
  "includeBridges": "RELAY,ACROSS",
  "includeExchanges": "OPENOCEAN,OKX",
  "excludeBridges": "MAYAN_FAST_MCTP",
  "excludeExchanges": "OKX",
  "maxRoutes": 2
}

Response

Ranked advanced route plans.