Skip to main content
GET
/
market
/
recommendation-reports
/
{symbol}
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/recommendation-reports/VNM"
{
  "error_code": "0",
  "message": "success",
  "data": {
    "recommendation": "Mua — upside 15% tới giá mục tiêu 85.000đ.",
    "recommendationReports": [
      {
        "stock": "VNM",
        "title": "VNM — Update Q1 2024",
        "source": "VietStock",
        "recommendation_price": null,
        "target_price": 85000,
        "publish_date": "2024-04-10T09:00:00Z",
        "description": "Mua — upside 15% tới giá mục tiêu 85.000đ.",
        "download_url": "https://vietstock.vn/reports/vnm-q1-2024.pdf",
        "created_at": "2024-04-10T09:00:00Z",
        "updated_at": "2024-04-10T09:00:00Z"
      }
    ]
  }
}

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

​
symbol
string
required

Mã stock viết hoa (3–4 ký tự, ví dụ VNM, FPT, HPG). Yêu cầu khớp chính xác với mã niêm yết.

Example:

"VNM"

Response

Trả về data chứa recommendation (latest) và recommendationReports[] (full list); data: [] khi stock không có báo cáo.

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
required

Returns a RecommendationReport object when reports exist, or an empty array [] when none are available for the symbol.

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