Raze.bot Developers

Build an EVM swap (alias of /evm/swap)

curl --request POST \
  --url https://router.raze.bot/evm/swap-instructions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userPublicKey": "0x000000000000000000000000000000000000dEaD",
  "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87"
}
'

import requests

url = "https://router.raze.bot/evm/swap-instructions"

payload = {
    "userPublicKey": "0x000000000000000000000000000000000000dEaD",
    "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userPublicKey: '0x000000000000000000000000000000000000dEaD',
    quoteId: 'b00fb006-1e11-4498-9d81-6d5d0857ef87'
  })
};

fetch('https://router.raze.bot/evm/swap-instructions', 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/swap-instructions",
  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([
    'userPublicKey' => '0x000000000000000000000000000000000000dEaD',
    'quoteId' => 'b00fb006-1e11-4498-9d81-6d5d0857ef87'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://router.raze.bot/evm/swap-instructions"

	payload := strings.NewReader("{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}")

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

	req.Header.Add("x-api-key", "<api-key>")
	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://router.raze.bot/evm/swap-instructions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://router.raze.bot/evm/swap-instructions")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}"

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

{
  "setupTransactions": [
    {
      "chainId": 8453,
      "from": "0x000000000000000000000000000000000000dead",
      "to": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "data": "0x095ea7b30000000000000000000000002626664c2603336e57b271c5c0b26f421741e48100000000000000000000000000000000000000000000000000000000001e8480",
      "value": "0",
      "gas": "66525",
      "maxFeePerGas": "11000000",
      "maxPriorityFeePerGas": "1000000"
    }
  ],
  "swapTransaction": {
    "chainId": 8453,
    "from": "0x000000000000000000000000000000000000dead",
    "to": "0x2626664c2603336e57b271c5c0b26f421741e481",
    "data": "0x5ae401dc000000000000000000000000000000000000000000000000000000006ac964be00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001800000000000000000000000000000000000000000000000000000000000000104b858183f000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000800000000000000000000000002626664c2603336e57b271c5c0b26f421741e48100000000000000000000000000000000000000000000000000000000001e84800000000000000000000000000000000000000000000000000002d5f2f9161ee5000000000000000000000000000000000000000000000000000000000000002b833589fcd6edb6e08f4c7c32d4f71b54bda02913000064420000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c0000000000000000000000000000000000000000000000000002d5f2f9161ee5000000000000000000000000000000000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000",
    "value": "0",
    "gas": "166575",
    "maxFeePerGas": "11000000",
    "maxPriorityFeePerGas": "1000000"
  },
  "quoteId": "0d40a5e0-21ea-498c-a753-402ddf896cdf",
  "inAmount": "2000000",
  "outAmount": "806252011312846",
  "otherAmountThreshold": "798189491199717",
  "swapMode": "ExactIn",
  "slippageBps": 100,
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "0xb4cb800910b228ed3d0834cf79d697127bbb00e5",
        "label": "Uniswap V3",
        "inputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "outputMint": "0x4200000000000000000000000000000000000006",
        "inAmount": "2000000",
        "outAmount": "806252011312846",
        "feeTier": 100
      },
      "percent": 100,
      "bps": 10000
    }
  ],
  "simulation": {
    "status": "passed",
    "outAmount": "806252011312846",
    "gasUsed": [
      "55437",
      "138812"
    ]
  },
  "costs": {
    "gas": "233100",
    "baseFeePerGas": "5000000",
    "maxPriorityFeePerGas": "1000000",
    "maxFeePerGas": "11000000",
    "gasPrice": "6000000",
    "maxNetworkFeeWei": "2564100000000"
  },
  "spender": "0x2626664c2603336e57b271c5c0b26f421741e481",
  "deadline": 1791583422,
  "chain": "base",
  "chainId": 8453,
  "contextSlot": 52397007,
  "blockHash": "0xf5eb59efc9cf90b49a959ea3596ac0d21b468d5face1048ab1a1c2bb7aab5d65",
  "expiresAt": "2026-10-09T22:02:57.037886707Z"
}

POST

evm

swap-instructions

Build an EVM swap (alias of /evm/swap)

