Optimal route between two tokens

curl --request POST \
  --url https://api.enso.build/api/v1/shortcuts/route \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "amountIn": [
    "1000000000000000000"
  ],
  "tokenIn": [
    "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
  ],
  "tokenOut": [
    "0x6b175474e89094c44da98b954eedeac495271d0f"
  ],
  "variableEstimates": null,
  "chainId": 1,
  "toEoa": true,
  "receiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "spender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "minAmountOut": null,
  "slippage": "300",
  "fee": [
    "100"
  ],
  "feeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
  "destinationFeeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
  "ignoreAggregators": [
    "<string>"
  ],
  "ignoreStandards": [
    "<string>"
  ],
  "ignoreBridges": [
    "<string>"
  ],
  "referralCode": "<string>",
  "destinationChainId": 123,
  "crosschainRouteMode": "full",
  "refundReceiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}
'

import requests

url = "https://api.enso.build/api/v1/shortcuts/route"

payload = {
    "fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "amountIn": ["1000000000000000000"],
    "tokenIn": ["0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"],
    "tokenOut": ["0x6b175474e89094c44da98b954eedeac495271d0f"],
    "variableEstimates": None,
    "chainId": 1,
    "toEoa": True,
    "receiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "spender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "minAmountOut": None,
    "slippage": "300",
    "fee": ["100"],
    "feeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
    "destinationFeeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
    "ignoreAggregators": ["<string>"],
    "ignoreStandards": ["<string>"],
    "ignoreBridges": ["<string>"],
    "referralCode": "<string>",
    "destinationChainId": 123,
    "crosschainRouteMode": "full",
    "refundReceiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    amountIn: ['1000000000000000000'],
    tokenIn: ['0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'],
    tokenOut: ['0x6b175474e89094c44da98b954eedeac495271d0f'],
    variableEstimates: null,
    chainId: 1,
    toEoa: true,
    receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    spender: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    minAmountOut: null,
    slippage: '300',
    fee: ['100'],
    feeReceiver: '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    destinationFeeReceiver: '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    ignoreAggregators: ['<string>'],
    ignoreStandards: ['<string>'],
    ignoreBridges: ['<string>'],
    referralCode: '<string>',
    destinationChainId: 123,
    crosschainRouteMode: 'full',
    refundReceiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
  })
};

fetch('https://api.enso.build/api/v1/shortcuts/route', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/shortcuts/route",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromAddress' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'amountIn' => [
        '1000000000000000000'
    ],
    'tokenIn' => [
        '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
    ],
    'tokenOut' => [
        '0x6b175474e89094c44da98b954eedeac495271d0f'
    ],
    'variableEstimates' => null,
    'chainId' => 1,
    'toEoa' => true,
    'receiver' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'spender' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'minAmountOut' => null,
    'slippage' => '300',
    'fee' => [
        '100'
    ],
    'feeReceiver' => '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    'destinationFeeReceiver' => '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    'ignoreAggregators' => [
        '<string>'
    ],
    'ignoreStandards' => [
        '<string>'
    ],
    'ignoreBridges' => [
        '<string>'
    ],
    'referralCode' => '<string>',
    'destinationChainId' => 123,
    'crosschainRouteMode' => 'full',
    'refundReceiver' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/shortcuts/route"

	payload := strings.NewReader("{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.enso.build/api/v1/shortcuts/route")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/shortcuts/route")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}"

response = http.request(request)
puts response.read_body

{
  "gas": "<string>",
  "amountOut": "<string>",
  "priceImpact": 123,
  "feeAmount": [
    "<string>"
  ],
  "minAmountOut": "<string>",
  "createdAt": 123,
  "tx": {
    "data": "<string>",
    "to": "<string>",
    "from": "<string>",
    "value": "<string>"
  },
  "route": [
    {
      "tokenIn": [
        "<string>"
      ],
      "tokenOut": [
        "<string>"
      ],
      "protocol": "<string>",
      "action": "approve",
      "primary": "<string>",
      "internalRoutes": [
        "<string>"
      ],
      "args": {},
      "chainId": 123,
      "sourceChainId": 123,
      "destinationChainId": 123,
      "estimatedAmountOut": [
        "<string>"
      ]
    }
  ],
  "ensoFeeAmount": [
    "<string>"
  ],
  "metadata": {
    "bridgeRefundAssets": [
      {
        "protocol": "cctp",
        "chainId": 123,
        "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "symbol": "USDC"
      }
    ]
  }
}

POST

api

shortcuts

route

Optimal route between two tokens

