# Retrieve a price: /prices
## Get Price Route
`GET` `https://api.paraswap.io/prices`
This endpoint gets the optimal price and price route required to swap from one token to another.
You’ll find the parameters to build a successful query below:
#### Query Parameters
| Name | Type | Description |
| ---------------------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| srcToken\* | string | Source Token Address. Instead **Token Symbol** could be used for tokens listed in the `/tokens` endpoint. |
| srcDecimals\* | integer | Source Token Decimals. (Can be omitted if Token Symbol is used in `srcToken`). |
| destToken\* | string | Destination Token Address. Instead **Token Symbol** could be used for tokens listed in the `/tokens` endpoint. |
| amount\* | string | srcToken amount (in case of SELL) or destToken amount (in case of BUY).
The amount should be in WEI/Raw units (eg. 1WBTC -> 100000000)
|
| side | string | SELL or BUY.
Default: SELL.
|
| network | string | Network ID. (Mainnet - 1, Optimism - 10, BSC - 56, Polygon - 137, Base - 8453, Arbitrum - 42161, Avalanche - 43114, Gnosis - 100, Sonic - 146, Unichain - 130, Plasma - 9745).
Default: 1.
|
| otherExchangePrices | boolean | If provided, others object is filled in the response with price quotes from other exchanges (if available for comparison).
Default: false
|
| includeDEXS | string | Comma Separated List of DEXs to include.
All supported DEXs by chain can be found here
eg: UniswapV3, CurveV1
|
| excludeDEXS | string | Comma Separated List of DEXs to exclude.
All supported DEXs by chain can be found here
eg: UniswapV3, CurveV1
|
| excludeRFQ | boolean | Exclude all RFQs from pricing
eg: AugustusRFQ, Hashflow
Default: false
|
| includeContractMethods | string | Comma Separated List of Comma Separated List of Contract Methods to include in pricing (without spaces). View the list of the supported methods for [V5 ](https://developers.paraswap.network/api/master/api-v5#supported-methods)and [V6](https://developers.paraswap.network/api/master/api-v6.2#supported-methods) eg: `swapExactAmountIn,swapExactAmountInOnUniswapV2` |
| excludeContractMethods | string | Comma Separated List of Contract Methods to exclude from pricing (without spaces). View the list of the supported methods for [V5 ](https://developers.paraswap.network/api/master/api-v5#supported-methods)and [V6](https://developers.paraswap.network/api/master/api-v6.2#supported-methods) |
| userAddress | string | User's Wallet Address. |
| route | string | Dash (-) separated list of tokens (addresses or symbols from /tokens) to comprise the price route. Max 4 tokens.
\*Note: If route is specified, the response will only comprise of the route specified which might not be the optimal route.
|
| partner | string | Partner string.
If no partner is passed, it defaults to anon which charges a flat 1bps fee for all swaps. partner should be different from the existing ones that may charge indepent fees.
|
| destDecimals\* | integer | Destination Token Decimals. (Can be omitted if Token Symbol is used in `destToken`). |
| maxImpact | number | In %. It's a way to bypass the API price impact check (default = 15%). |
| receiver | String | Receiver's Wallet address. (Can be omitted if swapping tokens from and to same account) |
| srcTokenTransferFee | string | If the source token is a tax token, you should specify the tax amount in BPS.
\*For example: for a token with a 5% tax, you should set it to 500 as
\[(500/10000)\*100=5%]
\*\*Note: not all DEXs and contract methods support trading tax tokens, so we will filter those that don't.
|
| destTokenTransferFee | string | If the destination token is a tax token, you should specify the tax amount in BPS.
\*For example: for a token with a 5% tax, you should set it to 500 as
\[(500/10000)\*100=5%]
\*\*Note: not all DEXs and contract methods support trading tax tokens, so we will filter those that don't.
|
| srcTokenDexTransferFee | string | If the source token is a tax token, you should specify the tax amount in BPS.
Some tokens only charge tax when swapped in/out DEXs and not on ordinary transfers.
\*For example: for a token with a 5% tax, you should set it to 500 as
\[(500/10000)\*100=5%]
\*\*Note: not all DEXs and contract methods support trading tax tokens, so we will filter those that don't.
|
| destTokenDexTransferFee | string | If the destination token is a tax token, you should specify the tax amount in BPS.
Some tokens only charge tax when swapped in/out DEXs, not on ordinary transfers.
\*For example: for a token with a 5% tax, you should set it to 500 as
\[(500/10000)\*100=5%]
\*\*Note: not all DEXs and contract methods support trading tax tokens, so we will filter those that don't.
|
| version | number | To specify the protocol version. Values: 5 or 6.2
Default: 5
|
| excludeContractMethodsWithoutFeeModel | boolean | Specify that methods without fee support should be excluded from the price route. Default: `false` |
| ignoreBadUsdPrice | boolean | If tokens USD prices are not available, `Bad USD Price` error will be thrown. Use this param to skip this check. Default: `false` |
Here are two examples of a successful price response and a failed query.
The first query was a sell price request on Ethereum Mainnet (chainId: 1) using Velora's Market API. The request aimed to swap 1,000 USDC for ETH (destToken: 0xeeee...eeee) while retrieving the best possible route for the trade.
As a result, it successfully retrieved an optimized route for swapping 1,000 USDC to ETH via Uniswap V3, with minimal slippage and efficient execution while estimating gas costs.
{% tabs %}
{% tab title="200 Successful Price Response." %}
```
{
"priceRoute": {
"blockNumber": 19462957,
"network": 1,
"srcToken": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"srcDecimals": 6,
"srcAmount": "1000000000",
"destToken": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"destDecimals": 18,
"destAmount": "283341969876959340",
"bestRoute": [
{
"percent": 100,
"swaps": [
{
"srcToken": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"srcDecimals": 6,
"destToken": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
"destDecimals": 18,
"swapExchanges": [
{
"exchange": "UniswapV3",
"srcAmount": "1000000000",
"destAmount": "283341969876959340",
"percent": 100,
"poolAddresses": [
"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640"
],
"data": {
"path": [
{
"tokenIn": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"tokenOut": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
"fee": "500",
"currentFee": "500"
}
],
"gasUSD": "13.515820"
}
}
]
}
]
}
],
"gasCostUSD": "14.656605",
"gasCost": "118200",
"side": "SELL",
"version": "6.2",
"contractAddress": "0x6a000f20005980200259b80c5102003040001068",
"tokenTransferProxy": "0x6a000f20005980200259b80c5102003040001068",
"contractMethod": "swapExactAmountInOnUniswapV3",
"partnerFee": 0,
"srcUSD": "999.4370000000",
"destUSD": "1003.8267642998",
"partner": "anon",
"maxImpactReached": false,
"hmac": "7975cda2fd343cb90f1a15d1ec11302c467a8d7d"
}
}
```
{% endtab %}
{% tab title="400 Price Error" %}
```
{
"error": "Validation failed with error"
}
```
{% endtab %}
{% endtabs %}
#### Most common error messages
The following is a list of the most common error messages of the `/prices` endpoint. Most are self-explanatory and can be self-solved, but feel free to contact Velora Support using the chat in the bottom right corner of this page.
* `Invalid route, from token should be the first token of the route`
* `Invalid route, to token should be the last token of the route`
* `Token not found. Please pass srcDecimals & destDecimals query params to trade any tokens` -Check the doc for more details
* `Invalid tokens` - (srcToken and destToken) or (route) params are not passed
* `If receiver is defined userAddress should also be defined`
* `It is not allowed to pass both params: "positiveSlippageToUser" and "takeSurplus".` - We advice removing "positiveSlippageToUser", because it is deprecated
* `excludeDirectContractMethods param is deprecated, please use excludeContractMethodsWithoutFeeModel for newer versions`
* `Invalid Amount` - amount param is not a valid number
* `Validation failed: ` - params validation failed (message has the exact reason for failure)
* `Price Timeout` - reverts when a query takes more time than expected
* `No routes found with enough liquidity`
* `Bad USD price`  - src or dest tokens don’t have valid usd price
* `Estimated_loss_greater_than_max_impact`
* `Internal Error while computing the price` - something went wrong during the price route calculation
* `Invalid max USD impact` - maxUSDImpact is not a valid number
* `Error while handling price request` - something went wrong during the price route calculation
\