Retrieve Delta price with fallback to Market

This endpoint is also available in Paraswap SDK. You can find example usage here.

Get Delta Price with fallback to Market

GET https://api.paraswap.io/quote

This endpoint gets the Delta price and with ability to fallback to market prices.

Query Parameters

Name

Type

Description

srcToken*

string

Source Token Address.

srcDecimals*

integer

Source Token Decimals.

destToken*

string

Destination Token Address.

destDecimals*

integer

Destination Token Decimals.

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

SELL | BUY

Default: SELL.

chainId*

string

Chain ID. (Mainnet - 1, Optimism - 10, BSC - 56, Polygon - 137, Fantom - 250, zkEVM - 1101, Base - 8453, Arbitrum - 42161, Avalanche - 43114, Gnosis - 100).

userAddress

string

User's Wallet Address.

partner

string

Partner string.

mode

ALL | DELTA | MARKET

Preferred mode for the trade. In case of "all", Delta pricing is returned, with Market as a fallback. Default: ALL.

Query Modes Explained

The endpoint behaves differently based on the mode passed:

DELTA - will return the Delta pricing data in the delta field, which can then be used to build, sign and submit a Delta Order.
MARKET - will return the Market pricing data in the market field , which is an equivalent to the successful response from /prices?version=6.2 of the Paraswap API, which can then be used to build a swap transaction.
ALL - default mode. Will return the Delta pricing data in the delta field. In case the Delta prices are unavailable, fallback to MARKET mode and returns the Market pricing data. Also specifies the fallback reason in fallbackReason field. Refer here for example of usage of this mode.

Examples for Successful Responses for each mode.

{
    "delta": {
        "srcToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "destToken": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "srcAmount": "1000000000000000000",
        "destAmount": "3086837366586070760141",
        "destAmountBeforeFee": "3107438280392627995443",
        "gasCostUSD": "20.600749",
        "gasCost": "435040",
        "srcUSD": "3105.5700000000",
        "destUSD": "3086.8126718864",
        "destUSDBeforeFee": "3107.4134208864",
        "gasCostBeforeFee": "154200",
        "gasCostUSDBeforeFee": "7.301939",
        "partner": "paraswap.io",
        "partnerFee": 0,
        "hmac": "43ca1b6aaed09f892daf87c332a840caac7c6f23"
    }
}

{
    "fallbackReason": {
        "errorType": "UnsupportedToken",
        "details": "Token 0xa4bc2b90743294e5e6fd3321a9a131947f7785db is not supported"
    },
    "market": {
        "blockNumber": 21222968,
        "network": 1,
        "srcToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "srcDecimals": 18,
        "srcAmount": "1000000000000000000",
        "destToken": "0xa4bc2b90743294e5e6fd3321a9a131947f7785db",
        "destDecimals": 9,
        "destAmount": "1106884085431",
        "bestRoute": [
            {
                "percent": 100,
                "swaps": [
                    {
                        "srcToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                        "srcDecimals": 18,
                        "destToken": "0xa4bc2b90743294e5e6fd3321a9a131947f7785db",
                        "destDecimals": 9,
                        "swapExchanges": [
                            {
                                "exchange": "UniswapV2",
                                "srcAmount": "1000000000000000000",
                                "destAmount": "1106884085431",
                                "percent": 100,
                                "poolAddresses": [
                                    "0x98555273b697fA2b4CF3e009403B5ae31Fd2C7A1"
                                ],
                                "data": {
                                    "router": "0xF9234CB08edb93c0d4a4d4c70cC3FfD070e78e07",
                                    "path": [
                                        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                                        "0xa4bc2b90743294e5e6fd3321a9a131947f7785db"
                                    ],
                                    "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
                                    "initCode": "0x96e8ac4277198ff8b6f785478aa9a39f403cb768dd02cbee326c3e7da348845f",
                                    "feeFactor": 10000,
                                    "pools": [
                                        {
                                            "address": "0x98555273b697fA2b4CF3e009403B5ae31Fd2C7A1",
                                            "fee": 30,
                                            "direction": false
                                        }
                                    ],
                                    "gasUSD": "5.896714"
                                }
                            }
                        ]
                    }
                ]
            }
        ],
        "gasCostUSD": "9.771593",
        "gasCost": "132570",
        "side": "SELL",
        "version": "6.2",
        "contractAddress": "0x6a000f20005980200259b80c5102003040001068",
        "tokenTransferProxy": "0x6a000f20005980200259b80c5102003040001068",
        "contractMethod": "swapExactAmountInOnUniswapV2",
        "partnerFee": 0,
        "srcUSD": "3102.2276074900",
        "destUSD": "3121.4131209154",
        "partner": "paraswap.io",
        "maxImpactReached": false,
        "hmac": "b9c7c2ed6a47c98af2a835184a64db4a50fc2b61"
    }
}

