/app/rfqbyfiat

基于法币金额询价

本接口用于根据法币金额获取指示性报价(例如:支付 50 USD 或 60 EUR 购买 BTC)。

💡

本接口返回的报价仅供参考。确认购买请调用 /app/orderbyfiat 下单,该接口按**市价单(Market Order)**成交,实际成交价格与数量以订单结果为准。

费用格式 (fee_format) 说明

通过可选参数 fee_format 选择报价中费用的呈现方式;不传时默认为 3.0。

集成版本fee_format 值费用呈现方式
SaaS 3.03.0费用单列。响应中包含 processing_fee(处理费)、network_fee(网络费)、size(法币金额);price 为币的单价,不包含上述费用
SaaS 3.13.1费用并入价格。price 为包含全部费用的均价;响应中不再返回 processing_fee、network_fee、size

size 与费用的关系

fee_format = 3.0:

size = quantity × price + processing_fee + network_fee

示例:支付 20.8 USD 买入,响应为 quantity = 17.2352、price = 1.00515、processing_fee = 1.5、network_fee = 1.976,验算:

17.2352 × 1.00515 + 1.5 + 1.976 = 20.79996128 ≈ 20.8(= size)

fee_format = 3.1:

size = quantity × price

price 已包含全部费用。同一笔报价在 3.1 下:price = 20.8 ÷ 17.2352 ≈ 1.206833,费用不再单列。

注意:quantity 与 price 按交易对精度做了舍入,代入公式验算时可能存在极小尾差(如上例末位的 0.00004),对账请以 size 为准。

Query Params
string
required
Defaults to BTCUSD

交易对,限接入方已开通的交易对

string
enum
required
Defaults to buy

仅支持 buy(买入)

Allowed:
string
required
Defaults to 10

法币金额;需满足最低交易额限制,否则返回 422

string
enum
Defaults to bank

支付方式:bank(银行转账)或 card(信用卡),最终价格会有所不同

Allowed:
string
enum
Defaults to 3.0

费用格式,可选 2.0、3.0 或 3.1,缺省为 3.0。详见页面「费用格式 (fee_format) 说明」。

Allowed:
string
Defaults to 0.01

佣金率(仅 fee_format 3.0 时生效)

string
enum
Defaults to ETH

网络,可选 ETH、BASE、OP、MATIC、XLM、SOL

Allowed:
Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json