报价查询

介绍

此接口用于查询ramp的币价查询。若您希望您的用户在跳转ramp页面前预估买币的币价和能得到的数量,可以用此接口查询

接口说明

请求方式: POST

请求路径:/open/api/v4/merchant/quotes

Header参数:

参数名必选类型说明
appidYstring应用的唯一标识
timestampYstring当前 UTC 13位时间戳, 5分钟内有效
signYstring签名,签名方式可参考这里

Body参数:

参数名必选类型说明
cryptoYstring数字货币币种
networkYstring网络
fiatYstring3字母法币code
amountYBigdecimalBUY时为购买法币金额 / SELL时为卖出crypto的数量
sideYstring订单方向:BUY、SELL

示例

请求参数:

{
    "crypto": "USDT",
    "network": "BSC",
    "fiat": "USD",
    "amount": "20",
	  "side": "BUY"
}

返回参数:

# side为BUY返回参数
{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": {
        "crypto": "USDT", // crypto
        "cryptoPrice": "1.0001", // crypto当前价格
        "cryptoQuantity": "100.11", // crypto可以购买的预估数量
		    "fiat": "USD", //法币单位
		    "rampFee": "4.93", // 预估通道费用
		    "networkFee": "0.29" // 预估网络费用
    }
}

# side为SELL返回参数
{
    "success": true,
    "returnCode": "0000",
    "returnMsg": "SUCCESS",
    "extend": "",
    "data": {
        "cryptoPrice": "7.84981500000000000000", // 加密货币换算成法币的单价 单位为法币
        "rampFee": "29.4368", // 手续费 单位为法币
        "cryptoQuantity": null,
        "networkFee": null,
        "fiat": "HKD",
        "crypto": "USDT",
        "fiatQuantity": "784.9815" // 卖币得到的法币金额 未减去rampFee 单位为法币
    }
}