Get The Best Route

post

https://api.rango.exchange/routing/best

It goes through all the possible DEX & bridges to find the best possible route based on user experience, fee amount, and output of swap.

Body Params

from

object

required

object

required

amount

string

required

The human-readable amount of asset X that is going to be swapped

connectedWallets

array of objects

The list of all connected wallets of user in all blockchains

connectedWallets

selectedWallets

object

The list of user's selected wallets to doing the swapping operation. (Blockchain to Wallet address map)

destination

string

The address of custom destination wallet, in case that you want to just swap in a blockchain because selected wallets can not support this scenario

checkPrerequisites

boolean

Defaults to false

This field should be false when the client wants to preview the route to the user and true when the user accepts the swap. If true, the server will be much slower to respond but will check some prerequisites, including the balance of X and any required fees in the user's wallets.

affiliateRef

string

The affiliate ref, which the client likes to send to Rango, so in cases of 1inch, Thorchain, etc., that support affiliation, the client will earn some money if the user accepts the route and signs the transaction.

affiliateWallets

object

List of affiliate wallets per blockchain for referral rewards

affiliatePercent

double

≤ 10

Affiliate reward for affiliator in percent (1.0 = %1.0), must be less than 1.0 percent

transactionTypes

array of strings

This field is the list of all accepted transaction types. (including EVM, TRANSFER, COSMOS, and SOLANA). An empty list means no filter is required.

transactionTypes

swappers

array of strings

The list of all accepted swappers. An empty list means no filter is required

swappers

swappersExclude

boolean

Defines the provided swappers as the include/exclude list. Default is false (include)

swapperGroups

array of strings

The list of all included/excluded swappers based on tag, empty list means no filter is required

swapperGroups

swappersGroupsExclude

boolean

Defines the provided swappers' tags as the include/exclude list. Default is false (include)

blockchains

array of strings

The list of all accepted blockchains. An empty list means no filter is required

blockchains

blockchainsExclude

boolean

Defines the provided blockchains as the include/exclude list. Default is false (include)

disableMultiStepTx

boolean

It should be true when client don't want multi step transactions. default is true

maxLength

int32

Maximum acceptable length of path

interChainMessage

object

Info about intrachain message (Source & Destination contracts and IM Message) for cross-chain messaging

messagingProtocols

array of strings

List of messaging protocols to be used for passing intrachain message

messagingProtocols

contractCall

boolean

set this parameter to true if you wants to send transactions through a contract

slippage

number

0.01 to 30

Amount of user's preferred slippage in percent

enableCentralizedSwappers

boolean

Specify that centralized swappers must be included in swappers or not. Default is false (exclude)

avoidNativeFee

boolean

When it is true, Swappers that have native tokens as fee must be excluded. example: when you call it from AA account.

Headers

X-Rango-Id

string

Responses

400

Bad client request

403

Forbidden

429

Too many requests

500

Internal error

200OK

404Not Found