询价

提供询价接口给用户,告诉用户币币交易信息以及币种兑换范围,若用户填写值在可兑换范围外,为避免用户损失,请提醒用户更改兑换值

接口调用

POST https://api.bridgers.xyz/api/sswap/quote

以下参数带*字段为必填,不带*号为选填

Request Body

NameTypeDescription

equipmentNo*

String

设备号(该字段将作为用户的唯一标识,三方可通过自己的方式获得,如fromAddress的前32位字符,或者32位随机数字与字母结合的字符串)

sourceFlag*

String

渠道来源(需要双方约定一个名称来代表三方的渠道)

fromTokenAddress*

String

出售币种合约地址(可通过获取币种列表中的address字段获得)

toTokenAddress*

String

获得币种合约地址(可通过获取币种列表中的address字段获得)

fromTokenAmount*

String

出售币种数量(带精度)

fromTokenChain*

String

出售币种链(可通过获取币种列表中的chain字段获得,详细支持链的情况可查看【基本说明】)

toTokenChain*

String

获得币种链(可通过获取币种列表中的chain字段获得,详细支持链的情况可查看【基本说明】)

userAddr

String

用户地址

sourceType

String

设备类型(H5/IOS/Android 该字段为选填,如通过直接通过API调用,可为空)

{
 "resCode":"100",
 "resMsg":"Success",
 "data":{
  "txData":{
   "amountOutMin": "5055580656532273000" // 发币数量 带精度
   "chainFee":"0.02" // 链上矿工费
   "contractAddress":"0x6b4427caa371627e2a73521a2568fcf1212cd4d9", // 合约地址
   "depositMin": "30", //兑换范围最小值 若用户兑换值小于该值,将不能兑换得到目标币
   "depositMax": "21738659651027.298142", //兑换范围最大值 若用户兑换的值大于该值,将只能得到该值兑换所能得到的目标币种数量
   "dex":"Bridgers1",
   "fee":0.002, // 手续费比例
   "feeToken":"",
   "fromTokenAmount":"47079490000000000000",
   "fromTokenDecimal":18,
   "toTokenAmount":"5.0555806565",  // 发币数量 不带精度 
   "toTokenDecimal":18,
   "path":["0x55d398326f99059ff775485246999027b3197955","0x6b4427caa371627e2a73521a2568fcf1212cd4d9","0xa71edc38d189767582c38a3145b5873052c3e47a"],
   "logoUrl":"https://images.bridgers.xyz/dex/sSwap.png",
  }
 }
}

调用示例

// 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 示例

Last updated