curl --request POST \
  --url https://api.enso.build/api/v1/shortcuts/route \
  --header 'Content-Type: application/json' \
  --data '
{
  "fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "amountIn": [
    "1000000000000000000"
  ],
  "tokenIn": [
    "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
  ],
  "tokenOut": [
    "0x6b175474e89094c44da98b954eedeac495271d0f"
  ],
  "variableEstimates": null,
  "chainId": 1,
  "toEoa": true,
  "receiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "spender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
  "minAmountOut": null,
  "slippage": "300",
  "fee": [
    "100"
  ],
  "feeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
  "destinationFeeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
  "ignoreAggregators": [
    "<string>"
  ],
  "ignoreStandards": [
    "<string>"
  ],
  "ignoreBridges": [
    "<string>"
  ],
  "referralCode": "<string>",
  "destinationChainId": 123,
  "crosschainRouteMode": "full",
  "refundReceiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}
'

import requests

url = "https://api.enso.build/api/v1/shortcuts/route"

payload = {
    "fromAddress": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "amountIn": ["1000000000000000000"],
    "tokenIn": ["0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"],
    "tokenOut": ["0x6b175474e89094c44da98b954eedeac495271d0f"],
    "variableEstimates": None,
    "chainId": 1,
    "toEoa": True,
    "receiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "spender": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
    "minAmountOut": None,
    "slippage": "300",
    "fee": ["100"],
    "feeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
    "destinationFeeReceiver": "0x220866B1A2219f40e72f5c628B65D54268cA3A9D",
    "ignoreAggregators": ["<string>"],
    "ignoreStandards": ["<string>"],
    "ignoreBridges": ["<string>"],
    "referralCode": "<string>",
    "destinationChainId": 123,
    "crosschainRouteMode": "full",
    "refundReceiver": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    fromAddress: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    amountIn: ['1000000000000000000'],
    tokenIn: ['0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'],
    tokenOut: ['0x6b175474e89094c44da98b954eedeac495271d0f'],
    variableEstimates: null,
    chainId: 1,
    toEoa: true,
    receiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    spender: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    minAmountOut: null,
    slippage: '300',
    fee: ['100'],
    feeReceiver: '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    destinationFeeReceiver: '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    ignoreAggregators: ['<string>'],
    ignoreStandards: ['<string>'],
    ignoreBridges: ['<string>'],
    referralCode: '<string>',
    destinationChainId: 123,
    crosschainRouteMode: 'full',
    refundReceiver: '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
  })
};

fetch('https://api.enso.build/api/v1/shortcuts/route', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.enso.build/api/v1/shortcuts/route",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'fromAddress' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'amountIn' => [
        '1000000000000000000'
    ],
    'tokenIn' => [
        '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee'
    ],
    'tokenOut' => [
        '0x6b175474e89094c44da98b954eedeac495271d0f'
    ],
    'variableEstimates' => null,
    'chainId' => 1,
    'toEoa' => true,
    'receiver' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'spender' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045',
    'minAmountOut' => null,
    'slippage' => '300',
    'fee' => [
        '100'
    ],
    'feeReceiver' => '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    'destinationFeeReceiver' => '0x220866B1A2219f40e72f5c628B65D54268cA3A9D',
    'ignoreAggregators' => [
        '<string>'
    ],
    'ignoreStandards' => [
        '<string>'
    ],
    'ignoreBridges' => [
        '<string>'
    ],
    'referralCode' => '<string>',
    'destinationChainId' => 123,
    'crosschainRouteMode' => 'full',
    'refundReceiver' => '0xd8da6bf26964af9d7eed9e03e53415d37aa96045'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.enso.build/api/v1/shortcuts/route"

	payload := strings.NewReader("{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.enso.build/api/v1/shortcuts/route")
  .header("Content-Type", "application/json")
  .body("{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.enso.build/api/v1/shortcuts/route")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"fromAddress\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"amountIn\": [\n    \"1000000000000000000\"\n  ],\n  \"tokenIn\": [\n    \"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee\"\n  ],\n  \"tokenOut\": [\n    \"0x6b175474e89094c44da98b954eedeac495271d0f\"\n  ],\n  \"variableEstimates\": null,\n  \"chainId\": 1,\n  \"toEoa\": true,\n  \"receiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"spender\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\",\n  \"minAmountOut\": null,\n  \"slippage\": \"300\",\n  \"fee\": [\n    \"100\"\n  ],\n  \"feeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"destinationFeeReceiver\": \"0x220866B1A2219f40e72f5c628B65D54268cA3A9D\",\n  \"ignoreAggregators\": [\n    \"<string>\"\n  ],\n  \"ignoreStandards\": [\n    \"<string>\"\n  ],\n  \"ignoreBridges\": [\n    \"<string>\"\n  ],\n  \"referralCode\": \"<string>\",\n  \"destinationChainId\": 123,\n  \"crosschainRouteMode\": \"full\",\n  \"refundReceiver\": \"0xd8da6bf26964af9d7eed9e03e53415d37aa96045\"\n}"

response = http.request(request)
puts response.read_body

