Skip to main content
GET
/
fund-trading
/
public
/
fund-certificates
/
benchmark
/
growth
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/fund-trading/public/fund-certificates/benchmark/growth?fund-names=VESAF,DCDS&amount=10000000&period=ONE_YEAR"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "fund_name": "VESAF",
      "profit_percent": 18.4,
      "current_amount": 11840000
    },
    {
      "fund_name": "DCDS",
      "profit_percent": 14.2,
      "current_amount": 11420000
    }
  ]
}

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"

amount
integer<int64>
required

Số tiền đầu tư (VND).

Example:

10000000

period
enum<string>
required

Khoảng thời gian mô phỏng (bắt buộc cho endpoint growth). 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 mảng kết quả mô phỏng cho mỗi quỹ.

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

  • error_code"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"