Skip to main content
GET
/
fund-trading
/
public
/
fund-certificates
/
{fundName}
/
nav-histories
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/fund-trading/public/fund-certificates/VESAF/nav-histories?period=ONE_YEAR"
{
  "error_code": "0",
  "message": "success",
  "data": {
    "nav_histories": [
      {
        "date": "2025-04-30",
        "nav": 18234.56,
        "benchmark_value": 1284.91
      },
      {
        "date": "2025-05-30",
        "nav": 18450.1,
        "benchmark_value": 1298.45
      }
    ],
    "benchmark_name": "VN-INDEX"
  }
}

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.

Path Parameters

​
fundName
string
required

Mã ngắn (short name) của quỹ — ví dụ VESAF, DCDS, VCBF-BCF.

Example:

"VESAF"

Query Parameters

​
period
enum<string>

Khoảng thời gian truy vấn. Khoảng thời gian truy vấn NAV / benchmark cho quỹ mở.

Giá trịÝ nghĩa
BEGIN_THE_YEARTừ đầu năm đến nay (YTD)
ONE_MONTH1 tháng gần nhất
THREE_MONTHS3 tháng gần nhất
SIX_MONTHS6 tháng gần nhất
ONE_YEAR1 năm gần nhất
THREE_YEARS3 năm gần nhất
FIVE_YEARS5 năm gần nhất
SEVEN_YEARS7 năm gần nhất
TEN_YEARS10 năm gần nhất
ALL_TIMEToàn bộ lịch sử (≈ 20 năm)
Available options:
BEGIN_THE_YEAR,
ONE_MONTH,
THREE_MONTHS,
SIX_MONTHS,
ONE_YEAR,
THREE_YEARS,
FIVE_YEARS,
SEVEN_YEARS,
TEN_YEARS,
ALL_TIME

Response

Trả về data chứa nav_histories[] và benchmark_name.

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

Lịch sử NAV của quỹ kèm chuỗi benchmark cùng khoảng thời gian — phục vụ vẽ chart trên cùng trục X.

​
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"