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

country
enum<string>

Lọc theo quốc gia. Bỏ qua để lấy mọi quốc gia hỗ trợ. Tên quốc gia hiển thị (full name) cho dữ liệu kinh tế. Dùng trong /market/calendar.

Available options:
China,
Euro Area,
Japan,
United States,
United Kingdom,
Vietnam
from
integer

Mốc đầu khoảng lọc — Unix timestamp tính bằng GIÂY.

Required range: x >= 0
Example:

1767225600

to
integer

Mốc cuối khoảng lọc — Unix timestamp tính bằng GIÂY, phải >= from.

Required range: x >= 0
Example:

1769904000

page
integer

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

Required range: x >= 1
Example:

1

page_size
integer

Số sự kiện mỗi trang (1–50). Mặc định 20.

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

20

Response

data là trang sự kiện kèm results 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"