curl --request POST \
  --url https://router.raze.bot/evm/swap \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userPublicKey": "0x000000000000000000000000000000000000dEaD",
  "quoteResponse": {
    "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": 52397013,
    "timeTaken": 0.036435373,
    "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87",
    "chain": "base",
    "chainId": 8453,
    "router": "0x2626664c2603336e57b271c5c0b26f421741e481",
    "gasEstimate": "132900",
    "blockHash": "0x94b181d0afdb8e403980c281785a1d2d3df7a2cd0296551ec976fc907fe84233",
    "expiresAt": "2026-10-09T22:03:09.343704617Z",
    "candidates": 5
  }
}
'

{
  "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"
}

EVM

Build an EVM swap

The unsigned transactions that execute a quote for userPublicKey: the approvals it needs (setupTransactions), then the swap (swapTransaction), simulated together. Send the quote back unchanged as quoteResponse, as to the Solana router or to Jupiter.

Which quote is built, in this order:

quoteResponse: the stored quote its quoteId names. The router builds only quotes it made and still holds, until their expiresAt, as many times as you like; the route, the amounts, the spender and the calldata come from the stored quote, never from the body. A chain, inputMint, outputMint, inAmount, outAmount, otherAmountThreshold or slippageBps in quoteResponse that differs from the stored quote is 400 quote_mismatch (a new slippage goes in the top-level slippageBps), and so is a top-level chain, inputMint, outputMint or amount that differs. A quoteResponse without quoteId is 400 bad_request.
quoteId at the top level: the same, without sending the quote.
Otherwise the quote parameters at the top level (chain, inputMint, outputMint, amount and the rest of POST /evm/quote): quoted now and built in the same call.

slippageBps moves the floor for this build only, from the quote’s outAmount (10000 leaves a zero floor: 422 declined amount_too_small); a wrap or an unwrap keeps its 1:1 floor.

At the build. At a fresh block the router prices the quoted route again and reads the sender’s balance and allowance. If the route now gives less than otherAmountThreshold, the answer is 409 declined quote_stale with what it gives now (outAmount, null when it no longer executes): the floor is never lowered, quote again. Otherwise:

setupTransactions, to send first and in order: approve(spender, inAmount) on the input token, exact, to the venue’s router (spender). A smaller allowance already in place gets an approve(spender, 0) first, for tokens like USDT that refuse a change from one non-zero allowance to another. Empty with a native input, for a wrap or an unwrap, and when the allowance already covers inAmount.
swapTransaction: the floor is in its calldata (amountOutMin, amountOutMinimum, and unwrapWETH9(minimum, recipient) when the output is native) with deadline, in Unix seconds (60 seconds after the build; 180 on eth). value is inAmount when the input is native, otherwise "0". A V3 swap with native input ends with refundETH(): whatever a pool does not take goes back to the sender in the same transaction.
simulation: the approvals and the swap executed in order at the build’s block (eth_simulateV1), between reads of the sender’s input balance and the recipient’s output balance. passed needs exactly inAmount consumed and at least otherAmountThreshold arrived. It does not check nonces, nor that the sender can pay for gas.
gas on each transaction only when the simulation passed: the gas it used × the chain’s headroom (120%; 130% on robinhood). maxFeePerGas and maxPriorityFeePerGas on each when the router could read the chain’s fees. costs adds them up.

Approvals and swap are separate transactions, not atomic. Sign them with the key of userPublicKey and send them in order (each after the previous one is mined, or with consecutive nonces) before deadline. Wrap and unwrap credit the sender: there destinationTokenAccount must equal userPublicKey (422 declined recipient_unsupported).

Fee-on-transfer, rebasing and honeypot tokens are not supported: their builds fail in simulation (output_below_minimum, partial_fill, swap_reverted).

Differences from the Solana POST /swap: transactions instead of instructions, always returned (no serialize); only a quote this router holds is built, and quoteResponse must match it; destinationTokenAccount is the address that receives the output; no platform fee (feeBps above 0 is 400); priority-fee and tip fields are ignored (the fees are in swapTransaction); extra fields simulation, costs (in wei), spender, deadline, chain, chainId, blockHash, expiresAt; errors carry no quoteId.

POST

evm

swap

curl --request POST \
  --url https://router.raze.bot/evm/swap \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "userPublicKey": "0x000000000000000000000000000000000000dEaD",
  "quoteResponse": {
    "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": 52397013,
    "timeTaken": 0.036435373,
    "quoteId": "b00fb006-1e11-4498-9d81-6d5d0857ef87",
    "chain": "base",
    "chainId": 8453,
    "router": "0x2626664c2603336e57b271c5c0b26f421741e481",
    "gasEstimate": "132900",
    "blockHash": "0x94b181d0afdb8e403980c281785a1d2d3df7a2cd0296551ec976fc907fe84233",
    "expiresAt": "2026-10-09T22:03:09.343704617Z",
    "candidates": 5
  }
}
'

{
  "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"
}

Guide: EVM swaps: approvals, native coin, gas and fees, and what to do with each simulation status. Errors: EVM errors.

The approvals (setupTransactions) and the swap (swapTransaction) are separate transactions, not atomic. Send them in the order given, the approvals first, from userPublicKey, and the swap before deadline.

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

Authorizations

Body

Response