Skip to main content
GET
/
market
/
financial-data
/
trading-economics
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/trading-economics?country=United%20States&category=Prices&year=2024"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "indicator": "Inflation Rate",
      "country": "United States",
      "category": "Prices",
      "lastValue": 3.4,
      "previousValue": 3.2,
      "year": 2024,
      "month": 3,
      "unit": "%"
    },
    {
      "indicator": "Inflation Rate",
      "country": "United States",
      "category": "Prices",
      "lastValue": 3.2,
      "previousValue": 3.1,
      "year": 2024,
      "month": 2,
      "unit": "%"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.fhsc.com.vn/llms.txt

Use this file to discover all available pages before exploring further.

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 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
​
category
enum<string>

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

Giá trịÝ nghĩa
GDPTổng sản phẩm quốc nội
LabourLao động (việc làm, thất nghiệp, …)
PricesGiá cả (CPI, PPI, lạm phát, …)
MoneyTiền tệ (lãi suất, M2, dự trữ ngoại hối, …)
TradeThương mại (xuất nhập khẩu, cán cân, …)
GovernmentTài khoá chính phủ
BusinessHoạt động doanh nghiệp
ConsumerTiêu dùng
HousingBất động sản
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 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"