兑换 API

在资产始终处于托管的情况下，将一种同质化资产兑换为另一种，并 完成交易结算。

每个请求都必须包含通用参数

示例代码位于 Github

交易汇率

POST /v1/conversion/rate

获取币种之间的兑换汇率。

请求 Body

名称	类型	说明
symbol*	String	交易币对的符号，例如 btc-usdt
side*	String	交易方向：buy 或 sell。 buy：买入基准币种的价格。 sell：卖出计价币种的价格。

200: OK

{
  "code": "200",
  "data": {
    "rate": "16078.8636472720095",
    "symbol": "ETH-USDT",
    "timeMills": 1678085017746,
    "expiredMills": 1678085077746
  },
  "message": "success"
}

代码示例

curl --location --request POST 'https://api.musepay.io/v1/conversion/rate' \
--header 'Content-Type: application/json' \
--data-raw '{
  "symbol": "BTC-USDT",
  "side": "BUY"
}'

获取报价

POST /v1/conversion/quote

获取币种兑换报价。

请求 Body

名称	类型	说明
symbol*	String	交易币对的符号，例如 btc-usdt
amount*	String	用于交易的资产金额
currency*	String	用于交易的资产
side*	String	交易方向：buy 或 sell。 buy：买入基准币种的价格。 sell：卖出计价币种的价格。
xid*	String	外部标识符，在该账户下创建的所有资源中唯一。

200: OK

{
"code":"200",
"message":"success",
"data":
   {
      "quoteId":"2024102220000600011072223306",
      "payCurrency":"USDT",
      "payAmt":"100",
      "settleCurrency":"ETH",
      "settleAmt":"0.0375626384",
      "feeCurrency":"ETH",
      "feeAmt":"0.00003761",
      "rate":"2659.5569",
      "timeMills":1729581743749,
      "expiredMills":1729582343749
   }
}

执行交易

POST /v1/conversion/execute

执行之前已报价的交易

请求 Body

名称	类型	说明
quoteId*	String	报价 ID

200: OK

{
  "code": "200",
  "data": {
    "orderNo": "12323",
    "status": 22
  },
  "message": "success"
}