post
https://sandboxapi.legendtrading.com/app/offrampquote
卖币询价接口
提供卖币询价接口
此接口仅用于提供加密货币兑法币(off-ramp)的报价。
参数 'quantity' 必须为加密货币资产的数量,不可用法币金额作为输入值。
注意
1.Quantity (数量)指代加密货币数额。若已使用 quantity 参数,则无需再填写 "size" 字段。
2.Size 用于指定法币金额,此为可选参数。若同时传递了 quantity 和 size 参数,系统将默认优先使用 "quantity" 进行计算。
fee_format 3.0和3.1的区别
fee_format 3.0:
{
"quantity":53,
"price":0.995,
"pair":"USDTUSD",
"side":"sell",
"created":"2023-01-12T16:12:45.657150Z",
"network_fee":1.5,
"processing_fee":1.25,
"size":50,
"commission":"2.89"
}
fee_format 3.1:
{
"created": "2023-10-19T19:23:31.107022Z",
"side": "sell",
"pair": "USDCGBP",
"quantity": 741.7163,
"price": 0.8089,
"size": 600
}费用格式说明
本接口支持两种费用计算模式:3.0 和 3.1。两种模式对 price、size 的计算逻辑不同。
| 模式 | 价格 (price) 说明 | 最终金额 (size) 计算公式 | 说明 |
|---|---|---|---|
| 3.0 | 未包含手续费 | size = price × quantity + processing_fee + network_fee | 手续费作为额外项另行计算并累加。 |
| 3.1 | 已包含所有手续费 | size = price × quantity | 报价中的 price 已内含处理费和网络费,直接乘以数量即可得到总额。 |
核心区别:
3.0模式:price为基础价格,需额外支付处理费 (processing_fee) 和网络费 (network_fee)。3.1模式:price为总价(即“一口价”),已内含所有手续费,计算更简便。
注意:无论采用何种模式,交易数量 (
quantity) 的含义和取值均保持不变。
参数说明
| 参数名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
side | string | 是 | sell | 交易方向 |
quantity | string | 否 | 100 | 加密货币数量。若使用此参数,则无需填写 size |
pair | string | 是 | USDTUSD | 交易对 |
size | string | 否 | - | 法币金额(可选)。若同时填写了 quantity 和 size,系统将默认使用 quantity |
payment_method | string | 否 | - | 支付方式:SEPA/WIRE/FPS/SWIFT/PIX/SPEI(可选)。若指定,系统将基于此方式验证用户银行数据。默认情况下所有字段均为必填 |
fee_format | string | 否 | - | 费用格式:3.0 或 3.1 |
bank_id | string | 否 | - | 银行账户ID,从 app/bankaccount API 获取 |
commission_rate | string | 否 | - | 佣金费率(仅 fee_format 为 3.0 时可用) |
