Skip to main content
GET
/
fund-trading
/
public
/
fund-certificates
/
benchmark
/
nav
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/fund-trading/public/fund-certificates/benchmark/nav?fund-names=VESAF,DCDS&period=ONE_YEAR"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "fund_name": "VESAF",
      "nav_records": [
        {
          "date": "2024-12-31",
          "navpf": 18234.56,
          "change_percent": 1.24
        },
        {
          "date": "2025-01-31",
          "navpf": 18452.1,
          "change_percent": 1.19
        }
      ]
    },
    {
      "fund_name": "DCDS",
      "nav_records": [
        {
          "date": "2024-12-31",
          "navpf": 15234.1,
          "change_percent": 0.84
        },
        {
          "date": "2025-01-31",
          "navpf": 15422.6,
          "change_percent": 1.24
        }
      ]
    }
  ]
}

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.

Query Parameters

​
fund-names
string
required

Danh sách mã quỹ phân tách bằng dấu phẩy (server parse bằng split(","), không hỗ trợ syntax repeated query).

Example:

"VESAF,DCDS"

​
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
​
from-month
string

Tháng bắt đầu, format yyyy-MM (ví dụ 2024-01). Bắt buộc khi period bị bỏ qua trên các endpoint benchmark nav / operation.

Example:

"2024-01"

​
to-month
string

Tháng kết thúc, format yyyy-MM (ví dụ 2024-12). Bắt buộc khi period bị bỏ qua trên các endpoint benchmark nav / operation.

Example:

"2024-12"

Response

Trả về data mảng quỹ kèm nav_records[].

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