Get Currencies

Return the list of currency pairs that Baokim can quote for the requesting Merchant. Only pairs that can be reliably quoted are returned.

We recommend calling this API at most once a day — the list of supported currencies changes very rarely.

Path

• URL: /cb-core/api/v1/fx/get-currencies
• Method: POST
• Description: Get the list of supported currency pairs.

Request

Request table

Params	Data Type	Required	Description
request_id	string(50)	Yes	Unique code that identifies the request. Suggested format: MerchantCode + BK + YYYYMMDD + UniqueId
request_time	string(19)	Yes	Time the Merchant sends the request. Format: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Yes	Merchant code provided by Baokim before integration

Request Example

{
  "request_id": "MERCHANT1234BK202606051",
  "request_time": "2026-06-05 10:15:30",
  "merchant_code": "MERCHANT1234"
}

Response

Response Table

Params	Data Type	Required	Description
response_code	int(4)	Yes	Result code from Baokim, as per the Error Codes table
response_message	string(200)	Yes	Description of the result code
merchant_code	string(20)	Yes	Merchant code provided by Baokim before integration
data	Array of Objects	Yes	List of supported currency pairs

Data Array Structure (inside data)

Params	Data Type	Description
currency_pair	string(10)	Currency pair in BASE/QUOTE format (e.g. USD/VND)
base_currency	string(10)	Foreign currency code (e.g. USD)
quote_currency	string(10)	Quote currency code (e.g. VND)
base_currency_name	string(50)	Display name of the base currency
quote_currency_name	string(50)	Display name of the quote currency

Response Example

{
  "response_code": 200,
  "response_message": "Success",
  "merchant_code": "MERCHANT1234",
  "data": [
    {
      "currency_pair": "USD/VND",
      "base_currency": "USD",
      "quote_currency": "VND",
      "base_currency_name": "United States Dollar",
      "quote_currency_name": "Vietnamese Dong"
    },
    {
      "currency_pair": "CNY/VND",
      "base_currency": "CNY",
      "quote_currency": "VND",
      "base_currency_name": "Chinese Yuan",
      "quote_currency_name": "Vietnamese Dong"
    }
  ]
}

Error Code

Response Code	Response Message
200	Success
101	System Error
110	Merchant Code Invalid
120	Invalid Signature
422	Validation Error
429	Too Many Requests