Get Quote

curl --request GET \
  --url https://api-v2.swaps.xyz/api/getQuote \
  --header 'x-api-key: <api-key>'

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

fetch('https://api-v2.swaps.xyz/api/getQuote', 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-v2.swaps.xyz/api/getQuote",
  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://api-v2.swaps.xyz/api/getQuote"

	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://api-v2.swaps.xyz/api/getQuote")

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

{
  "vmId": "evm",
  "amountIn": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountInMax": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountOut": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountOutMin": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "protocolFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "applicationFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "exchangeRate": 123,
  "estimatedTxTime": 123,
  "estimatedPriceImpact": 123,
  "requiresTokenApproval": true,
  "requiresRegisterTransaction": true,
  "bridgeFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "relayerFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  }
}

Core

Get Quote

Returns a non-binding reference price for a cross-chain swap. Unlike GET /getAction, this endpoint never allocates a deposit address, builds transaction calldata, or triggers wallet-screening checks — it’s priced-only, safe to call at high frequency (e.g. to refresh a quote widget), and always uses swap-action semantics regardless of any actionType you pass.

sender and recipient are not accepted as inputs — the endpoint prices the route using internal placeholder addresses, since no transaction is produced. If you need a signable transaction, use GET /getAction instead.

GET

getQuote

Get Quote

curl --request GET \
  --url https://api-v2.swaps.xyz/api/getQuote \
  --header 'x-api-key: <api-key>'

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

fetch('https://api-v2.swaps.xyz/api/getQuote', 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-v2.swaps.xyz/api/getQuote",
  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://api-v2.swaps.xyz/api/getQuote"

	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://api-v2.swaps.xyz/api/getQuote")

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

{
  "vmId": "evm",
  "amountIn": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountInMax": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountOut": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "amountOutMin": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "protocolFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "applicationFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "exchangeRate": 123,
  "estimatedTxTime": 123,
  "estimatedPriceImpact": 123,
  "requiresTokenApproval": true,
  "requiresRegisterTransaction": true,
  "bridgeFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  },
  "relayerFee": {
    "chainId": 123,
    "address": "<string>",
    "name": "<string>",
    "symbol": "<string>",
    "decimals": 123,
    "isNative": true,
    "amount": "<string>",
    "logo": "<string>",
    "swapsXyzCode": "<string>",
    "usdAmount": 123
  }
}

Authorizations

x-api-key

string

header

required

Limited demo key for API Reference: 5c951bc81da566bbd030ba8e20724063.

Query Parameters

srcChainId

integer

required

Source chain ID Chain ID. Find in the list of supported networks.

srcToken

string

required

Source token address. Use native for the chain's native asset. Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.

dstChainId

integer

required

Destination chain ID Chain ID. Find in the list of supported networks.

dstToken

string

required

Destination token address. Use native for the chain's native asset. Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.

amount

string

required

The exact in or exact out amount of the swap, in the source or destination token's base units respectively.

Pattern: ^[0-9]+$

swapDirection

enum<string>

required

Whether amount is an exact input or exact output amount. Swap direction for the action.

Available options:

exact-amount-in,

exact-amount-out

slippage

number<float>

default:50

Slippage tolerance in bps. Defaults to 50 (0.5%) if omitted — unlike GET /getAction, where this parameter is required.

Required range: 0 <= x <= 10000

bridgeIds

string[]

Specific bridge protocols to use

Optional: Will default to all available protocols

Bridge protocol identifier (e.g. "across", "relay", "mayan").

refundTo

string

Alternate address the reference route would refund to

Optional: Will default to an internal placeholder address Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.

Solana address that would pay for tx fees and rent (e.g. ATA creation) if this quote were later executed. Only used for Solana same-chain swaps. Address type - can be EvmAddress, HyperCoreAddress, SolanaAddress, or AltVmAddress.

returnDepositAddress

boolean

default:false

Restrict the priced route universe to deposit-address-based flows

Optional: Set to true to price against the deposit-address strategy set

dstGas

string

Extra gas to deliver on the destination chain, factored into the reference price

Optional

Pattern: ^[0-9]+$

appFees

string

Application fees configuration as JSON array

Optional: Will default to fees configured for the application

Example: [{ "bps": 50, "receiverAddress": "0x..." }]

gasless

boolean

default:false

Price the route as if gasless execution were requested.

Optional: Has limited effect on this endpoint's response — executions/executionsType are never returned by getQuote, so this mainly affects fee computation, not the response shape.

skipCache

boolean

Bypass the internal quote cache and re-price against live routes.

Optional: Presence, not value, is checked — passing skipCache=false still skips the cache. Omit the parameter entirely to use the cache.

Response

Successful response with a reference-price quote

vmId

enum<string>

required

Virtual machine identifier.

Available options:

evm,

solana,

alt-vm,

hypercore

amountIn

object

required

Expected amount to input (exclusive of slippage - recommended value to display in frontend)

Show child attributes

amountInMax

object

required

Maximum amount to input (inclusive of slippage)

Show child attributes

amountOut

object

required

Expected amount delivered to users (exclusive of slippage - recommended value to display in frontend)

Show child attributes

amountOutMin

object

required

Minimum amount delivered to users (inclusive of slippage)

Show child attributes

protocolFee

object

required

Swaps.xyz fee

Show child attributes

applicationFee

object

required

Application fee (your fee!)

Show child attributes

exchangeRate

number<float>

required

Exchange rate for the swap.

estimatedTxTime

number<float>

required

Estimated transaction time in seconds.

estimatedPriceImpact

number<float>

required

Estimated price impact percentage.

requiresTokenApproval

boolean

required

Flag indicating whether executing this route later would require a source token approval check.

requiresRegisterTransaction

boolean

required

Flag indicating whether executing this route later would require registration via the registerTxs endpoint. Mandatory for non-EVM transactions.

bridgeFee

object

Bridge fee (from aggregated providers). Only present when the reference route crosses a bridge.

Show child attributes

relayerFee

object

Fee charged by a gasless relay provider, denominated in USDT. Rarely populated on this endpoint since executionsType/executions are not returned here — present mainly for schema parity with GET /getAction.

Show child attributes

Getting Started

Core

Gasless

Data

Utilities

Get Quote

Authorizations

Query Parameters

Response