Skip to content

Quote (Exchange Rate)

  • Method: POST
  • Path: /coin/v1/exchange/quote
  • Parameters: JSON Body

Request fields

FieldTypeRequiredConstraintDescription
receive_amountdoubleYes> 0; precision in CurrencyAmount to receive
pay_currencystringYesSee CurrencyPay currency
receive_currencystringYesSee CurrencyReceive currency

Response fields (data)

FieldTypeDescription
quote_idstringPlatform quote ID (must be echoed on confirm)
ratedoubleExchange rate
pay_amountdoublePay amount
receive_amountdoubleReceive amount
pay_currencystringPay currency
receive_currencystringReceive currency
expires_inint64Quote TTL in seconds
expires_atstringQuote expiry time, RFC3339 (with timezone)

Success response example

json
{
  "status": 200,
  "msg": "SUCCESS",
  "data": {
    "quote_id": "Q202606160001",
    "rate": 5.4321,
    "pay_amount": 543.21,
    "receive_amount": 100,
    "pay_currency": "BRL",
    "receive_currency": "USDT",
    "expires_in": 5,
    "expires_at": "2026-06-16T16:00:15+08:00"
  }
}

Failure response example (invalid parameter)

json
{
  "status": 1404,
  "msg": "金额无效",
  "data": {}
}