Skip to main content
GET
/
prices
Get a Market route for a token pair
curl --request GET \
  --url https://api.velora.xyz/prices
{
  "priceRoute": {
    "blockNumber": 123,
    "network": 1,
    "srcToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "srcDecimals": 123,
    "srcAmount": "1000000000000000000",
    "destToken": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "destDecimals": 123,
    "destAmount": "1000000000000000000",
    "bestRoute": [
      {}
    ],
    "gasCostUSD": "<string>",
    "gasCost": "<string>",
    "version": "<string>",
    "contractAddress": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "tokenTransferProxy": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "contractMethod": "<string>",
    "partnerFee": 123,
    "srcUSD": "<string>",
    "destUSD": "<string>",
    "partner": "<string>",
    "maxImpactReached": true,
    "hmac": "<string>"
  }
}
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.

Last modified on June 14, 2026