Quote API

Get a token pair exchange rate

Get the exchange rate for two assets on a specific provider. This is a development endpoint and is not intended for production use.

get

/aggregator/tokens/quote/pairPrice

Query parameters

sellAssetstringrequired

Token to sell (e.g. ETH.UNI-0x1f9840a85d5af5bf1d1762f925bdaddc4201f984)

buyAssetstringrequired

Token to buy (e.g. BTC.BTC)

providerstring · enumrequired

The provider to query

Options: UNISWAPV2, UNISWAPV3, THORCHAIN, ZEROX, ONEINCH, SUSHISWAP

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.thorswap.net/aggregator/tokens/quote/pairPrice?sellAsset=text&buyAsset=text&provider=UNISWAPV2'

200

200

text

The exchange rate

Get quote for a swap

Get a quote to swap between Native Coin - ERC20 - Avax ERC20

get

/aggregator/tokens/quote

Query parameters

sellAssetstringrequired

Asset to sell. (e.g. ETH.UNI-0x1f9840a85d5af5bf1d1762f925bdaddc4201f984)

buyAssetstringrequired

Asset to buy. (e.g. BTC.BTC)

sellAmountnumberrequired

Amount of sellAsset to sell in assetAmount. (e.g. 100 for 100 UNI)

slippagenumber · default: 5

Slippage tolerance as a percentage. (e.g. 3 means 3% max slippage)

limitnumber · default: 5

The maximum number of trades routes to return. (e.g. 5)

senderAddressstring

The senderAddress to be used to build calldata. (e.g. 0x2A1Af1d52641b9B595dbafFe36452d325E6cA103)

recipientAddressstring

The recipientAddress may be used to build the tcMemo. If you don't provide a recipientAddress, your calldata may be invalid and you may need to replace {recipientAddress} in the memo field. (e.g. 0x2A1Af1d52641b9B595dbafFe36452d325E6cA103)

providersstring · enum[] · default: THORCHAIN,UNISWAPV2,UNISWAPV3,THORCHAIN,ZEROX,ONEINCH,SUSHISWAP

Restrict liquidity sources. THORCHAIN provider must be set for cross-chain quotes

subProvidersstring[] · default:

Restrict sources of the providers.

preferredProviderstring · enum

Optionally specify the provider the swap should use.

Options: UNISWAPV2, UNISWAPV3, THORCHAIN, ZEROX, ONEINCH, SUSHISWAP

affiliateAddressstring

The affiliate thorname to receive the affiliate fee. Must be 10 chars or less, the shorter the better. (e.g. partner1)

affiliateBasisPointsnumber · max: 100

Basis point to take from the trade (e.g. 50 for 0.5%)

isAffiliateFeeFlatboolean

If set to true, the API will adjust the memo so that the total affiliate fees, including smart contract, are as close as possible to the provided affiliateBasisPoints

allowSmartContractRecipientboolean

If set to true, we will not perform any safety checks on the recipient address on an EVM chain. This is risky, and funds will likely be lost. For more information https://docs.thorswap.net/aggregation-api/pathfinder#smart-contract-addresses

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://dev-api.thorswap.net/aggregator/tokens/quote?sellAsset=text&buyAsset=text&sellAmount=1'

200

400

500

200

{
  "routes": [
    {
      "path": "text",
      "expectedOutput": "text",
      "expectedOutputMaxSlippage": "text",
      "optimal": true,
      "complete": true,
      "calldata": {
        "tcRouter": "text",
        "tcVault": "text",
        "tcMemo": "text",
        "token": "text",
        "amount": "text",
        "amountOutMin": "text",
        "deadline": "text"
      },
      "contract": "text",
      "contractInfo": "text",
      "inboundAddress": "text",
      "targetAddress": "text",
      "providers": [
        "text"
      ],
      "subProviders": [
        "text"
      ],
      "swaps": [
        {
          "path": "text",
          "provider": "text",
          "from": "text",
          "to": "text",
          "order": 1
        }
      ]
    }
  ]
}

A complete quote response with calldata