Quote an EVM swap

curl --request GET \
  --url https://router.raze.bot/evm/quote \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://router.raze.bot/evm/quote', 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://router.raze.bot/evm/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://router.raze.bot/evm/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://router.raze.bot/evm/quote")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "inputMint": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
  "inAmount": "1000000000000000",
  "outputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "outAmount": "2480114",
  "otherAmountThreshold": "2455312",
  "swapMode": "ExactIn",
  "slippageBps": 100,
  "priceImpactPct": "0",
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "0xb4cb800910b228ed3d0834cf79d697127bbb00e5",
        "label": "Uniswap V3",
        "inputMint": "0x4200000000000000000000000000000000000006",
        "outputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "inAmount": "1000000000000000",
        "outAmount": "2480114",
        "feeTier": 100
      },
      "percent": 100,
      "bps": 10000
    }
  ],
  "contextSlot": 52397003,
  "timeTaken": 0.014914167,
  "quoteId": "a94ab99f-de33-40e4-86e8-f9a3d8d3cc90",
  "chain": "base",
  "chainId": 8453,
  "router": "0x2626664c2603336e57b271c5c0b26f421741e481",
  "gasEstimate": "132900",
  "blockHash": "0x9ff8b4818f3f50f5f468d92bd3285bff54403037e5d4e8596689a065f42da13c",
  "expiresAt": "2026-10-09T22:02:50.275720839Z",
  "candidates": 5
}

EVM

EVM quote

The best exact-in route for amount of inputMint into outputMint on one EVM chain, priced by the venues’ own contracts (V2 router getAmountsOut, V3 QuoterV2 quoteExactInput), all at one block: contextSlot is its number, blockHash its hash. The response is a Jupiter-shaped quote, like the Solana router’s: pass it unchanged as quoteResponse to POST /evm/swap before expiresAt (15 seconds after quoting; 30 on eth). Quotes are kept in the router’s memory only, and a build takes only a quote this router made and still holds.

Routes. Direct, through one intermediate token (maxHops 2, the default) or through two (maxHops 3), every hop on the same venue. Intermediates are the chain’s hubs (listed by GET /evm/chains) and tokens recently seen paired with the input or the output. At most 48 routes are priced (candidates says how many were); the most output wins, then fewer hops, then less gas. routePlan has one step per hop (percent 100 and bps 10000: there are no splits) with the pool (ammKey), the venue’s dex label, the hop’s amounts and, on V3, the pool’s feeTier. Inside a route the wrapped token stands for the native coin. router is the contract the swap transaction will go to.

Floor. otherAmountThreshold is outAmount × (10000 − slippageBps) / 10000, rounded down. The build writes it into the swap’s calldata. A floor of zero is refused (422 declined amount_too_small); an amount so small that no route gives anything is 404 declined no_route.

Native coin. 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE (any case) or native is the chain’s coin (ETH, BNB), distinct from its wrapped token; answers write it in lower case. Native to wrapped is a wrap (deposit()), wrapped to native an unwrap (withdraw), on the wrapped-token contract itself: one step labelled Wrap or Unwrap whose ammKey is the wrapped token, 1:1, otherAmountThreshold equal to inAmount whatever the slippage, no pool, candidates 0. Venue filters do not apply to them.

Differences from the Solana GET /quote: chain is required; mints are 0x addresses and amounts uint256; ExactIn only; maxHops at most 3; no split and no platform fee (platformFeeBps above 0 is 400, not ignored); allowSplit, feeOnInput, forJitoBundle, reserveKeys and asLegacyTransaction are ignored; priceImpactPct is always "0"; no swapInfo.walkSteps; extra fields swapInfo.feeTier, chain, chainId, router, gasEstimate, blockHash, expiresAt, candidates; quoteId is a UUID.

GET

evm

quote

Quote an EVM swap

curl --request GET \
  --url https://router.raze.bot/evm/quote \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://router.raze.bot/evm/quote', 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://router.raze.bot/evm/quote",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "https://router.raze.bot/evm/quote"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://router.raze.bot/evm/quote")

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

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

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

