Skip to main content
GET
/
market
/
financial-data
/
macro
cURL
curl -H "X-FH-APIKEY: $FINHAY_API_KEY" \
  "https://open-api.fhsc.com.vn/market/financial-data/macro?type=CPI&country=VN&period=ONE_YEAR"
{
  "error_code": "0",
  "message": "success",
  "data": [
    {
      "type": "CPI",
      "country": "VN",
      "month": "2024-02",
      "value": 3.45,
      "date": "2024-02-29"
    },
    {
      "type": "CPI",
      "country": "VN",
      "month": "2024-03",
      "value": 3.97,
      "date": "2024-03-31"
    }
  ]
}

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

​
type
enum<string>
required

Loại chỉ số vĩ mô. Mã chỉ số kinh tế vĩ mô.

Giá trịÝ nghĩa
IIPChỉ số sản xuất công nghiệp
CPIChỉ số giá tiêu dùng
PMIChỉ số quản lý mua hàng
PCEChi tiêu tiêu dùng cá nhân (Mỹ)
CORE_PCEPCE lõi (Mỹ)
NFPBảng lương phi nông nghiệp (Mỹ)
GOODS_RETAILDoanh thu bán lẻ — hàng hoá
SERVICE_RETAILDoanh thu bán lẻ — dịch vụ
TOTAL_EXPORTTổng xuất khẩu
FDI_EXPORTXuất khẩu FDI
DOMESTIC_EXPORTXuất khẩu nội địa
FED_FUNDS_RATELãi suất Fed Funds (Mỹ)
INTERBANK_RATELãi suất liên ngân hàng
GOVERNMENT_10Y_BOND_YIELDLợi suất trái phiếu chính phủ 10 năm
UNEMPLOYMENT_RATETỷ lệ thất nghiệp
Available options:
IIP,
CPI,
PMI,
PCE,
CORE_PCE,
NFP,
GOODS_RETAIL,
SERVICE_RETAIL,
TOTAL_EXPORT,
FDI_EXPORT,
DOMESTIC_EXPORT,
FED_FUNDS_RATE,
INTERBANK_RATE,
GOVERNMENT_10Y_BOND_YIELD,
UNEMPLOYMENT_RATE
​
country
enum<string>
required

Mã quốc gia. Mã quốc gia cho dữ liệu vĩ mô.

Giá trịÝ nghĩa
VNViệt Nam
USMỹ
Available options:
VN,
US
​
period
enum<string>

Khoảng thời gian lọc. Khoảng thời gian lọc dữ liệu vĩ mô.

Giá trịÝ nghĩa
ONE_MONTH1 tháng gần nhất
ONE_YEAR1 năm gần nhất
YTDTừ đầu năm đến nay
Available options:
ONE_MONTH,
ONE_YEAR,
YTD

Response

Trả về data mảng các điểm dữ liệu vĩ mô theo tháng cho type + country đã chọ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"