API

SuperSwap API Overview

The SuperSwap API allows you to access SuperSwap's swap functionality programmatically, without needing to interact with the user interface. With this API, you can:

• Generate a Quote:

Get an atomic quote for swapping between assets, allowing you to check the price of a trade before committing to it.

• Execute a Swap:

Receive the necessary call data to execute the swap directly from the API, without having to manually assemble the transaction.

This API provides a seamless, efficient way to check quotes and execute swaps, whether you're building a trading bot, integrating swaps into your platform, or simply wanting to check prices without interacting with the UI. It can also be used to anonymously check quotes, ensuring privacy.

Generate Quote

Quote a path for swapping between assets atomically. This can be used programmatically to check for a quoted price of a given trade without needing to wait for an assembled transaction to be created and provided. It can also be used to anonymously check quotes.

post

/quote

Body

tokenInTokenInrequired

Token address to swap from (NATIVE for eth).

tokenOutTokenOutrequired

Token address to swap to (NATIVE for eth).

slippageSlippagerequired

Slippage (%).

amountInAmountInrequired

Amount of token to swap in Float.

toTorequired

Address of wallet to receive swap

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.superswap.ink/api/quote' \
  --header 'Content-Type: application/json' \
  --data '{"tokenIn":"NATIVE","tokenOut":"0xbf0cAfCbaaF0be8221Ae8d630500984eDC908861","slippage":0.05,"amountIn":1,"to":"0x830bf0a3F01E493C3335E26dC2a3EA964C3CC4D8"}'

200

400

502

200

{
  "tokenIn": "text",
  "amountIn": "text",
  "tokenOut": "text",
  "amountOutMin": "text",
  "slippage": 1,
  "fee": 1,
  "calldata": "text",
  "value": "text"
}

Successful Response

Rate Limits

To ensure fair usage and prevent abuse, the SuperSwap API enforces the following rate limits:

• Free & Open Tier: Up to 30 requests per minute

• Custom Limits: For higher request limits, please contact us at [e-mail]

If you exceed the allowed limits, your requests may be temporarily blocked. To prevent disruptions, consider implementing retry logic with exponential backoff.