Get Best Routes

post

https://public-api.rango.exchange/routing/bests

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

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Multiple route request's body

from

object

required

The asset Y that user wants to swap X into that

object

required

The asset Y that user wants to swap X into that

amount

number

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

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 objects

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, Use 1 for single step swaps

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

Allowed:

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.

gasLessTransaction

boolean

routingPreferences

object

Route preferences for more control by user

isRefuel

boolean

When it is true, that means the user used the refuel feature.

Headers

X-Rango-Id

string

Responses

400

Bad client request

403

Forbidden

429

Too many requests

500

Internal error

200OK

404Not Found