Conversion API

Convert from one fungible asset to another and settle transactions without ever taking assets out of custody.

Every request must contain common parameters

Demo code can be found at Github

Trade Rate

POST /v1/conversion/rate

Retrieves exchange rate between currencies.

Request Body

Name	Type	Description
symbol*	String	Symbol of the pair to trade, for example, btc-usdt
side*	String	side of trade: buy or sell. buy: the price for buying the base currency. sell: the price for selling the quote currency.

200: OK

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

Code Example

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

}'

Get a Quote

POST /v1/conversion/quote

Get a quote for currency conversion.

Request Body

Name	Type	Description
symbol*	String	Symbol of the pair to trade, for example, btc-usdt
amount*	String	Amount of asset used to trade
currency*	String	The asset used to trade
side*	String	side of trade: buy or sell. buy: the price for buying the base currency. sell: the price for selling the quote currency.
xid*	String	External identifier, unique across all resources created under this account.

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
   }
}

Execute a trade

POST /v1/conversion/execute

Execute a trade that has been previously quoted

Request Body

Name	Type	Description
quoteId*	String	Quote ID

200: OK

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