询价
提供询价接口给用户,告诉用户币币交易信息以及币种兑换范围,若用户填写值在可兑换范围外,为避免用户损失,请提醒用户更改兑换值
接口调用
POST
https://api.bridgers.xyz/api/sswap/quote
以下参数带*字段为必填,不带*号为选填
Request Body
Name
Type
Description
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