FX Rate Query

API Information

• Path: /api/v1/acct/queryExchangeRate
• Method: POST
• Content-Type: application/json

Business Description

• Supports merchants querying FX Rate from source currency to target currency. When the source amount is not 0, it will calculate the corresponding arrival amount based on the FX Rate. If the source amount is 0 or not provided, only the corresponding FX Rate will be returned
• This API returns the latest indicative rate of the day, which is refreshed every 24 hours.
• The actual deduction and settlement rate will be locked at the time of payout execution and displayed on the payout receipt.
• If there is a time gap between inquiry and execution, market fluctuations may result in differences between the two rates.

Request Parameters

Headers

Request Headers

Parameter	Value	Required	Description
Content-Type	application/json	Yes	Request body type

Request Body

Main Parameters

Parameter	Type	Description	Required
merchantNo	string	Merchant Number	M
sourceAmount	number	Source Amount	C
sourceCurrency	string	Source Currency	M
targetCurrency	string	Target Currency	M
sign	string	Signature	M

Request Example

Request

{"merchantNo":"800538",
  "sourceAmount":"15",
  "sourceCurrency":"USD",
  "targetCurrency":"EUR",
  "sign":"12346"}

Response Result

Response Headers

Parameter	Value	Required	Description
content-type	application/json;charset=UTF-8	Yes	Response body type

Response Parameters

Response Fields

Parameter	Type	Description
respCode	string
respMsg	string
data	object
|─sourceAmount	number	Source Amount Information
|─sourceCurrency	string	Source Currency Information
|─targetAmount	number	Target Amount Information
|─targetCurrency	string	Target Currency Information
|─convRate	number	Conversion FX Rate
|─rateDateTime	string	Current FX Rate Time

Response Example

Response

{
  "respCode": "20000",
  "respMsg": "",
  "data": {
    "sourceAmount": 0.0,
    "sourceCurrency": "",
    "targetAmount": 0.0,
    "targetCurrency": "",
    "convRate": 0.0,
    "rateDateTime": ""
  }
}