curl --request POST \
--url https://api-v2.rubic.exchange/api/routes/quoteBest \
--header 'Content-Type: application/json' \
--data '
{
"dstTokenAddress": "0x0000000000000000000000000000000000000000",
"dstTokenBlockchain": "POLYGON",
"referrer": "rubic.exchange",
"srcTokenAddress": "0x0000000000000000000000000000000000000000",
"srcTokenAmount": "1.05",
"srcTokenBlockchain": "ETH"
}
'{
"id": "<string>",
"tokens": {
"from": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"amount": "0.00123",
"price": "1.35"
},
"to": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
},
"swapType": {},
"providerType": {},
"estimate": {
"destinationTokenAmount": "1.05",
"destinationTokenMinAmount": "1.02",
"destinationWeiAmount": "105000000000000000",
"destinationWeiMinAmount": "102000000000000000",
"durationInMinutes": "5",
"slippage": "5",
"priceImpact": "3",
"intermidiateTokenWeiAmount": "105000000000000000",
"destinationUsdAmount": "25.31",
"destinationUsdMinAmount": "25.31"
},
"fees": {
"gasTokenFees": {
"gas": {
"gasPrice": "1000000000000000000",
"baseFee": "1000000000000000000",
"maxFeePerGas": "1000000000000000000",
"maxPriorityFeePerGas": "1000000000000000000",
"gasLimit": "1000000000000000",
"totalWeiAmount": "5020000000000000",
"totalUsdAmount": "15.31"
},
"protocol": {
"fixedAmount": "0.00013",
"fixedWeiAmount": "130000000000000",
"fixedUsdAmount": "1.53"
},
"provider": {
"fixedAmount": "0.00013",
"fixedWeiAmount": "130000000000000",
"fixedUsdAmount": "1.53"
},
"nativeToken": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
},
"percentFees": {
"percent": 123,
"token": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
}
},
"routing": [
{
"type": {},
"provider": "<string>",
"path": [
{
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"amount": "0.00123",
"price": "1.35"
}
]
}
],
"transaction": {
"approvalAddress": "<string>",
"permit2Address": "<string>",
"data": "<string>",
"to": "<string>",
"value": "<string>",
"depositAddress": "<string>",
"amountToSend": "<string>",
"extraFields": {},
"exchangeId": "<string>",
"tonMessages": [
{
"address": "<string>",
"amount": "<string>",
"payload": "<string>",
"stateInit": "<string>"
}
],
"psbt": "<string>",
"signInputs": [
123
],
"feeLimit": 123,
"callValue": "<string>",
"signature": "<string>",
"arguments": [
"<string>"
],
"rawParameter": "<string>",
"transaction": "<string>"
},
"warnings": [
{}
],
"useRubicContract": true,
"private": true
}Request quote
Get best quote
Using this endpoint, you can get the best available route for a cross-chain or on-chain swap. The router goes through all supported DEXes, bridges, and aggregators to find and return the route with the highest expected swap output.
POST
/
api
/
routes
/
quoteBest
curl --request POST \
--url https://api-v2.rubic.exchange/api/routes/quoteBest \
--header 'Content-Type: application/json' \
--data '
{
"dstTokenAddress": "0x0000000000000000000000000000000000000000",
"dstTokenBlockchain": "POLYGON",
"referrer": "rubic.exchange",
"srcTokenAddress": "0x0000000000000000000000000000000000000000",
"srcTokenAmount": "1.05",
"srcTokenBlockchain": "ETH"
}
'{
"id": "<string>",
"tokens": {
"from": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"amount": "0.00123",
"price": "1.35"
},
"to": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
},
"swapType": {},
"providerType": {},
"estimate": {
"destinationTokenAmount": "1.05",
"destinationTokenMinAmount": "1.02",
"destinationWeiAmount": "105000000000000000",
"destinationWeiMinAmount": "102000000000000000",
"durationInMinutes": "5",
"slippage": "5",
"priceImpact": "3",
"intermidiateTokenWeiAmount": "105000000000000000",
"destinationUsdAmount": "25.31",
"destinationUsdMinAmount": "25.31"
},
"fees": {
"gasTokenFees": {
"gas": {
"gasPrice": "1000000000000000000",
"baseFee": "1000000000000000000",
"maxFeePerGas": "1000000000000000000",
"maxPriorityFeePerGas": "1000000000000000000",
"gasLimit": "1000000000000000",
"totalWeiAmount": "5020000000000000",
"totalUsdAmount": "15.31"
},
"protocol": {
"fixedAmount": "0.00013",
"fixedWeiAmount": "130000000000000",
"fixedUsdAmount": "1.53"
},
"provider": {
"fixedAmount": "0.00013",
"fixedWeiAmount": "130000000000000",
"fixedUsdAmount": "1.53"
},
"nativeToken": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
},
"percentFees": {
"percent": 123,
"token": {
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"price": "1.35"
}
}
},
"routing": [
{
"type": {},
"provider": "<string>",
"path": [
{
"address": "0x0000000000000000000000000000000000000000",
"decimals": 18,
"symbol": "ETH",
"name": "Ethereum",
"blockchainId": "1",
"blockchain": "ETH",
"amount": "0.00123",
"price": "1.35"
}
]
}
],
"transaction": {
"approvalAddress": "<string>",
"permit2Address": "<string>",
"data": "<string>",
"to": "<string>",
"value": "<string>",
"depositAddress": "<string>",
"amountToSend": "<string>",
"extraFields": {},
"exchangeId": "<string>",
"tonMessages": [
{
"address": "<string>",
"amount": "<string>",
"payload": "<string>",
"stateInit": "<string>"
}
],
"psbt": "<string>",
"signInputs": [
123
],
"feeLimit": 123,
"callValue": "<string>",
"signature": "<string>",
"arguments": [
"<string>"
],
"rawParameter": "<string>",
"transaction": "<string>"
},
"warnings": [
{}
],
"useRubicContract": true,
"private": true
}Body
application/json
Destination token blockchain
Destination token blockchain
Available options:
MUMBAI, BSCT, GOERLI, FUJI, SCROLL_SEPOLIA, ARTHERA, SEPOLIA, BERACHAIN_TESTNET, BLAST_TESTNET, HOLESKY, UNICHAIN_SEPOLIA_TESTNET, ETH, BSC, POLYGON, AVALANCHE, MOONRIVER, FANTOM, HARMONY, ARBITRUM, AURORA, TELOS, OPTIMISM, CRONOS, OKX, GNOSIS, FUSE, MOONBEAM, CELO, BOBA, BOBA_BSC, ASTAR_EVM, KAVA, BITGERT, OASIS, METIS, DEFIKINGDOMS, KLAYTN, VELAS, SYSCOIN, ETHEREUM_CLASSIC, FLARE, IOTEX, THETA, ZK_SYNC, PULSECHAIN, LINEA, BASE, MANTLE, MANTA_PACIFIC, SCROLL, ZETACHAIN, BLAST, HORIZEN_EON, MERLIN, ROOTSTOCK, MODE, ZK_FAIR, ZK_LINK, XLAYER, TAIKO, SEI, CORE, BAHAMUT, BITLAYER, GRAVITY, FRAXTAL, BERACHAIN, SONEIUM, UNICHAIN, MORPH, HEMI, PLASMA, MONAD, HYPER_EVM, MEGAETH, ROBINHOOD, BITCOIN_CASH, NEAR, ICP, CARDANO, AION, ALGORAND, APTOS, ARDOR, ARK, ASTAR, COSMOS, BAND_PROTOCOL, BITCOIN_DIAMOND, BSV, BITCOIN_GOLD, CASPER, DASH, DECRED, DIGI_BYTE, DIVI, DOGECOIN, POLKADOT, MULTIVERS_X, FIO_PROTOCOL, FIRO, FLOW, HEDERA, HELIUM, ICON, IOST, IOTA, KADENA, KOMODO, KUSAMA, LISK, LITECOIN, TERRA, TERRA_CLASSIC, MINA_PROTOCOL, NANO, NEO, OSMOSIS, PIVX, POLYX, QTUM, THOR_CHAIN, RAVENCOIN, SIA, SECRET, STEEM, STRATIS, STACKS, SOLAR, VE_CHAIN, WAVES, WAX, DX_CHAIN, E_CASH, NEM, STELLAR, MONERO, RIPPLE, TEZOS, VERGE, SYMBOL, ZCASH, HORIZEN, ZILLIQA, KAVA_COSMOS, FILECOIN, EOS, ONTOLOGY, XDC, STARKNET, TON, SOLANA, BITCOIN, TRON, SUI Source token blockchain
Available options:
MUMBAI, BSCT, GOERLI, FUJI, SCROLL_SEPOLIA, ARTHERA, SEPOLIA, BERACHAIN_TESTNET, BLAST_TESTNET, HOLESKY, UNICHAIN_SEPOLIA_TESTNET, ETH, BSC, POLYGON, AVALANCHE, MOONRIVER, FANTOM, HARMONY, ARBITRUM, AURORA, TELOS, OPTIMISM, CRONOS, OKX, GNOSIS, FUSE, MOONBEAM, CELO, BOBA, BOBA_BSC, ASTAR_EVM, KAVA, BITGERT, OASIS, METIS, DEFIKINGDOMS, KLAYTN, VELAS, SYSCOIN, ETHEREUM_CLASSIC, FLARE, IOTEX, THETA, ZK_SYNC, PULSECHAIN, LINEA, BASE, MANTLE, MANTA_PACIFIC, SCROLL, ZETACHAIN, BLAST, HORIZEN_EON, MERLIN, ROOTSTOCK, MODE, ZK_FAIR, ZK_LINK, XLAYER, TAIKO, SEI, CORE, BAHAMUT, BITLAYER, GRAVITY, FRAXTAL, BERACHAIN, SONEIUM, UNICHAIN, MORPH, HEMI, PLASMA, MONAD, HYPER_EVM, MEGAETH, ROBINHOOD, BITCOIN_CASH, NEAR, ICP, CARDANO, AION, ALGORAND, APTOS, ARDOR, ARK, ASTAR, COSMOS, BAND_PROTOCOL, BITCOIN_DIAMOND, BSV, BITCOIN_GOLD, CASPER, DASH, DECRED, DIGI_BYTE, DIVI, DOGECOIN, POLKADOT, MULTIVERS_X, FIO_PROTOCOL, FIRO, FLOW, HEDERA, HELIUM, ICON, IOST, IOTA, KADENA, KOMODO, KUSAMA, LISK, LITECOIN, TERRA, TERRA_CLASSIC, MINA_PROTOCOL, NANO, NEO, OSMOSIS, PIVX, POLYX, QTUM, THOR_CHAIN, RAVENCOIN, SIA, SECRET, STEEM, STRATIS, STACKS, SOLAR, VE_CHAIN, WAVES, WAX, DX_CHAIN, E_CASH, NEM, STELLAR, MONERO, RIPPLE, TEZOS, VERGE, SYMBOL, ZCASH, HORIZEN, ZILLIQA, KAVA_COSMOS, FILECOIN, EOS, ONTOLOGY, XDC, STARKNET, TON, SOLANA, BITCOIN, TRON, SUI Source token amount with decimals
Example:
"1.05"
Destination token address
Example:
"0x0000000000000000000000000000000000000000"
Referrer address
Example:
"rubic.exchange"
Native provider-calculation to exclude from calculation
Show failed routes in response or not
Example:
false
Show dangerous routes in response or not
Example:
false
Available options:
onlyDeposits, notDeposits, onlyPrivate, notPrivate Use deposit trade if available
Integrator address to set fees
Wallet address to send funds from
Slippage tolerance in percents for trade
Required range:
x <= 0.5Example:
0.02
Wallet address to send tokens to on the destination blockchain
Preferred provider for calculation
Available options:
symbiosis, lifi, dln, bridgers, multichain, xy, celer_bridge, changenow, stargate_v2, arbitrum, squidrouter, scroll_bridge, taiko_bridge, rango, pulsechain_bridge, orbiter_bridge, orbiter_bridge_v2, owl_to_bridge, layerzero, archon_bridge, meson, eddy_bridge, router, retro_bridge, across, unizen, simple_swap, changelly, tele_swap, wanchain_bridge, relay, xflows, wormhole, exolix, near_intents, usdt_zero_bridge, houdini_bridge, quickex, rubic_stellar_api, pact_swap, stealthex, mayan, clearswap_bridge, instaswap, baltex, change_hero, xgram, the_change, cce_cash, 10K_SWAP, AERODROME, ACRYPTOS, ALDRIN_EXCHANGE, ALGEBRA, ALGEBRA_INTEGRAL, ANNEX, APE_SWAP, ARTH_SWAP, ASTRO_SWAP, ASCENT, AURORA_SWAP, AVNU, AETHON_SWAP, ATLANTIS, AQUARIUS, BABY_SWAP, BALANCER, BASE_SWAP, BEAM_SWAP, BI_SWAP, BRIDGERS, BLAZE_SWAP, BULBA_SWAP, CAMELOT, CETUS, CHERRY_SWAP, CLAIM_SWAP, CLEARSWAP, COFFEE_SWAP, CREMA_FINANCE, CRO_SWAP, CRONA_SWAP, CROPPER_FINANCE, CROW_FI, CRO_DEX, CURVE, CLOBER, DEDUST, DEFI_PLAZA, DEFI_SWAP, DFLOW, DFYN, DLN, DODO, DRAGON_SWAP, DYSTOPIA, ECHO_DEX, EDDY_FINANCE, ELK, ENOSYS, ENOSYS_V3, FENIX_V2, FENIX_V3, FINKUJIRA, FUSIONX, FRAX_SWAP_V2, HONEY_SWAP, HORIZONDEX, HOUDINI, HYPERCAT, JET_SWAP, JOE, JUPITER, JUPITER_SWAP, J_SWAP, KIM, KODIAK, KUJATA, KYBER_SWAP, KYO_FINANCE, LUA_SWAP, LIFI, MACARON, MAVERICK, MDEX, MERLIN_SWAP, MESH_SWAP, MM_FINANCE, MOJITO_SWAP, MUTE_SWAP, NET_SWAP, NATIVE_ROUTER, ODOS, OKC_SWAP, OKU_SWAP, ONE_INCH, ONE_MOON, ONE_SOL, OMNIDEX, OOLONG_SWAP, OPEN_OCEAN, ORCA_SWAP, OSMOSIS_SWAP, OCTO_SWAP, PANCAKE_SWAP, PANCAKE_SWAP_V3, PANGOLIN, PARA_SWAP, PEGASYS, PHOTON_SWAP, POLYDEX, PITEAS, QUICK_SWAP, QUICK_SWAP_V3, PULSEX_V1, PULSEX_V2, RANGO, RAYDIUM, REF_FINANCE, REN_BTC, ROUTER_SWAP, RUBIC_STELLAR_API, SABER_STABLE_SWAP, SAROS_SWAP, SERUM, SHIBA_SWAP, SILK_SWAP, SMOOTHY, SOLANA, SOLAR_BEAM, SPACEFI_SWAP, SPIRIT_SWAP, SPL_TOKEN_SWAP, SPOOKY_SWAP, SOUL_SWAP, STELLA_SWAP, STONFI, SUN_SWAP, SURFDEX, SUSHI_SWAP, SYNAPSE, SYNC_SWAP, SPARK_DEX, SPARK_DEX_V3, SQUIDROUTER, SYMBIOSIS_SWAP, SOROSWAP, TONCO_DEX, TRADER, TRISOLARIS, IZUMI, UBE_SWAP, UNISWAP_V2, UNI_SWAP_V3, UNIZEN, VERSE, VIPER_SWAP, VOLTAGE_SWAP, VOOI, VVS_FINANCE, WAGYU_SWAP, WANNA_SWAP, WAULT_SWAP, WOO_FI, WRAPPED, WYND, WARPX_V2, WARPX_V3, XY_DEX, YUZU_SWAP, ZAPPY, ZIP_SWAP, ZRX, ZETA_SWAP Foreign provider-calculation to exclude from calculation
Show child attributes
Show child attributes
Calculation timeout in seconds
Required range:
2 <= x <= 60Example:
32
Use testnets for calculation or not
Example:
false
Enable allowance enough check
Skip providers with fee in route
Response
200 - application/json
Trade identifier
Quote response data
Show child attributes
Show child attributes
Swap type
Provider type
Estimates
Show child attributes
Show child attributes
Fees
Show child attributes
Show child attributes
Routing data
Show child attributes
Show child attributes
Transaction data
Show child attributes
Show child attributes
Specific info about quote params provider