跳到主要内容

闪兑指南

描述​

闪兑交易是一种快速便捷的数字资产兑换方式，用户无需挂单，仅需选择想买入和卖出的资产，系统即可按当前市场最优价格立即完成撮合并成交。 相比传统现货交易，闪兑更适合希望快速完成兑换且对成交价格波动不敏感的用户，广泛应用于资产转换、资金调配等场景，提升了交易效率和用户体验。

基础URL​

API: https://big.one/sapi/v1/convert/

接口列表​

接口名称URI方法
ConvertAssets/assetsGET
ConvertRange/rangeGET
ConvertQuote/viewer/quoteGET
ConvertTradeCreate/viewer/tradePOST
GetConvertTrades/viewer/tradesGET
GetConvertTradeDetail/viewer/tradeGET

限制​

限制的基本信息​

  • 响应中包含以下与限制相关的头信息：
    • X-RateLimit-Limit：最大请求数。
    • X-RateLimit-Remaining：剩余的可用请求数。
    • X-RateLimit-Reset：当前限制重置的时间（即当前时间段结束的时间）。
  • 如果违反请求速率限制，将返回 429 错误。

账户限制​

  • 默认情况下为关闭状态。
  • 如果频繁违反默认限制，将启用账户限制。

IP 限制​

  • 默认情况下为关闭状态。
  • 如果频繁违反默认限制，将启用 IP 限制。

默认限制​

  • 每秒 50 次请求限制。

使用说明​

  1. 首先，调用 ConvertAssets 接口以检索所有可转换的货币。
  2. 接着，使用 ConvertRange 接口获取所有可用转换商提供的可转换货币的最小和最大数量。
  3. 然后，调用 ConvertQuote 接口，通过传递 from_asset、to_asset、rfq_size_asset（与 from_asset 或 to_asset 相同）以及 rfq_size_asset 的数量（rfq_size）来计算价格。
  4. 在第 3 步中获取 quote_id 后，使用 ConvertTradeCreate 接口创建转换交易。
  5. 此外，您还可以通过调用 GetConvertTrades 和 GetConvertTradeDetail 接口来查看第 4 步中创建的交易。