Danh sách tin tức thị trường

Dòng tin tức tài chính, gồm cả quốc tế và thị trường Việt Nam, kèm phân trang. Lọc tùy chọn theo topic (forex / hàng hoá / chứng khoán / crypto / vĩ mô); phân trang qua page/page_size. Khi topic=stock, có thể kết hợp tham số symbol để lọc theo mã chứng khoán. Mỗi item là bản tóm tắt (không có toàn văn); dùng id gọi /market/market-news/{id} để lấy nội dung đầy đủ.

GET /market/market-news

cURL

cURL

curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/market-news?topic=stock&page=1&page_size=20"

200

{
  "data": {
    "total": 137,
    "current_page": 1,
    "page_size": 20,
    "results": [
      {
        "id": "abc123",
        "title": "<string>",
        "url": "<string>",
        "published_at": "2023-11-07T05:31:56Z",
        "topic": "stock",
        "summary": "<string>",
        "source": "<string>",
        "symbols": [
          "<string>"
        ]
      }
    ],
    "next_page": 2,
    "previous_page": 1,
    "page_total": 7
  },
  "error_code": "0",
  "message": "success"
}

Ủy quyền

X-FH-APIKEY · string · header · bắt buộc

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.

Tham số truy vấn

topic · enum<string>

Lọc theo chủ đề tin tức. Khi topic=stock, có thể kết hợp tham số symbol để lọc theo mã chứng khoán. Chủ đề tin tức thị trường.

Tùy chọn có sẵn: crypto, forex, stock, commodities, macro

Ví dụ:

"stock"

symbol · string

Mã chứng khoán cần lọc. Chỉ áp dụng khi topic=stock.

Ví dụ:

"FPT"

page · integer

Trang (bắt đầu từ 1). Mặc định 1.

Phạm vi bắt buộc: x >= 1

Ví dụ:

1

page_size · integer

Số item mỗi trang (1–50). Mặc định 20.

Phạm vi bắt buộc: 1 <= x <= 50

Ví dụ:

20

Phản hồi

200

application/json

data là trang tin tức kèm items và thông tin phân trang.

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 · bắt buộc

Metadata phân trang dùng chung cho mọi list API. Dữ liệu của trang nằm ở results.

Show child attributes

error_code · string

"0" khi thành công, khác "0" khi lỗi.

Ví dụ:

"0"

message · string

Thông điệp trạng thái dễ đọc.

Ví dụ:

"success"