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.

Path Parameters

slug
enum<string>
required

Slug ngành cấp 1. Tra danh sách hợp lệ qua GET /market/sectors.

Available options:
technology,
telecommunications,
healthcare,
financials,
real-estate,
consumer-discretionary,
consumer-staples,
industrials,
basic-materials,
energy,
utilities
Example:

"financials"

Query Parameters

from
string<date>

Ngày bắt đầu (YYYY-MM-DD), tính cả ngày này. Bỏ trống cả from lẫn to → 3 tháng gần nhất. Khoảng tối đa 5 năm.

Example:

"2026-05-17"

to
string<date>

Ngày kết thúc (YYYY-MM-DD), tính cả ngày này. Bỏ trống → hôm nay.

Example:

"2026-08-17"

Response

data.items là chuỗi bar theo phiên.

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

Chuỗi chỉ số ngành theo phiên. Chưa phân trang.

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"