Skip to main content
GET
/
market
/
financial-data
/
bank-interest-rates
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/bank-interest-rates"

{
  "error_code": "0",
  "message": "success",
  "data": {
    "VCB": {
      "bank_name": "Vietcombank",
      "terms": {
        "1M": 2.4,
        "3M": 2.7,
        "6M": 3.6,
        "12M": 4.6
      }
    },
    "BIDV": {
      "bank_name": "BIDV",
      "terms": {
        "1M": 2.2,
        "3M": 2.6,
        "6M": 3.5,
        "12M": 4.5
      }
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://developers.fhsc.com.vn/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-FH-APIKEY
string
header
required

API key dài hạn của client. Cấu hình 1 lần lúc khởi tạo; có thể wire thẳng vào static setter của SDK tự-gen. Đi kèm với FINHAY_API_SECRET — secret này chỉ dùng ở phía client để tính X-FH-SIGNATURE, không bao giờ gửi qua mạng.

Response

Trả về data map từ mã ngân hàng sang object { bank_name, terms }; mỗi terms là map kỳ hạn → lãi suất % / năm.

Các field chung của envelope trong mọi response của Finhay API.

  • error_code là "0" (string) khi thành công, mã khác "0" khi lỗi.
  • message là thông điệp ngắn từ server.
​
data
object
required

Dữ liệu lãi suất tiền gửi ngân hàng.

additionalProperties: true là chủ ý — đây là endpoint duy nhất trong API có shape thật sự phụ thuộc vào data. Các endpoint khác nên khai báo field rõ ràng.

​
error_code
string

"0" khi thành công, khác "0" khi lỗi.

Example:

"0"

​
message
string

Thông điệp trạng thái dễ đọc.

Example:

"success"