Funds account exchange rate query

• Endpoint: POST /aggregate-pay/api/gateway/queryCurrencyExchangeRate
• Tags: Forex(New)

Description

Support querying fund account exchange rate scenarios

Parameters

Field	In	Type	Required	Constraints	Description
Content-Type	header	string	Yes
sign	header	string	Yes		签名信息请参考技术文档

Parameter Examples

• Content-Type: "application/json"
• sign: "FPFVT3o227JrFRbqu19boZCpVVTF9KznxyRawUmxpfXilHV/0yK46haPhAjNu1hPUMy7Vw/ILXhfzffNm4Fj0apWknlTY9OJxnSoQxS9BTFtc61tn5yV1q69x/kkBl82/qwg+XTJ4fOzy7Mar3VaC1E2PlDA6RkkKBUyNE6RYgsdB+Su7an4+4HVTNAnoe74WyvBgxTLMNg28igBTdqxaO3w/UBY6ObVp7vkqkQGdL1Y+HgmMYaAVwrM3+ALWGId0sJ+YqTY4WJ+0xCRGhaSnybiIjZsQEYyID68WNUfuavDLDsEhaMm/HfQvf5p0R1Ltovp3wwJnEbQcjY458iX5A=="

Request Body

Content-Type: application/json

Field	Type	Required	Constraints	Description	Enum
version	string	Yes		API version,Current value:1.5
keyVersion	string	Yes		Signature Algorithm Version,Current value: 1
requestTime	string	Yes		Request time,compliant with rfc3339 specification, format: yyyy-MM-dd'T'HH:mm:ss.SSSXXX
appId	string	Yes		Merchant AppId,The unique identifier assigned to the merchant app by PayerMax
memberId	string	Yes		member Id,the unique identifier generated when the merchant signs the contract with
data	object	Yes
data.ccyPairList	array[object]	Yes		Currency pair list
data.ccyPairList[].side	string	Yes		For the buying and selling direction of trading currencies,BUY/SELL
data.ccyPairList[].targetCurrency	string	Yes		Foreign exchange target currency
data.ccyPairList[].transactionCurrency	string	Yes		Foreign exchange trading currency

Example

{
  "version": "1.5",
  "keyVersion": "1",
  "requestTime": "2025-12-03T12:23:13.712+00:00",
  "appId": "798b79c2e33a4d8e866410bf401551a7",
  "memberId": "20251126P01B55000029000008",
  "data": {
    "ccyPairList": [
      {
        "side": "SELL",
        "targetCurrency": "USD",
        "transactionCurrency": "IDR"
      },
      {
        "side": "BUY",
        "targetCurrency": "USD",
        "transactionCurrency": "IDR"
      }
    ]
  }
}

Responses

200

Field	Type	Required	Constraints	Description	Enum
msg	string	Yes		Return code,'APPLY_SUCCESS' means success
code	string	Yes
data	object	Yes
data.rateList	array[object]	Yes
data.rateList[].ccyPair	string	Yes		Currency pair
data.rateList[].expiryTime	string	Yes		Exchange rate expiration time,may be empty, format: yyyy MM dd'D'HH: mm: ss.SSSSXXX
data.rateList[].rate	number	Yes		What is the foreign exchange trading currency representing a unit? Target currency exchange rate
data.rateList[].rateReferenceId	string	Yes		Unique ID for exchange rate
data.rateList[].rateType	string	Yes		Tradable/Reference
data.rateList[].side	string	Yes		For the buying and selling direction of trading currencies,BUY/SELL
data.rateList[].targetCurrency	string	Yes		Foreign exchange target currency
data.rateList[].transactionCurrency	string	Yes		Foreign exchange trading currency

Response Example

{
  "msg": "",
  "code": "APPLY_SUCCESS",
  "data": {
    "rateList": [
      {
        "ccyPair": "IDRUSD",
        "expiryTime": "2025-10-20T05:57:25.736Z",
        "rate": 0.00006213,
        "rateReferenceId": "tieredBatchId0018176093978450500010002",
        "rateType": "Tradable",
        "side": "SELL",
        "targetCurrency": "USD",
        "transactionCurrency": "IDR"
      },
      {
        "ccyPair": "IDRUSD",
        "expiryTime": "2025-10-20T05:57:26.699Z",
        "rate": 0.00006484,
        "rateReferenceId": "tieredBatchId0018176093978450500010002",
        "rateType": "Tradable",
        "side": "BUY",
        "targetCurrency": "USD",
        "transactionCurrency": "IDR"
      }
    ]
  }
}