curl --request POST \
  --url https://router.raze.bot/evm/swap-instructions \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userPublicKey": "0x000000000000000000000000000000000000dEaD",
  "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87"
}
'

import requests

url = "https://router.raze.bot/evm/swap-instructions"

payload = {
    "userPublicKey": "0x000000000000000000000000000000000000dEaD",
    "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    userPublicKey: '0x000000000000000000000000000000000000dEaD',
    quoteId: 'b00fb006-1e11-4498-9d81-6d5d0857ef87'
  })
};

fetch('https://router.raze.bot/evm/swap-instructions', 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/swap-instructions",
  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([
    'userPublicKey' => '0x000000000000000000000000000000000000dEaD',
    'quoteId' => 'b00fb006-1e11-4498-9d81-6d5d0857ef87'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "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"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://router.raze.bot/evm/swap-instructions"

	payload := strings.NewReader("{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}")

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

	req.Header.Add("x-api-key", "<api-key>")
	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://router.raze.bot/evm/swap-instructions")
  .header("x-api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://router.raze.bot/evm/swap-instructions")

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

request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"userPublicKey\": \"0x000000000000000000000000000000000000dEaD\",\n  \"quoteId\": \"b00fb006-1e11-4498-9d81-6d5d0857ef87\"\n}"

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

{
  "setupTransactions": [
    {
      "chainId": 8453,
      "from": "0x000000000000000000000000000000000000dead",
      "to": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "data": "0x095ea7b30000000000000000000000002626664c2603336e57b271c5c0b26f421741e48100000000000000000000000000000000000000000000000000000000001e8480",
      "value": "0",
      "gas": "66525",
      "maxFeePerGas": "11000000",
      "maxPriorityFeePerGas": "1000000"
    }
  ],
  "swapTransaction": {
    "chainId": 8453,
    "from": "0x000000000000000000000000000000000000dead",
    "to": "0x2626664c2603336e57b271c5c0b26f421741e481",
    "data": "0x5ae401dc000000000000000000000000000000000000000000000000000000006ac964be00000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000001800000000000000000000000000000000000000000000000000000000000000104b858183f000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000800000000000000000000000002626664c2603336e57b271c5c0b26f421741e48100000000000000000000000000000000000000000000000000000000001e84800000000000000000000000000000000000000000000000000002d5f2f9161ee5000000000000000000000000000000000000000000000000000000000000002b833589fcd6edb6e08f4c7c32d4f71b54bda02913000064420000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004449404b7c0000000000000000000000000000000000000000000000000002d5f2f9161ee5000000000000000000000000000000000000000000000000000000000000dead00000000000000000000000000000000000000000000000000000000",
    "value": "0",
    "gas": "166575",
    "maxFeePerGas": "11000000",
    "maxPriorityFeePerGas": "1000000"
  },
  "quoteId": "0d40a5e0-21ea-498c-a753-402ddf896cdf",
  "inAmount": "2000000",
  "outAmount": "806252011312846",
  "otherAmountThreshold": "798189491199717",
  "swapMode": "ExactIn",
  "slippageBps": 100,
  "routePlan": [
    {
      "swapInfo": {
        "ammKey": "0xb4cb800910b228ed3d0834cf79d697127bbb00e5",
        "label": "Uniswap V3",
        "inputMint": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "outputMint": "0x4200000000000000000000000000000000000006",
        "inAmount": "2000000",
        "outAmount": "806252011312846",
        "feeTier": 100
      },
      "percent": 100,
      "bps": 10000
    }
  ],
  "simulation": {
    "status": "passed",
    "outAmount": "806252011312846",
    "gasUsed": [
      "55437",
      "138812"
    ]
  },
  "costs": {
    "gas": "233100",
    "baseFeePerGas": "5000000",
    "maxPriorityFeePerGas": "1000000",
    "maxFeePerGas": "11000000",
    "gasPrice": "6000000",
    "maxNetworkFeeWei": "2564100000000"
  },
  "spender": "0x2626664c2603336e57b271c5c0b26f421741e481",
  "deadline": 1791583422,
  "chain": "base",
  "chainId": 8453,
  "contextSlot": 52397007,
  "blockHash": "0xf5eb59efc9cf90b49a959ea3596ac0d21b468d5face1048ab1a1c2bb7aab5d65",
  "expiresAt": "2026-10-09T22:02:57.037886707Z"
}

The same handler as POST /evm/swap, under the path name Solana and Jupiter clients call.

On EVM there are no instructions to assemble: the answer is the unsigned transactions, setupTransactions (the approvals) then swapTransaction, to sign and send in that order. See EVM swaps.

Authorizations

x-api-key

string

header

required

Body

application/json

userPublicKey

string

required

The wallet that signs and sends every transaction and pays the input: the from of each. Alias wallet

Pattern: ^0[xX][0-9a-fA-F]{40}$

quoteResponse

object

A quote of this router, sent back unchanged: its quoteId is what is built. Its chain, inputMint, outputMint, inAmount, outAmount, otherAmountThreshold and slippageBps, when present, must be the stored quote's (400 quote_mismatch): a new slippage goes in the top-level slippageBps

Show child attributes

quoteId

string<uuid>

Instead of quoteResponse: the id of the quote to build

destinationTokenAccount

string

The address that receives the output. Default userPublicKey; must equal it for a wrap or an unwrap (422 declined recipient_unsupported). Alias recipient

Pattern: ^0[xX][0-9a-fA-F]{40}$

slippageBps

With a quote: a new floor for this build only, outAmount × (10000 − slippageBps) / 10000 from the quote's outAmount (above 10000 counts as 10000; no effect on a wrap or an unwrap). Pair mode: the quote's slippage, default 50

chain

Pair mode: as in POST /evm/quote. With a quote, if present, must be its chain

inputMint

string

Pair mode: the token you spend. With a quote, if present, must be its input

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

outputMint

string

Pair mode: the token you receive. With a quote, if present, must be its output

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

amount

Pair mode: as in POST /evm/quote. With a quote, if present, must be its inAmount

swapMode

enum<string>

Pair mode only

Available options:

ExactIn,

exactIn

maxHops

Pair mode only

onlyDirectRoutes

boolean

Pair mode only

dexes

Pair mode only. Alias includeDex

excludeDexes

Pair mode only. Alias excludeDex

feeBps

Only 0: no platform fee on EVM (above 0 is 400; so is platformFeeBps)

Response

The unsigned transactions and their simulation (live answers of the public router; 0x…dEaD is a burn address that happens to hold ETH and USDC on Base, used so the simulations could pass)

setupTransactions

object[]

required

The approvals, to send first and in order: none, approve(inAmount), or approve(0) then approve(inAmount)

Show child attributes

swapTransaction

object

required

The swap, to send after the approvals and before deadline

Show child attributes

quoteId

string<uuid>

required

The quote built (in pair mode, the quote made for this call)

inAmount

string

required

outAmount

string

required

The quote's outAmount. What arrives at the build's block is simulation.outAmount

otherAmountThreshold

string

required

The floor in the swap's calldata: the quote's, or moved by this build's slippageBps

swapMode

string

required

Allowed value: "ExactIn"

slippageBps

integer

required

The slippage of this build's floor

routePlan

object[]

required

Show child attributes

simulation

passed · object

required

The approvals and the swap, executed in order at the build's block before you send anything

passed
failed
requires_approval
not_simulated

Show child attributes

costs

object

required

What the transactions cost besides the input, in wei as decimal strings; null where unknown

Show child attributes

spender

string | null

required

The venue's router the approvals are for, when the input is an ERC-20 swapped through a pool; null for a native input, a wrap or an unwrap

deadline

integer

required

Unix seconds: the swap reverts if mined later. The chain's deadlineSecs after the build (60 s; 180 s on eth)

chain

enum<string>

required

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

Available options:

eth,

bsc,

base,

robinhood

chainId

integer

required

contextSlot

integer

required

The block number the build was read and simulated at

blockHash

string

required

That block's hash

expiresAt

string<date-time>

required

The quote's expiry: until then it can be built again

Guides

Swap

Transactions

EVM

Launch

Operations

Build an EVM swap (/swap-instructions)

Authorizations

Body

Response