Request Quote

Get routes between token A and token B

Quote Best

Using the quote method, you can get a preview of the best route for this cross-chain swap. It goes through all the possible DEXs, bridges and aggregators to find the best possible single-step route based on user experience, fee amount, and swap output. You can check available request params here.

Here is an example of quoting swap 1.05 ETH in Ethereum Blockchain for Matic in Polygon Blockchain

Node.JS (Axios) Request

const response = await axios.post('https://api-v2.rubic.exchange/api/routes/quoteBest', {
  params: {
    "dstTokenAddress": "0x0000000000000000000000000000000000000000",
    "dstTokenBlockchain": "POLYGON",
    "referrer": "rubic.exchange",
    "srcTokenAddress": "0x0000000000000000000000000000000000000000",
    "srcTokenAmount": "1.05",
    "srcTokenBlockchain": "ETH"
  }
});

cURL Request

curl -X 'POST' \
  'https://dev-api-v2.rubic.exchange/api/routes/quoteBest' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "dstTokenAddress": "0x0000000000000000000000000000000000000000",
  "dstTokenBlockchain": "POLYGON",
  "referrer": "rubic.exchange",
  "srcTokenAddress": "0x0000000000000000000000000000000000000000",
  "srcTokenAmount": "1.05",
  "srcTokenBlockchain": "ETH"
}'

Example Response

{
  "estimate": {
    "destinationTokenAmount": "6899.286207817309581298",
    "destinationTokenMinAmount": "6692.307621582790293859",
    "destinationUsdAmount": 2807.03,
    "destinationUsdMinAmount": 2722.82,
    "destinationWeiAmount": "6899286207817309581298",
    "destinationWeiMinAmount": "6692307621582790293859",
    "durationInMinutes": 5,
    "priceImpact": null,
    "slippage": 0.03
  },
  "fees": {
    "gasTokenFees": {
      "gas": {
        "gasLimit": "0",
        "gasPrice": "0",
        "totalUsdAmount": 0,
        "totalWeiAmount": "0"
      },
      "nativeToken": {
        "address": "0x0000000000000000000000000000000000000000",
        "blockchainId": 1,
        "decimals": 18,
        "name": "Ethereum",
        "symbol": "ETH"
      },
      "protocol": {
        "fixedAmount": "0.000780454302449455",
        "fixedUsdAmount": 2.08,
        "fixedWeiAmount": "780454302449455"
      },
      "provider": {
        "fixedAmount": "0",
        "fixedUsdAmount": 0,
        "fixedWeiAmount": "0"
      }
    },
    "percentFees": {
      "percent": 0,
      "token": {
        "address": "0x0000000000000000000000000000000000000000",
        "blockchainId": 1,
        "decimals": 18,
        "name": "Ethereum",
        "symbol": "ETH"
      }
    }
  },
  "providerType": "router",
  "quote": {
    "nativeBlacklist": [],
    "foreignBlacklist": {
      "lifi": [],
      "rango": []
    },
    "timeout": 30,
    "referrer": "rubic.exchange",
    "showFailedRoutes": false,
    "dstTokenAddress": "0x0000000000000000000000000000000000000000",
    "dstTokenBlockchain": "POLYGON",
    "srcTokenAddress": "0x0000000000000000000000000000000000000000",
    "srcTokenAmount": "1.05",
    "srcTokenBlockchain": "ETH",
    "integratorAddress": "0x3fFF9bDEb3147cE13A7FFEf85Dae81874E0AEDbE",
    "slippage": 0.03
  },
  "routing": [
    {
      "path": [
        {
          "address": "0x0000000000000000000000000000000000000000",
          "amount": "1.05",
          "blockchainId": 1,
          "decimals": 18,
          "name": "Ethereum",
          "symbol": "ETH"
        },
        {
          "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "amount": "1050000000000000000",
          "blockchainId": 1,
          "decimals": 18,
          "name": "Wrapped Ether",
          "symbol": "WETH"
        }
      ],
      "provider": "ROUTER_SWAP",
      "type": "on-chain"
    },
    {
      "path": [
        {
          "address": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
          "amount": "1050000000000000000",
          "blockchainId": 1,
          "decimals": 18,
          "name": "Wrapped Ether",
          "symbol": "WETH"
        },
        {
          "address": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
          "amount": "1049906329165283215",
          "blockchainId": 137,
          "decimals": 18,
          "name": "Wrapped Ether",
          "symbol": "WETH"
        }
      ],
      "provider": "router",
      "type": "cross-chain"
    },
    {
      "path": [
        {
          "address": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
          "amount": "1049906329165283215",
          "blockchainId": 137,
          "decimals": 18,
          "name": "Wrapped Ether",
          "symbol": "WETH"
        },
        {
          "address": "0x0000000000000000000000000000000000000000",
          "amount": "6899.286207817309581298",
          "blockchainId": 137,
          "decimals": 18,
          "name": "Matic Network",
          "symbol": "MATIC"
        }
      ],
      "provider": "ROUTER_SWAP",
      "type": "on-chain"
    }
  ],
  "swapType": "cross-chain",
  "transaction": {
    "approvalAddress": "0x3335733c454805df6a77f825f266e136FB4a3333"
  },
  "warnings": [],
  "id": "08df660f-49e5-42fd-a1f1-cdf0af5eac4c"
}

