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>
required

Tên quốc gia (full name). Bắt buộc. Tên quốc gia hiển thị (full name) cho dữ liệu kinh tế lịch sử và lịch sự kiện kinh tế. Dùng chung cho /market/financial-data/trading-economics/market/financial-data/economic-calendar-events.

Available options:
China,
Euro Area,
Japan,
United States,
United Kingdom,
Vietnam
category
enum<string>

Lọc theo nhóm chỉ số (optional). Nhóm chỉ số kinh tế từ Trading Economics.

Available options:
GDP,
Labour,
Prices,
Money,
Trade,
Government,
Business,
Consumer,
Housing
year
integer

Lọc theo năm cụ thể, trong khoảng 2000–2100.

Required range: 2000 <= x <= 2100
Example:

2024

Response

Trả về data mảng các điểm dữ liệu chỉ số kinh tế, sort year DESC, month DESC.

Các field chung của envelope trong mọi response của Finhay API.

  • error_code"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
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"