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
GET http://***.***.***/Calendar/lists/d/{d}
1.2 Mô tả tham số
Tham số Loại Bắt buộc Mô tả
d string 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
GET http://***.***.***/Calendar/detail/id/{id}
2.2 Mô tả tham số
Tham số Loại Bắt buộc Mô tả
id string 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ô

GET http://***.***.***/Calendar/forecast/type/{type}/interval/{interval}

API chi tiết trong ngày

GET http://***.***.***/Calendar/eventholiday/date/{date}/type/{type}
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 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
GET http://***.***.***/Calendar/usaData
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
GET http://***.***.***/Calendar/ecweek
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"
      }
    ]
}