Swagger UI

Swagger Link

Quote All

Using the quote method, you can get a preview of all possible routes for this cross-chain swap. It goes through all the possible DEXs, bridges and aggregators to find and provide all single-step routes based on user experience, fee amount, and swap output. You can check available request params here.

Here is an example of quoting swap 1.05 ETH in Ethereum Blockchain for Matic in Polygon Blockchain

Node.JS (Axios) Request

const response = await axios.post('https://api-v2.rubic.exchange/api/routes/quoteAll', {
  params: {
    "dstTokenAddress": "0x0000000000000000000000000000000000000000",
    "dstTokenBlockchain": "POLYGON",
    "referrer": "rubic.exchange",
    "srcTokenAddress": "0x0000000000000000000000000000000000000000",
    "srcTokenAmount": "1.05",
    "srcTokenBlockchain": "ETH"
  }
});

Swagger UI

Swagger link

Quote request params

Required params

Field	Type	Description	Example
srcTokenAddress*	string	Source token address	0x0000000000000000000000000000000000000000
srcTokenBlockchain*	string	Source token blockchain	ETH
srcTokenAmount*	string	Source token amount with decimals	1.05
dstTokenAddress*	string	Destination token address	0x0000000000000000000000000000000000000000
dstTokenBlockchain*	string	Destination token blockchain	Polygon
referrer*	string	Referrer address	rubic.exchange

Optional fields

Field	Type	Description	Example
nativeBlacklist	string[]	Native providers to exclude from calculation	["xy", "symbiosis"]
showFailedRoutes	boolean	Show failed routes in response or not	false
integratorAddress	string	Integrator address to set fees	Get the address from our BD team
slippage	number minimum: 0.01 maximum: 0.5	Slippage tolerance in percents for trade, 0.01 equals 1%	0.02
receiver	string	Wallet address to send tokens to on the destination blockchain	0x0000000000000000000000000000000000000000
preferredProvider	string	Preferred provider for calculation	lifi
foreignBlacklist	{ lifi?: string[]; rango?: string[]; }	Foreign providers to exclude from calculation	{ lifi: ["stargate"] }
timeout	number minimum: 5 maximum: 60	Calculation timeout in seconds	32
enableTestnets	boolean	Include testnet in calculations	false
fromAddress	string	Wallet address to send funds from	0x0000000000000000000000000000000000000000

Quote response params

Field	Type	Description	Example
id	string	Trade identifier	60e513d5-8a2d-4e0d-b513-6236d86bc7da
quote	QuoteRequestDto	Quote params that you send
swapType	'cross-chain' | 'on-chain'	Type of swap	cross-chain
providerType	CrossChainTradeType | OnChainTradeType	Inner provider which we use to swap	Rango
fees	FeesDto	Different fees used for swap
routing	RoutingDto[]	The path tokens take during the swap process
transaction	TransactionDto	Transaction config to perform approve	{ approvalAddress: string }
warnings	ErrorDto[]	Specific info about quote params provider	[ { code: 301, reason: amountTooLow, data: { minAmount: 0.1 eth } ]