Get Market price route

Get a Market route for a token pair

curl --request GET \
  --url https://api.velora.xyz/prices

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velora.xyz/prices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.velora.xyz/prices"

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

	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.velora.xyz/prices")

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

request = Net::HTTP::Get.new(url)

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

{
  "priceRoute": {
    "blockNumber": 123,
    "network": 1,
    "srcToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "srcDecimals": 123,
    "srcAmount": "1000000000000000000",
    "destToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "destDecimals": 123,
    "destAmount": "1000000000000000000",
    "bestRoute": [
      {}
    ],
    "gasCostUSD": "<string>",
    "gasCost": "<string>",
    "side": "SELL",
    "version": "<string>",
    "contractAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "tokenTransferProxy": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "contractMethod": "<string>",
    "partnerFee": 123,
    "srcUSD": "<string>",
    "destUSD": "<string>",
    "partner": "<string>",
    "maxImpactReached": true,
    "hmac": "<string>"
  }
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

GET

prices

Get a Market route for a token pair

curl --request GET \
  --url https://api.velora.xyz/prices

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.velora.xyz/prices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$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.velora.xyz/prices"

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

	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.velora.xyz/prices")

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

request = Net::HTTP::Get.new(url)

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

{
  "priceRoute": {
    "blockNumber": 123,
    "network": 1,
    "srcToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "srcDecimals": 123,
    "srcAmount": "1000000000000000000",
    "destToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "destDecimals": 123,
    "destAmount": "1000000000000000000",
    "bestRoute": [
      {}
    ],
    "gasCostUSD": "<string>",
    "gasCost": "<string>",
    "side": "SELL",
    "version": "<string>",
    "contractAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "tokenTransferProxy": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "contractMethod": "<string>",
    "partnerFee": 123,
    "srcUSD": "<string>",
    "destUSD": "<string>",
    "partner": "<string>",
    "maxImpactReached": true,
    "hmac": "<string>"
  }
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

{
  "errorType": "PricingError",
  "details": "Error getting price data"
}

Looking for a single endpoint that returns either a Market route or a Delta intent? Call GET /v2/quote with mode=ALL; see Trading modes.

Query Parameters

srcToken

string

required

Source token address. A token symbol listed in /tokens can be used instead. Example uses ETH. EVM address (20 bytes, hex-encoded with 0x prefix). Use the mixed-case placeholder 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

srcDecimals

integer

Source token decimals. Can be omitted if a token symbol is used in srcToken.

destToken

string

required

Destination token address. A token symbol listed in /tokens can be used instead. Example uses USDC. EVM address (20 bytes, hex-encoded with 0x prefix). Use the mixed-case placeholder 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

destDecimals

integer

Destination token decimals. Can be omitted if a token symbol is used in destToken.

amount

string

required

srcToken amount (SELL) or destToken amount (BUY), in WEI/raw units. Token amount in WEI / raw units (no decimal point). Serialized as a string to preserve precision for amounts that exceed JavaScript Number range.

Example:

"1000000000000000000"

side

enum<string>

default:SELL

Available options:

SELL,

BUY

network

integer

EVM chain ID. Default: 1 (Mainnet). Market uses network for this parameter; Delta uses chainId — both are EVM chain IDs. EVM chain ID. Supported values today include 1 (Mainnet), 10 (Optimism), 56 (BSC), 137 (Polygon), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche), 100 (Gnosis). The set is open — call GET /chains for the live list.

Example:

1

otherExchangePrices

boolean

default:false

If true, the response includes price quotes from other exchanges in an others object.

includeDEXS

string

Comma-separated list of DEXs to include.

excludeDEXS

string

Comma-separated list of DEXs to exclude.

excludeRFQ

boolean

default:false

Exclude all RFQ liquidity from pricing.

includeContractMethods

string

Comma-separated list of contract methods to include.

excludeContractMethods

string

Comma-separated list of contract methods to exclude.

userAddress

string

End-user wallet address. EVM address (20 bytes, hex-encoded with 0x prefix). Use the mixed-case placeholder 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

route

string

Dash-separated list of tokens for the price route. Max 4 tokens.

partner

string

default:anon

Partner string. Defaults to anon which charges 1bps fee for all swaps.

maxImpact

number

Bypass API price-impact check (default = 15%). Value in %.

receiver

string

Receiver wallet address. Omit when swapping from/to the same account. EVM address (20 bytes, hex-encoded with 0x prefix). Use the mixed-case placeholder 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE for native ETH.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"

srcTokenTransferFee

string

Tax in basis points charged on srcToken transfers.

destTokenTransferFee

string

Tax in basis points charged on destToken transfers.

srcTokenDexTransferFee

string

Tax in BPS charged only on DEX swaps for srcToken.

destTokenDexTransferFee

string

Tax in BPS charged only on DEX swaps for destToken.

version

enum<string>

default:5

Protocol version. Always pass 6.2 (Augustus v6.2, what these docs cover); when omitted the API falls back to the legacy v5 router.

Available options:

5,

6.2

excludeContractMethodsWithoutFeeModel

boolean

default:false

Exclude contract methods that don't support the fee model.

ignoreBadUsdPrice

boolean

default:false

Skip the USD-price availability check.

Response

Market route. Calldata-ready against Augustus v6.2 when version=6.2.

GET /prices envelope.

priceRoute

object

Market route block. Calldata-ready against Augustus v6.2 when version=6.2.

Show child attributes

Last modified on June 14, 2026

Get started

Delta API

Market API

OTC API

Get Market price route

Query Parameters

Response