Obtain Exchange Rate

Get crypto or fiat rate

post

Retrieve real-time exchange rate between cryptocurrency and fiat currency.Includes buy/sell rates and applicable fees

Header parameters

BiuLinkPay-AppIdstringRequired

BiuLinkPay-TimeStampstringRequired

BiuLinkPay-NoncestringRequired

BiuLinkPay-SignaturestringRequired

Body

application/json

currencyTypestring · enumRequired

Currency type

Example: CRYPTOPossible values:

numbernumberRequired

Transaction amount, integer = 20, fraction = 12

Example: 10000

feestringOptional

Transaction fee (fee not's empty,feeRatio is invalid)

saleDirectionstring · enumRequired

Trade direction (BUY/SELL)

Example: SELLPossible values:

exchangestring · enumOptional

Exchange name

Example: BINANCEPossible values:

cryptoUnitstringOptional

Cryptocurrency unit

Example: USDT

fiatUnitstringOptional

Fiat currency unit

Example: VND

feeRatiostringOptional

Fee ratio (value is percentage, if feeRatio & fee is null,get merchant config)

Example: 0.01

networkstringOptional

Blockchain network

Example: BSC

deductionMethodstring · enumOptional

Fee deduction method (outer buckle)

Example: OUTER_BUCKLEPossible values:

Responses

200

Successful operation

application/json

post

/pay/common/rateQuery

HTTPcURLJavaScriptPython

POST /api/pay/common/rateQuery HTTP/1.1
BiuLinkPay-AppId: text
BiuLinkPay-TimeStamp: text
BiuLinkPay-Nonce: text
BiuLinkPay-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 197

{
  "currencyType": "CRYPTO",
  "number": 10000,
  "fee": "",
  "saleDirection": "SELL",
  "exchange": "BINANCE",
  "cryptoUnit": "USDT",
  "fiatUnit": "VND",
  "feeRatio": "0.01",
  "network": "BSC",
  "deductionMethod": "OUTER_BUCKLE"
}

200

Successful operation

{
  "code": "0",
  "msg": "SUCCESS",
  "model": {
    "currencyType": "CRYPTO",
    "saleDirection": "SELL",
    "usdTFee": "99.9",
    "number": "10000",
    "totalAmountUsdT": "10089.9",
    "fiatDetail": {
      "fiatUnit": "VND",
      "fiatFee": "2587508.42105781",
      "fiatAmount": "258750842.10578117",
      "fiatToUsdRate": "0.00003860857",
      "totalAmountFiat": "261338350.52683898"
    },
    "cryptoDetail": {
      "cryptoUnit": "USDT",
      "cryptoFee": "100",
      "cryptoAmount": "10000",
      "cryptoToUsdTRate": "0.999",
      "totalAmountCrypto": "10100"
    }
  },
  "success": true,
  "error": false
}