跳转到主要内容
Stablecoin Account API 发布方声明 兑换是把账户中的一种货币换成另一种 —— 加密货币换法币、法币换加密货币或加密货币互换 —— 汇率在执行前预先锁定。流程固定为两次调用：先创建报价，再在报价失效前创建引用它的兑换。
前置条件
  • 通过 x-auth-token 请求头发送的 API token
  • 卖出币种有足够的 available_balance

​
步骤 1：创建报价

调用 Create Quote，传入币种对、金额，以及金额固定在哪一侧：
fixed_currency 指定 amount 作用于哪一侧 —— 固定卖出侧表示花费确定的金额，固定买入侧表示收到确定的金额。
币种对限制：加密货币互换只允许 USDT 与另一种支持的币种配对。若任一侧是波动性资产（例如 BTC 或 ETH），固定币种只能是 USDT。
响应：
报价汇率在 valid_from 至 valid_to 期间有效。若在执行前窗口已过，请重新获取报价 —— 过期的 quote_id 会被拒绝。

​
步骤 2：执行兑换

调用 Create Conversion，传入 quote_id 和与报价完全一致的金额，并携带幂等键：
响应返回兑换订单 —— order_id、short_order_id、status、买卖双方币种、使用的 quote_price 以及费用。order_type 依方向为 Sell 或 Buy。

​
步骤 3：跟踪兑换

兑换状态从 Submitted / Pending 流转到 Success、Failed 或 Submit Failed。更新通过换汇 webhook 推送： 可随时用 Retrieve Conversion 查询，或用 List Conversions 对账（按 order_status、order_id 或 balance_currency 过滤）。已完成的兑换带有 settle_time。