Giới thiệu Lịch kinh tế
Lịch dữ liệu kinh tế vĩ mô cung cấp hơn 20 năm số liệu thống kê từ các quốc gia lớn trên thế giới. Bao gồm 3 nhóm chính: dữ liệu kinh tế, sự kiện và ngày nghỉ. Người dùng có thể nhanh chóng tìm thông tin cần thiết bằng bộ lọc theo ngày, quốc gia và mức độ quan trọng. Lịch tài chính không chỉ sắp xếp các thông tin quan trọng như mức độ quan trọng, giá trị trước đó, dự báo và số liệu công bố, mà còn cung cấp phần diễn giải dữ liệu giúp người dùng hiểu rõ hơn tác động tiềm ẩn đến thị trường. Ngoài ra, nó hỗ trợ cập nhật tự động, đảm bảo người dùng nhận được thông tin mới nhất và chính xác nhất ngay sau khi công bố.

API Lịch
1. Danh sách Lịch
1.1 Địa chỉ Giao diện
1.2 Mô tả tham số
Tham số | Loại | Bắt buộc | Mô tả |
---|---|---|---|
d | string | Có | Khoảng dữ liệu (W/W1/M/M1) hoặc ngày cụ thể (yyyyMMdd). Chi tiết xem trong thông báo lỗi API. Giá trị được kiểm soát bởi giới hạn IP. |
- W:Tuần hiện tại
- W1:Tuần tiếp theo
- M:30 ngày trước hôm nay (không bao gồm hôm nay)
- M1:30 ngày sau hôm nay (bao gồm hôm nay)
- yyyyMMdd:Một ngày cụ thể, ví dụ 20250708
1.3 Tham số phản hồi
Tên | Mô tả |
---|---|
ID | ID Chỉ báo |
RECORD_ID | ID Bản ghi |
IDX_ID | ID Chỉ báo nội bộ |
PUBLISH_TIME | Thời gian công bố |
UPDATE_TIME | Thời gian cập nhật |
PUBLISH_ORG | Cơ quan công bố |
UPDATE_PERIOD | Tần suất công bố 1:Hàng ngày 2:Hàng tuần 3:Hàng tháng 4:Hàng quý 5:Hàng năm |
AFFECT | Quy tắc tác động thị trường |
TITLE | Tiêu đề Chỉ báo |
IDX_PERIOD | Giai đoạn |
IDX_DESC_CN | Mô tả |
UNIT | Đơn vị |
COUNTRY_CN | Quốc gia |
IDX_RELEVANCE | Mức độ quan trọng (1,2,3) — 1 thấp nhất; 3 cao nhất |
PREVIOUS_PRICE | Giá trị trước đó |
SURVEY_PRICE | Giá trị dự báo |
ACTUAL_PRICE | Giá trị thực tế |
STATUS | Trạng thái công bố: 1-Đã công bố, 0-Đang chờ |
Res | Thông tin Tăng/Giảm |
Phản hồi mẫu
{ "code": 0, "message": "success", "update_time": "", "data": [ { "ID": "43627", "RECORD_ID": "558993", "IDX_ID": "112022041910001492", "PUBLISH_TIME": "2025-07-08 02:00:00", "UPDATE_TIME": "2025-07-08 08:43:43", "PUBLISH_ORG": "Bộ Tài chính Hoa Kỳ", "UPDATE_PERIOD": "2", "AFFECT": "", "TITLE": "Đấu giá Trái phiếu Kho bạc Hoa Kỳ kỳ hạn 3 tháng ngày 7/7 – Tổng giá trị", "IDX_PERIOD": "7月7日", "IDX_DESC_CN": "Đấu giá Trái phiếu 3 tháng – Tổng giá trị", "UNIT": "100 triệu USD", "COUNTRY_CN": "Hoa Kỳ", "IDX_RELEVANCE": "2", "PREVIOUS_PRICE": "843.3", "SURVEY_PRICE": "", "ACTUAL_PRICE": "867.2", "STATUS": "0", "Res": "||" } ] }
2. Chi tiết Lịch tài chính
2.1 Địa chỉ Giao diện
2.2 Mô tả tham số
Tham số | Loại | Bắt buộc | Mô tả |
---|---|---|---|
id | string | Có | ID Chỉ báo |
2.3 Tham số phản hồi
Tên | Mô tả |
---|---|
IDX_ID | ID Chỉ báo |
PIC_INTERPRE | Ghi chú biểu đồ |
COUNTRY_CN | Quốc gia |
IDX_DESC_CN | Mô tả Chỉ số |
PUBLISH_ORG | Cơ quan công bố |
UPDATE_PERIOD | Tần suất công bố 1:Hàng ngày 2:Hàng tuần 3:Hàng tháng 4:Hàng quý 5:Hàng năm |
PARAGHRASE | Giải thích dữ liệu |
UNIT | Đơn vị |
UNIT_RATE | Tỷ lệ |
KEY_WORD | Từ khóa Chỉ số |
Phản hồi mẫu
{ "code": 0, "message": "success", "update_time": "", "data": [ { "IDX_ID": "112015032410000271", "PIC_INTERPRET": "Từ góc nhìn dòng vốn xuyên biên giới, điều này ảnh hưởng đến tỷ giá JPY. Dòng vốn ròng vào là tích cực cho JPY.", "COUNTRY_CN": "Nhật Bản", "IDX_DESC_CN": "Mua cổ phiếu Nhật Bản của người nước ngoài", "PUBLISH_ORG": "Bộ Tài chính Nhật Bản", "UPDATE_PERIOD": "2", "PARAGHRASE": "Thống kê hàng tuần về mua chứng khoán nước ngoài trong nước và mua chứng khoán Nhật Bản của người nước ngoài, bao gồm cả cổ phiếu và trái phiếu. Thay đổi quy mô mua phản ánh xu hướng dòng vốn vào hoặc ra.", "UNIT": "100 Triệu JPY", "UNIT_RATE": "*10", "KEY_WORD": "(JP) Dữ liệu dòng vốn hàng tuần" } ] }
3. Thông báo ngày nghỉ
3.1 Địa chỉ Giao diện
API truy vấn theo lô
API chi tiết trong ngày
3.2 Mô tả tham số
Lưu ý: Khi tham số đường dẫn là tùy chọn và không cung cấp giá trị, tham số đường dẫn trước đó cũng nên được bỏ qua. Không được bỏ qua chỉ một tham số.
Tham số | Loại | Bắt buộc | Mô tả |
---|---|---|---|
interval | string | Không | day: ngày hiện tại, week: tuần hiện tại (mặc định). Chỉ áp dụng cho truy vấn theo lô |
type | int | Có | 1: Thông báo ngày nghỉ; 2: Phát hành trái phiếu chính phủ; 3: Sự kiện kinh tế |
date | string | Không | Ngày theo định dạng yyyyMMdd, chỉ dùng cho truy vấn trong ngày |
3.3 Tham số phản hồi
Tên | Mô tả |
---|---|
ID | Mã sự kiện |
COUNTRY | Quốc gia |
AREA | Địa điểm |
EVENT_DESC | Mô tả sự kiện |
EVENT_TIME | Thời gian sự kiện |
IMPORTANCE | Mức độ quan trọng (1,2,3) — số cao hơn biểu thị mức quan trọng lớn hơn |
TIME_FLAG | Cờ thời gian (hiện chưa sử dụng) |
UPDATE_TIME | Thời gian cập nhật |
Phản hồi mẫu
{ "code": 0, "message": "success", "update_time": "", "data": [ { "ID": "55302", "COUNTRY": "Hoa Kỳ", "AREA": "", "EVENT_DESC": "CFTC công bố báo cáo vị thế hàng tuần", "EVENT_TIME": "2025-08-09 03:30:00", "IMPORTANCE": "2", "TIME_FLAG": "1", "UPDATE_TIME": null } ] }
4. Dữ liệu Mỹ (30 ngày gần đây)
4.1 Địa chỉ Giao diện
4.2 Tham số phản hồi
Tên | Mô tả |
---|---|
ID | Mã dữ liệu |
STATUS | Mã trạng thái 0-Đang chờ, 1-Đã phát hành |
IDX_PID | Mã Chỉ số liên quan |
IDX_PERIOD | Kỳ Chỉ số |
IDX_ID | ID Chỉ báo |
PUBLISH_TIME | Thời gian công bố |
UNKNOWN | Trường không xác định |
COUNTRY | Quốc gia (EN) |
COUNTRY_CN | Quốc gia (CN) |
IDX_DESC_CN | Mô tả Chỉ số |
PREVIOUS_PRICE | Giá trị trước đó |
ACTUAL_PRICE | Giá trị thực tế |
SURPLUS_PRICE | Giá trị dự báo |
GT_RES | Yếu tố tăng giá |
LT_RES | Yếu tố giảm giá |
REVISED_PRICE | Giá trị điều chỉnh |
UNIT | Đơn vị Chỉ số |
UNIT_RATE | Tỷ lệ đơn vị |
IDX_RELEVANCE | Mức độ quan trọng (1,2,3) — 1 thấp nhất; 3 cao nhất |
next_publish_time | Ngày phát hành tiếp theo |
Phản hồi mẫu
{ "code": 0, "message": "success", "update_time": "", "data": [ { "ID": "14071", "STATUS": "0", "IDX_PID": "112015032410000192", "IDX_PERIOD": "Tuần của ngày 3/10", "IDX_ID": "112015032410013900", "PUBLISH_TIME": "2015-10-08 20:30:00", "UNKNOWN": null, "COUNTRY": "UNITED STATES", "COUNTRY_CN": "Hoa Kỳ", "IDX_DESC_CN": "Trung bình 4 tuần đơn xin trợ cấp thất nghiệp ban đầu", "PREVIOUS_PRICE": null, "ACTUAL_PRICE": null, "SURVEY_PRICE": null, "GT_RES": "USD", "LT_RES": "Vàng, Bạc, Dầu", "REVISED_PRICE": null, "UNIT": "Mười nghìn", "UNIT_RATE": "/10", "IDX_RELEVANCE": "3", "next_publish_time": "2015-10-15 20:30:00" } ] }
5. Lịch kinh tế hàng tuần (tuần hiện tại)
5.1 Địa chỉ Giao diện
5.2 Tham số phản hồi
Tên | Mô tả |
---|---|
ID | Mã dữ liệu |
STATUS | Mã trạng thái 0-Đang chờ, 1-Đã phát hành |
IDX_PID | Mã Chỉ số liên quan |
IDX_PERIOD | Kỳ Chỉ số |
IDX_ID | ID Chỉ báo |
PUBLISH_TIME | Thời gian công bố |
UNKNOWN | Trường không xác định |
COUNTRY | Quốc gia (EN) |
COUNTRY_CN | Quốc gia (CN) |
IDX_DESC_CN | Mô tả Chỉ số |
PREVIOUS_PRICE | Giá trị trước đó |
ACTUAL_PRICE | Giá trị thực tế |
SURPLUS_PRICE | Giá trị dự báo |
GT_RES | Yếu tố tăng giá |
LT_RES | Yếu tố giảm giá |
REVISED_PRICE | Giá trị điều chỉnh |
UNIT | Đơn vị Chỉ số |
UNIT_RATE | Tỷ lệ đơn vị |
IDX_RELEVANCE | Mức độ quan trọng (1,2,3) — 1 thấp nhất; 3 cao nhất |
Phản hồi mẫu
{ "code": 0, "message": "success", "update_time": "", "data": [ { "ID": "349", "STATUS": "0", "IDX_PID": "112015032410000269", "IDX_PERIOD": "Tuần của ngày 6/10", "IDX_ID": "112015032410000271", "PUBLISH_TIME": "2015-10-15 07:50:00", "UNKNOWN": null, "COUNTRY": "JAPAN", "COUNTRY_CN": "Nhật Bản", "IDX_DESC_CN": "Mua cổ phiếu Nhật Bản của người nước ngoài", "PREVIOUS_PRICE": null, "ACTUAL_PRICE": null, "SURVEY_PRICE": null, "GT_RES": "", "LT_RES": "USD", "REVISED_PRICE": null, "UNIT": "100 Triệu JPY", "UNIT_RATE": "*10", "IDX_RELEVANCE": "1" } ] }