Request quote

Provide a quote inquiry endpoint for users to inform users of currency transaction information and currency exchange range.

Note

Note: If the value filled in by the user is outside the convertible range, in order to avoid user losses, please remind the user to change the swap value

Endpoint usage

POST https://sswap.swft.pro/api/sswap/quote

The fields with * are required, and the fields without * are optional

Request Body

NameTypeDescription

equipmentNo*

String

Equipment number(This field will be used as the unique identifier of the user, and the third parties can obtain it on their own, such as the first 32 characters of fromAddress, or a string of 32 random numbers and letters)

sourceType

String

Device type (H5/IOS/Android The field is optional, if it is requested directly through the API, it can be empty)

sourceFlag*

String

Source channel (Both sides need to agree on a name to represent the channel of the third parties)

fromTokenAddress*

String

Contract address for the token to sell (It can be obtained from the address field in the currency list)

toTokenAddress*

String

Contract address for the token to receive (It can be obtained from the address field in the currency list)

fromTokenAmount*

String

Amount of token to sell

fromTokenChain*

String

Network of the token to sell (It can be obtained from the chain field in the currency list, For details of the support chain, please refer to [Basic information])

toTokenChain*

String

Network of the token to received (It can be obtained from the chain field in the currency list, For details of the support chain, please refer to [Basic information])

userAddr

String

User address

{
 "resCode":"100",
 "resMsg":"Success",
 "data":{
  "txData":{
   "amountOutMin": 5055580656532273000// Amount of token to receive (WEI version)
   "chainFee":"0.02" // Gas fee
   "contractAddress":"0x6b4427caa371627e2a73521a2568fcf1212cd4d9", // Contract Address
   "depositMin": 30, // minimum swap value
   "depositMax": 21738659651027.298142, // maximum swap value
   "dex":"Bridgers1",
   "fee":0.002, // Processing fee ratio 
   "feeToken":"",
   "fromTokenAmount":"47079490000000000000",
   "fromTokenDecimal":18,
   "toTokenAmount":"5.0555806565",  // Estimated amount to receive
   "toTokenDecimal":18,
   "path":["0x55d398326f99059ff775485246999027b3197955","0x6b4427caa371627e2a73521a2568fcf1212cd4d9","0xa71edc38d189767582c38a3145b5873052c3e47a"],
   "logoUrl":"https://images.swft.pro/dex/sSwap.png",
  }
 }
}

Code example

// quote example
 const params = {
   fromTokenAddress: '0x55d398326f99059ff775485246999027b3197955',
   toTokenAddress: '0xa71edc38d189767582c38a3145b5873052c3e47a',
   fromTokenAmount: '8000000000000000000',
   fromTokenChain: 'BSC',
   toTokenChain: 'HECO',
   userAddr: '0x...', //your wallet address
   equipmentNo:'', // your equipment number
   sourceFlag:'widget',
   sourceType:'H5',
  }
  const res = await axios.post('https://sswap.swft.pro/api/sswap/quote',params)
  console.log(res)

Postman example

Last updated