Truy xuất chỉ tiêu kinh tế vĩ mô (Macro)
Mục lục
Macro giúp bạn lấy chỉ tiêu kinh tế vĩ mô theo chủ đề. Bạn gọi hàm của chủ đề cần xem, ví dụ cpi(), thư viện tự lấy
đủ các chỉ tiêu của chủ đề đó. Bạn không phải tra mã chỉ tiêu.
Cách gọi
from vnstock import Macro
Macro("fhsc").economy.cpi(start="2024-01-01") # mặc định là Việt Nam
Macro("fhsc").economy.cpi(country="US", length=12) # 12 kỳ mới nhất của mỗi chỉ tiêu
Macro("fhsc").currency.policy_rate(country="JP")
Macro("fhsc").global_macro.bond_yield(market="US", start="2026-01-01")Cách viết của thế hệ 5 và vnstock_data 3.x vẫn chạy: Macro().economy().cpi(source="<nguồn>", period="month").
Tìm nhanh theo nhu cầu
Bộ hàm phủ 189 chỉ tiêu của Việt Nam (VN), Mỹ (US), Trung Quốc (CN), Nhật Bản (JP) và khu vực đồng euro (EU).
| Bạn cần xem | Hàm | country có số |
|---|---|---|
| GDP, tăng trưởng, GDP thực, GDP đầu người; Việt Nam có thêm GDP theo ngành | economy.gdp() | VN, US, CN, JP, EU |
| CPI và CPI lõi, so cùng kỳ và so tháng trước | economy.cpi() | VN, US, CN, JP, EU |
| Giá sản xuất, giá xuất nhập khẩu, các nhóm lạm phát | economy.prices() | US, CN, JP, EU |
| Đầu tư trực tiếp nước ngoài | economy.fdi() | VN |
| Xuất khẩu, nhập khẩu, cán cân thương mại, cán cân vãng lai | economy.import_export() | VN, US, CN, JP, EU |
| Ngân sách, nợ công, thu và chi của chính phủ | economy.state_budget() | VN, US, CN, JP, EU |
| Cung tiền | economy.money_supply() | VN, US, CN, JP, EU |
| Sản xuất công nghiệp, chỉ số nhà quản trị mua hàng | economy.industry_prod() | VN, US, CN, JP, EU |
| Bán lẻ | economy.retail() | VN, US, CN, JP, EU |
| Lao động, thất nghiệp | economy.population_labor() | VN, US, CN, JP, EU |
| Nhà ở | economy.housing() | US |
| Lãi suất điều hành | currency.policy_rate() | VN, US, CN, JP, EU |
| Dự trữ ngoại hối | currency.fx_reserves() | VN, US, CN, JP, EU |
| Bảng cân đối ngân hàng trung ương | currency.central_bank_assets() | US, CN, JP, EU |
| Lãi suất tiền gửi theo ngân hàng và kỳ hạn | currency.deposit_rate() | Không nhận country |
| Lãi suất của Cục Dự trữ Liên bang Mỹ | global_macro.fed_rate() | Không nhận country |
| Lợi suất trái phiếu chính phủ 10 năm | global_macro.bond_yield(market="US") | market: VN, US, JP, DE |
Nước không có số của hàm thì lời gọi báo VNSTOCK_INPUT_PARAM kèm các nước có số, không gọi tới nguồn. Lịch công bố
sự kiện kinh tế ở Reference("<nguồn>").events.economic(start=..., end=...).
Tham số
| Tham số | Mặc định | Ý nghĩa |
|---|---|---|
country | "VN" | Nền kinh tế, xem bảng trên |
start, end | Từ năm 2000 tới nay | YYYY-MM-DD, YYYY-MM hoặc YYYY |
length | 12 hay "12b": 12 kỳ mới nhất của mỗi chỉ tiêu; "2Y", "6M": khoảng thời gian tính lùi từ end | |
period | Mọi kỳ | Chỉ giữ một tần suất: "month", "quarter", "year". Tần suất không có số thì báo VNSTOCK_INPUT_PARAM kèm các tần suất có số |
global_macro.bond_yield() không có start thì lấy 30 ngày gần nhất. currency.deposit_rate() trả bảng lãi suất
đang áp dụng, không nhận các tham số thời gian.
Dạng bảng
Mỗi dòng là một chỉ tiêu tại một kỳ, ở mọi hàm trừ deposit_rate():
time | period | country | indicator | indicator_name | indicator_value | value_unit |
|---|---|---|---|---|---|---|
2026-09-01 07:00+07:00 | 2026-09 | VN | cpi-yoy | VN CPI (YoY) | 5,08 | percent |
2026-09-01 07:00+07:00 | 2026-09 | VN | core-cpi-yoy | VN Core CPI (YoY) | 4,55 | percent |
bond_yield() có bốn cột time, indicator, indicator_value, value_unit.
periodgiữ kỳ gốc của nguồn:2026-09,2026-Q3,2026. Trong một hàm có thể có nhiều tần suất, ví dụ GDP có cả quý và năm.timelà ngày đầu kỳ, nên các kỳ khác tần suất vẫn lọc và nối được theo thời gian.value_unitđi theo từng dòng vì một hàm có nhiều đơn vị, ví dụ GDP có tỷ USD và phần trăm. Đừng cộng các chỉ tiêu khác đơn vị.
Muốn mỗi chỉ tiêu một cột:
df = Macro("fhsc").economy.cpi(start="2024-01-01")
wide = df.pivot(index="time", columns="indicator", values="indicator_value")Danh mục hàm
Bảng sinh từ thư viện bản 6.0.0, hồ sơ v5 (mặc định). "Tên khác" là tên của thế hệ 5 cho cùng dữ liệu.
Danh sách đầy đủ trên máy bạn: vnstock tools, hoặc show_api() trong Python.
Kinh tế (economy)
| Hàm | Tên khác | Tham số | Nguồn (source=) |
|---|---|---|---|
cpi() | start, end, length, country | fhsc | |
fdi() | start, end, length, country | fhsc | |
gdp() | start, end, length, country | fhsc | |
housing() | start, end, length, country | fhsc | |
import_export() | start, end, length, country | fhsc | |
industry_prod() | start, end, length, country | fhsc | |
money_supply() | start, end, length, country | fhsc | |
population_labor() | start, end, length, country | fhsc | |
prices() | start, end, length, country | fhsc | |
retail() | start, end, length, country | fhsc | |
state_budget() | start, end, length, country | fhsc |
Cột trả về (hồ sơ v5, mặc định)
| Hàm | Cột |
|---|---|
cpi() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
fdi() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
gdp() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
housing() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
import_export() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
industry_prod() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
money_supply() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
population_labor() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
prices() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
retail() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
state_budget() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
Tiền tệ (currency)
| Hàm | Tên khác | Tham số | Nguồn (source=) |
|---|---|---|---|
central_bank_assets() | start, end, length, country | fhsc | |
deposit_rate() | fhsc | ||
fx_reserves() | start, end, length, country | fhsc | |
policy_rate() | start, end, length, country | fhsc |
Cột trả về (hồ sơ v5, mặc định)
| Hàm | Cột |
|---|---|
central_bank_assets() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
deposit_rate() | bank_id, bank_name, bank_short_name, term, rate_percent, effective_date |
fx_reserves() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
policy_rate() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
Vĩ mô thế giới (global_macro)
| Hàm | Tên khác | Tham số | Nguồn (source=) |
|---|---|---|---|
bond_yield() | market, start, end, length | fhsc | |
fed_rate() | start, end, length | fhsc |
Cột trả về (hồ sơ v5, mặc định)
| Hàm | Cột |
|---|---|
bond_yield() | time, indicator, indicator_value, value_unit |
fed_rate() | time, period, country, indicator, indicator_name, indicator_value, value_unit |
Chưa hỗ trợ
economy.credit(), economy.total_investment(), currency.exchange_rate(), currency.interbank_rate(), currency.omo()
và global_macro.index() báo VNSTOCK_ROUTE_UNSUPPORTED, vì các Open API mà bản này kết nối chưa có chỉ tiêu tương
ứng. Nến tỷ giá dùng Market("<nguồn>").forex("USDVND").ohlcv(), nhóm giá hàng hoá thế giới dùng
Market("<nguồn>").commodity(...).
Số liệu đến từ nguồn bạn chọn. Thời điểm công bố và việc điều chỉnh số liệu do nguồn quyết định.