Skip to main content
POST
/
api
/
routes
/
quoteDepositTrades
curl --request POST \
  --url https://api-v2.rubic.exchange/api/routes/quoteDepositTrades \
  --header 'Content-Type: application/json' \
  --data '
{
  "dstTokenAddress": "0x0000000000000000000000000000000000000000",
  "dstTokenBlockchain": "POLYGON",
  "referrer": "rubic.exchange",
  "srcTokenAddress": "0x0000000000000000000000000000000000000000",
  "srcTokenAmount": "1.05",
  "srcTokenBlockchain": "ETH"
}
'
{
  "quote": {
    "srcTokenAddress": "<string>",
    "dstTokenBlockchain": "POLYGON",
    "srcTokenBlockchain": "ETH",
    "srcTokenAmount": "1.05",
    "dstTokenAddress": "0x0000000000000000000000000000000000000000",
    "receiver": "<string>",
    "referrer": "rubic.exchange",
    "nativeBlacklist": [],
    "showFailedRoutes": false,
    "showDangerousRoutes": false,
    "depositTradeParams": "all",
    "useDepositTradeIfAvailable": false,
    "integratorAddress": "<string>",
    "fromAddress": "<string>",
    "slippage": 0.02,
    "preferredProvider": "symbiosis",
    "foreignBlacklist": {
      "dflow": [],
      "lifi": [],
      "rango": [],
      "zerox": []
    },
    "timeout": 32,
    "enableTestnets": false,
    "enableChecks": false,
    "skipFeeProviders": false
  },
  "routes": [
    {}
  ],
  "failed": [
    {}
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.rubic.finance/llms.txt

Use this file to discover all available pages before exploring further.

Body

application/json
​
srcTokenAddress
string
required

Destination token blockchain

​
dstTokenBlockchain
enum<string>
default:POLYGON
required

Destination token blockchain

Available options:
MUMBAI,
BSCT,
GOERLI,
FUJI,
SCROLL_SEPOLIA,
ARTHERA,
SEPOLIA,
BERACHAIN_TESTNET,
BLAST_TESTNET,
HOLESKY,
UNICHAIN_SEPOLIA_TESTNET,
ETH,
BSC,
POLYGON,
POLYGON_ZKEVM,
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,
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
​
srcTokenBlockchain
enum<string>
default:ETH
required

Source token blockchain

Available options:
MUMBAI,
BSCT,
GOERLI,
FUJI,
SCROLL_SEPOLIA,
ARTHERA,
SEPOLIA,
BERACHAIN_TESTNET,
BLAST_TESTNET,
HOLESKY,
UNICHAIN_SEPOLIA_TESTNET,
ETH,
BSC,
POLYGON,
POLYGON_ZKEVM,
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,
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
​
srcTokenAmount
string
required

Source token amount with decimals

Example:

"1.05"

​
dstTokenAddress
string
required

Destination token address

Example:

"0x0000000000000000000000000000000000000000"

​
receiver
string
required

Wallet address to send tokens to on the destination blockchain

​
referrer
object
required

Referrer address

Example:

"rubic.exchange"

​
nativeBlacklist
string[]

Native provider-calculation to exclude from calculation

​
preferredProvider
enum<string>

Preferred provider for calculation

Available options:
simple_swap,
changenow,
changelly,
exolix,
near_intents,
houdini,
quickex,
CLEARSWAP,
relay
​
integratorAddress
string

Integrator address to set fees

​
slippage
number

Slippage tolerance in percents for trade

Required range: x <= 0.5
Example:

0.02

​
foreignBlacklist
object

Foreign provider-calculation to exclude from calculation

​
timeout
number
default:30

Calculation timeout in seconds

Required range: 2 <= x <= 60
Example:

32

​
enableTestnets
boolean

Use testnets for calculation or not

Example:

false

​
enableChecks
object

Enable allowance enough check

​
skipFeeProviders
object

Skip providers with fee in route

​
showFailedRoutes
boolean
default:false

Show failed routes in response or not

Example:

false

​
showDangerousRoutes
boolean
default:false

Show dangerous routes in response or not

Example:

false

​
depositTradeParams
enum<string>
default:all
Available options:
onlyDeposits,
noDeposits,
all
​
useDepositTradeIfAvailable
boolean
default:false

Use deposit trade if available

Response

200 - application/json
​
quote
object
required

Quote response data

​
routes
object[]
required

Successful routes

​
failed
object[]

Failed routes