Skip to main content
GET
/
market
/
financial-data
/
economic-calendar-events
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/economic-calendar-events?weeks=2&country=United%20States"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "id": 1,
      "date": "2026-04-25",
      "country": "United States",
      "event": "Fed Interest Rate Decision",
      "actual": "",
      "previous": "5.25%",
      "consensus": "5.50%",
      "forecast": "5.50%",
      "impact": 3,
      "category": "Interest Rate"
    },
    {
      "id": 2,
      "date": "2026-04-26",
      "country": "Vietnam",
      "event": "CPI MoM",
      "actual": "",
      "previous": "0.2%",
      "consensus": "0.3%",
      "forecast": "0.3%",
      "impact": 2,
      "category": "Inflation"
    }
  ]
}

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

​
weeks
integer
default:1

Số tuần kế tiếp cần lấy sự kiện (mặc định 1 = 7 ngày tới).

Required range: x >= 1
Example:

2

​
country
enum<string>

Lọc theo quốc gia. Bỏ qua để lấy sự kiện của mọi quốc gia hỗ trợ. 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 và /market/financial-data/economic-calendar-events.

Giá trịÝ nghĩa
ChinaTrung Quốc
Euro AreaKhu vực đồng Euro
JapanNhật Bản
United StatesMỹ
United KingdomAnh
VietnamViệt Nam
Available options:
China,
Euro Area,
Japan,
United States,
United Kingdom,
Vietnam

Response

Trả về data mảng các sự kiện kinh tế sắp diễn ra, sort date tăng dầ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
​
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"