{
  "gas": "<string>",
  "amountOut": "<string>",
  "priceImpact": 123,
  "feeAmount": [
    "<string>"
  ],
  "minAmountOut": "<string>",
  "createdAt": 123,
  "tx": {
    "data": "<string>",
    "to": "<string>",
    "from": "<string>",
    "value": "<string>"
  },
  "route": [
    {
      "tokenIn": [
        "<string>"
      ],
      "tokenOut": [
        "<string>"
      ],
      "protocol": "<string>",
      "action": "approve",
      "primary": "<string>",
      "internalRoutes": [
        "<string>"
      ],
      "args": {},
      "chainId": 123,
      "sourceChainId": 123,
      "destinationChainId": 123,
      "estimatedAmountOut": [
        "<string>"
      ]
    }
  ],
  "ensoFeeAmount": [
    "<string>"
  ],
  "metadata": {
    "bridgeRefundAssets": [
      {
        "protocol": "cctp",
        "chainId": 123,
        "token": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "recipient": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
        "symbol": "USDC"
      }
    ]
  }
}

Body

application/json

fromAddress

string

required

Ethereum address of the wallet to send the transaction from

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

amountIn

string[]

required

Amount of tokenIn to swap in wei

Example:

["1000000000000000000"]

tokenIn

string[]

required

Ethereum address of the token to swap from. For ETH, use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Example:

[
  "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
]

tokenOut

string[]

required

Ethereum address of the token to swap to. For ETH, use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Example:

[
  "0x6b175474e89094c44da98b954eedeac495271d0f"
]

variableEstimates

object

required

chainId

number

default:1

Chain ID of the network to execute the transaction on

routingStrategy

enum<string> | null

Routing strategy to use. In majority of cases you can use router. Use delegate with EOA when you want to specify a spender

Available options:

router,

delegate,

router-legacy,

delegate-legacy,

ensowallet

toEoa

boolean | null

deprecated

Flag that indicates if gained tokenOut should be sent to EOA

receiver

string

Ethereum address of the receiver of the tokenOut

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

spender

string

Ethereum address of the spender of the tokenOut. Note: you must use the delegate strategy when specifying a spender, otherwise it will be ignored.

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

minAmountOut

string[]

Minimum amount out in wei. If specified, slippage should not be specified

slippage

string

default:50

Slippage in basis points (1/10000), e.g. 50 = 0.50%. Takes precedence over minAmountOut argument.

Example:

"300"

fee

string[]

Fee in basis points (1/10000) for each amountIn value. Must be in range 1-100. By default the fee is collected from amountIn on the source chain. When destinationFeeReceiver is selected for destination execution, it is collected from the delivered bridge asset instead.

Example:

["100"]

feeReceiver

string

The Ethereum address that receives the source-chain fee and remains the fallback when destination collection does not apply. Required if fee is provided.

Example:

"0x220866B1A2219f40e72f5c628B65D54268cA3A9D"

destinationFeeReceiver

string

Optional destination-chain fee receiver. For a cross-chain route with destination execution, the requested fee is collected atomically from the delivered bridge asset on the destination chain. Otherwise feeReceiver remains the source-chain receiver.

Example:

"0x220866B1A2219f40e72f5c628B65D54268cA3A9D"

ignoreAggregators

string[] | null

A list of swap aggregators to be ignored from consideration

ignoreStandards

string[] | null

A list of standards to be ignored from consideration

ignoreBridges

string[] | null

A list of bridges to be ignored from consideration for crosschain routes. Supported values: relay, stargate, ccip, cctp

referralCode

string

Referral code that will be included in an on-chain event.

Maximum string length: 16

Pattern: ^.{0,16}$

destinationChainId

number

Chain ID of the network to bridge to and receive tokenOut

crosschainRouteMode

enum<string>

default:full

Controls cross-chain route complexity. direct uses only a bridge, source allows routing before the bridge, destination allows routing after the bridge, sourceOrDestination allows routing on either chain but not both, and full allows routing on both chains

Available options:

direct,

source,

destination,

sourceOrDestination,

full

refundReceiver

string

Ethereum address of the receiver of any dust tokens that might be produced during the execution of actions

Example:

"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"

Response

gas

string

required

amountOut

string

required

priceImpact

number | null

required

Price impact in basis points, null if USD price not found

feeAmount

string[]

required

An array of the fee amount collected for each tokenIn

minAmountOut

string

required

The minimum allowable amount out after slippage

createdAt

number

required

Block number the transaction was created on

object

required

The tx object to use in ethers

Show child attributes

route

object[]

required

The route the shortcut will use

Show child attributes

ensoFeeAmount

string[]

required

metadata

object

required

Show child attributes

⌘I

Api Reference

Reference

Quoter Reference

Optimal route between two tokens

Body

Response