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://api.bridgers.xyz/api/sswap/quote

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

Request Body

Name	Type	Description
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

200: OK

{
 "resCode":"100",
 "resMsg":"Success",
 "data":{
  "txData":{
   "amountOutMin": "5055580656532273000"// Expected amount received (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",  // Expected amount received
   "toTokenDecimal":18,
   "path":["0x55d398326f99059ff775485246999027b3197955","0x6b4427caa371627e2a73521a2568fcf1212cd4d9","0xa71edc38d189767582c38a3145b5873052c3e47a"],
   "logoUrl":"https://images.bridgers.xyz/dex/sSwap.png",
  }
 }
}

500: Internal Server Error

Code example

JavaScript

// 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://api.bridgers.xyz/api/sswap/quote',params)
  console.log(res)

Postman example