{
  "inputMint": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
  "inAmount": "1000000000000000",
  "outputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "outAmount": "2480114",
  "otherAmountThreshold": "2455312",
  "swapMode": "ExactIn",
  "slippageBps": 100,
  "priceImpactPct": "0",
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "0xb4cb800910b228ed3d0834cf79d697127bbb00e5",
        "label": "Uniswap V3",
        "inputMint": "0x4200000000000000000000000000000000000006",
        "outputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "inAmount": "1000000000000000",
        "outAmount": "2480114",
        "feeTier": 100
      },
      "percent": 100,
      "bps": 10000
    }
  ],
  "contextSlot": 52397003,
  "timeTaken": 0.014914167,
  "quoteId": "a94ab99f-de33-40e4-86e8-f9a3d8d3cc90",
  "chain": "base",
  "chainId": 8453,
  "router": "0x2626664c2603336e57b271c5c0b26f421741e481",
  "gasEstimate": "132900",
  "blockHash": "0x9ff8b4818f3f50f5f468d92bd3285bff54403037e5d4e8596689a065f42da13c",
  "expiresAt": "2026-10-09T22:02:50.275720839Z",
  "candidates": 5
}

Guide: EVM swaps. Pass the answer unchanged as quoteResponse to POST /evm/swap before its expiresAt. Errors: EVM errors.

Authorizations

x-api-key

string

header

required

Query Parameters

chain

string

required

eth, bsc, base or robinhood (also ethereum, bnb), or the chain id: 1, 56, 8453, 4663. Alias chainId

Example:

"base"

inputMint

string

required

Token you spend: its 0x address (any case), or 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE or native for the chain's coin. The zero address is refused

Example:

"0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE"

outputMint

string

required

Token you receive, spelled as inputMint. Must differ from it: there are no cycles on EVM

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

amount

string

required

What you spend: a uint256 in the token's smallest unit (wei for the native coin), in decimal digits. No sign, fraction or exponent. 0 is 400 declined zero_amount

Pattern: ^[0-9]+$

Example:

"1000000000000000"

slippageBps

integer

default:50

Tolerance in basis points, 0–10000; above 10000 is 400

Required range: 0 <= x <= 10000

swapMode

enum<string>

default:ExactIn

Only ExactIn (or exactIn): ExactOut is 400

Available options:

ExactIn,

exactIn

maxHops

integer

default:2

Most hops per route: 1 direct only, 2 through at most one intermediate token, 3 two. 0 counts as 1; more than 3 counts as 3

Required range: x >= 0

onlyDirectRoutes

boolean

default:false

true is maxHops=1: a single pool

dexes

string

Only these venues: dex labels (Uniswap V3, PancakeSwap V2, …) or venue ids (base-uniswap-v3) from /evm/venues, matched ignoring case and punctuation; comma-separated or the parameter repeated. Alias includeDex. Unknown labels next to known ones are ignored; only unknown labels (or only another chain's) is 400

Example:

"Uniswap V3"

excludeDexes

string

Never these venues, same format as dexes. Alias excludeDex. Excluding every venue of the chain is 404 no_route

Example:

"Uniswap V2"

platformFeeBps

integer

default:0

Only 0 or absent: there is no platform fee on EVM, and above 0 is 400

Response

The quote (live answers of the public router)

inputMint

string

required

Lower case; the native coin is 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

inAmount

string

required

What you spend: the amount asked

outputMint

string

required

outAmount

string

required

What the route gives at the quote's block, in base units of outputMint, before any tax the token itself takes

otherAmountThreshold

string

required

The floor the swap will enforce on chain: outAmount × (10000 − slippageBps) / 10000, rounded down (inAmount for a wrap or an unwrap)

swapMode

string

required

Allowed value: "ExactIn"

slippageBps

integer

required

priceImpactPct

string

required

Not computed on EVM: always 0

Allowed value: "0"

routePlan

object[]

required

One step per hop, in order

Show child attributes

contextSlot

integer

required

The block number the quote was priced at

timeTaken

number

required

Seconds spent inside the router

quoteId

string<uuid>

required

What POST /evm/swap builds, until expiresAt

chain

enum<string>

required

eth (chain id 1), bsc (56), base (8453), robinhood (4663)

Available options:

eth,

bsc,

base,

robinhood

chainId

integer

required

router

string

required

The contract the swap transaction goes to: the venue's router (also the approvals' spender), or the wrapped token for a wrap or an unwrap

gasEstimate

string

required

Indicative (QuoterV2 on V3, a fixed estimate per hop on V2). The build's simulation gives the real figure

blockHash

string

required

The hash of the block the quote was priced at

expiresAt

string<date-time>

required

Until when the quote can be built: the chain's quoteTtlSecs after quoting (15 s; 30 s on eth)

candidates

integer

required

Routes priced (0 for a wrap or an unwrap)

Guides

Swap

Transactions

EVM

Launch

Operations

EVM quote

Authorizations

Query Parameters

Response