ParaSwapUser Documentation

API v6.2

Introduction to ParaSwap API v6.2

ParaSwap v6.2 has been released! See what's new here: https://twitter.com/paraswap/status/1803435422011498551

To switch to v6.2, you only need to pass &version=6.2 to /prices & you're good to go!

ParaSwap V6.2's main goal is to provide the best possible gas-optimized protocol for order routing. It has significant improvements in terms of smart contract architecture that achieve both best-in-class gas efficiency and scalability through modularity.

To use V6.2, you need to pass &version=6.2 query param when calling /prices. The process for swapping remains the same:

  • Call GET /prices to retrieve an optimal price for a given pair & amount.

  • Call POST /transactions for retrieving the Transaction Object that includes the call data

  • Alternatively, you can use GET /swap to retrieve both the price config & Transaction Object.

You can also use the JavaScript/TypeScript SDK for easier integrations: https://github.com/paraswap/paraswap-sdk

  • No longer need to approve a different smart contract for ERC20 tokens. Augustus V6.2 is the only contract you need to interact with. More details here.

  • More control over partner fees: should you choose to take a surplus fee, you can cap it to 1% of the trade volume as protection for your users if it applies to your specific case. You can also send partner fees directly to the user. Take a look at the new params (isCapSurplus , isSurplusToUser , isDirectFeeTransfer) params in /transactions section.

  • Flat fees are capped at 2% as a security protection for users.

  • excludeDirectContractMethods is no longer supported in /prices. It has been replaced by excludeContractMethodsWithoutFeeModel, which ensures all swaps can be monetized.

Supported methods:

SELL:

  • swapExactAmountIn

  • swapExactAmountInOnUniswapV2

  • swapExactAmountInOnUniswapV3

  • swapExactAmountInOnBalancerV2

  • swapExactAmountInOnCurveV1

  • swapExactAmountInOnCurveV2

  • swapOnAugustusRFQTryBatchFill

  • swapExactAmountInOutOnMakerPSM

BUY:

  • swapExactAmountOut

  • swapExactAmountOutOnUniswapV2

  • swapExactAmountOutOnUniswapV3

  • swapExactAmountOutOnBalancerV2

  • swapOnAugustusRFQTryBatchFill

  • swapExactAmountInOutOnMakerPSM

Last updated