cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/company-financial/analysis?symbol=VNM&period=quarterly"

{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "year": 2025,
      "quarter": 4,
      "pe": null,
      "pb": 4.31317,
      "roa": null,
      "roe": null,
      "eps": null,
      "ebit": 3566980066852,
      "ebitda": 4108719059869,
      "bienlaigop": 0.404497,
      "bienlaiebitda": 0.241213,
      "bienlaisauthue": 0.165978,
      "lnst_yoy": 0.316942,
      "lnst_qoq": 0.126135,
      "dtt_qoq": 0.004738,
      "tt_dtt_yoy": 0.100567,
      "nophaitra_vcsh": 0.546047,
      "novay_vonchu": 0.274241,
      "thanhtoan_hienhanh": 1.957917,
      "thanhtoan_nhanh": 1.575433,
      "thanhtoan_tienmat": 0.096914,
      "bvps": 14189.099355,
      "lnwpershare": 4529.851333,
      "bookvalue": 29654585456641,
      "ev": 113837320151135,
      "vonhoa": 127905273234000
    }
  ]
}

Phân tích cơ bản

Phân tích tài chính doanh nghiệp theo kỳ

Các chỉ số tài chính theo kỳ. Mỗi row luôn có year; quarter chỉ có khi period=quarterly.

Kích thước payload: API trả về ~200 metric code mỗi row (tên romanized tiếng Việt như pe, pb, roa, bienlaigop, ebitda, thanhtoan_hienhanh, novay_vonchu, lnst_yoy, vonhoa, …). Bộ key phụ thuộc vào loại doanh nghiệp (ngân hàng có nim; công ty chứng khoán có margin_loan_to_equity_ratio, …). Nhiều code có thể null khi dữ liệu nguồn thiếu. Example bên dưới chỉ là subset đại diện — tham chiếu additionalProperties trong schema là nguồn chuẩn.

GET

market

company-financial

analysis

cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/company-financial/analysis?symbol=VNM&period=quarterly"

{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "year": 2025,
      "quarter": 4,
      "pe": null,
      "pb": 4.31317,
      "roa": null,
      "roe": null,
      "eps": null,
      "ebit": 3566980066852,
      "ebitda": 4108719059869,
      "bienlaigop": 0.404497,
      "bienlaiebitda": 0.241213,
      "bienlaisauthue": 0.165978,
      "lnst_yoy": 0.316942,
      "lnst_qoq": 0.126135,
      "dtt_qoq": 0.004738,
      "tt_dtt_yoy": 0.100567,
      "nophaitra_vcsh": 0.546047,
      "novay_vonchu": 0.274241,
      "thanhtoan_hienhanh": 1.957917,
      "thanhtoan_nhanh": 1.575433,
      "thanhtoan_tienmat": 0.096914,
      "bvps": 14189.099355,
      "lnwpershare": 4529.851333,
      "bookvalue": 29654585456641,
      "ev": 113837320151135,
      "vonhoa": 127905273234000
    }
  ]
}

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

symbol

string

required

Mã stock (chữ hoa, chữ số).

Example:

"VNM"

period

enum<string>

Kỳ báo cáo. Mặc định annual. Kỳ báo cáo cho truy vấn tài chính doanh nghiệp.

Giá trị	Ý nghĩa
`annual`	Theo năm
`quarterly`	Theo quý

Available options:

annual,

quarterly

Response

Trả về data mảng các kỳ báo cáo, mỗi item là 1 record year (+ quarter khi period=quarterly) cộng ~200 metric code.

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

Show child attributes

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"

Chỉ số tài chính tổng quan của doanh nghiệp Báo cáo tài chính