{
    "market": {
        "blockNumber": 21222968,
        "network": 1,
        "srcToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "srcDecimals": 18,
        "srcAmount": "1000000000000000000",
        "destToken": "0xa4bc2b90743294e5e6fd3321a9a131947f7785db",
        "destDecimals": 9,
        "destAmount": "1106884085431",
        "bestRoute": [
            {
                "percent": 100,
                "swaps": [
                    {
                        "srcToken": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                        "srcDecimals": 18,
                        "destToken": "0xa4bc2b90743294e5e6fd3321a9a131947f7785db",
                        "destDecimals": 9,
                        "swapExchanges": [
                            {
                                "exchange": "UniswapV2",
                                "srcAmount": "1000000000000000000",
                                "destAmount": "1106884085431",
                                "percent": 100,
                                "poolAddresses": [
                                    "0x98555273b697fA2b4CF3e009403B5ae31Fd2C7A1"
                                ],
                                "data": {
                                    "router": "0xF9234CB08edb93c0d4a4d4c70cC3FfD070e78e07",
                                    "path": [
                                        "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
                                        "0xa4bc2b90743294e5e6fd3321a9a131947f7785db"
                                    ],
                                    "factory": "0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f",
                                    "initCode": "0x96e8ac4277198ff8b6f785478aa9a39f403cb768dd02cbee326c3e7da348845f",
                                    "feeFactor": 10000,
                                    "pools": [
                                        {
                                            "address": "0x98555273b697fA2b4CF3e009403B5ae31Fd2C7A1",
                                            "fee": 30,
                                            "direction": false
                                        }
                                    ],
                                    "gasUSD": "5.896714"
                                }
                            }
                        ]
                    }
                ]
            }
        ],
        "gasCostUSD": "9.771593",
        "gasCost": "132570",
        "side": "SELL",
        "version": "6.2",
        "contractAddress": "0x6a000f20005980200259b80c5102003040001068",
        "tokenTransferProxy": "0x6a000f20005980200259b80c5102003040001068",
        "contractMethod": "swapExactAmountInOnUniswapV2",
        "partnerFee": 0,
        "srcUSD": "3102.2276074900",
        "destUSD": "3121.4131209154",
        "partner": "paraswap.io",
        "maxImpactReached": false,
        "hmac": "b9c7c2ed6a47c98af2a835184a64db4a50fc2b61"
    }
}

{
    "errorType": "UnsupportedToken",
    "details": "Token 0xa4bc2b90743294e5e6fd3321a9a131947f7785db is not supported"
}

Most common fallback reasons and error types

The following is a list of the most common error messages and fallback reasons of the /delta/quote endpoint. Most are self-explanatory and can be self-solved, but feel free to contact ParaSwap Support using the chat in the bottom right corner of this page.

ValidationError - validation for params failed
UnsupportedChain - the chain ID is not supported by Delta.
UnsupportedToken - the token is not supported by Delta.
SourceEth - Native chain token cannot be used as source token in Delta.
UnsupportedSide - BUY is not supported by Delta yet.
PricingError - internal oracle failed to provide a price.
GasCostExceedsTradeAmount - estimated value paid for gas is bigger than trade amount.

Last updated 18 days ago