Skip to main content
GET
cURL

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

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.

Available options:
crypto,
forex,
stock,
commodities,
macro
Example:

"stock"

symbol
string

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

Example:

"FPT"

page
integer

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

Required range: x >= 1
Example:

1

page_size
integer

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

Required range: 1 <= x <= 50
Example:

20

Response

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
required

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

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"