Huitong Open Platform

Calendar Introduction

The macroeconomic data calendar provides over 20 years of statistics from major countries worldwide. It covers three key categories: economic data, events, and holidays. Users can quickly locate required information using filters such as date, country, and importance level. The financial calendar not only organizes key details such as importance, previous values, forecasts, and actual releases, but also offers data interpretation to help users understand the potential market impact. Additionally, it supports automatic updates, ensuring users receive the latest and most accurate data immediately after release.

Calendar API

1. Calendar List

1.1 Interface Address

GET http://***.***.***/Calendar/lists/d/{d}

1.2 Parameter Description

Parameter	Type	Required	Description
d	string	Yes	Data period (W/W1/M/M1) or specific date (yyyyMMdd). For details, refer to API error messages. Values are controlled by IP restrictions.

W:Current week
W1:Next week
M:30 days before today (excluding today)
M1:30 days after today (including today)
yyyyMMdd:A specific day, e.g., 20250708

1.3 Response Parameters

Name	Description
ID	Indicator ID
RECORD_ID	Record ID
IDX_ID	Internal Indicator ID
PUBLISH_TIME	Release Time
UPDATE_TIME	Update Time
PUBLISH_ORG	Publishing Institution
UPDATE_PERIOD	Release Frequency 1:Daily 2:Weekly 3:Monthly 4:Quarterly 5:Yearly
AFFECT	Market Impact Rules
TITLE	Indicator Title
IDX_PERIOD	Period
IDX_DESC_CN	Description
UNIT	Unit
COUNTRY_CN	Country
IDX_RELEVANCE	Importance (1,2,3) — 1 lowest; 3 highest
PREVIOUS_PRICE	Previous Value
SURVEY_PRICE	Forecast Value
ACTUAL_PRICE	Actual Value
STATUS	Release Status: 1-Released, 0-Pending
Res	Bullish/Bearish Info

Sample Response

{
  "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": "U.S. Treasury Department",
      "UPDATE_PERIOD": "2",
      "AFFECT": "",
      "TITLE": "U.S. July 7 3-Month Treasury Auction – Total Amount",
      "IDX_PERIOD": "7月7日",
      "IDX_DESC_CN": "3-Month Treasury Auction – Total Amount",
      "UNIT": "USD 100 Million",
      "COUNTRY_CN": "United States",
      "IDX_RELEVANCE": "2",
      "PREVIOUS_PRICE": "843.3",
      "SURVEY_PRICE": "",
      "ACTUAL_PRICE": "867.2",
      "STATUS": "0",
      "Res": "||"
    }
  ]
}

2. Financial Calendar Details

2.1 Interface Address

GET http://***.***.***/Calendar/detail/id/{id}

2.2 Parameter Description

Parameter	Type	Required	Description
id	string	Yes	Indicator ID

2.3 Response Parameters

Name	Description
IDX_ID	Indicator ID
PIC_INTERPRE	Chart Notes
COUNTRY_CN	Country
IDX_DESC_CN	Indicator Description
PUBLISH_ORG	Publishing Institution
UPDATE_PERIOD	Release Frequency 1:Daily 2:Weekly 3:Monthly 4:Quarterly 5:Yearly
PARAGHRASE	Data Interpretation
UNIT	Unit
UNIT_RATE	Ratio
KEY_WORD	Indicator Keywords

Sample Response

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "IDX_ID": "112015032410000271",
      "PIC_INTERPRET": "From the perspective of cross-border capital flows, this impacts the JPY exchange rate. Net inflows are positive for JPY.",
      "COUNTRY_CN": "Japan",
      "IDX_DESC_CN": "Foreign Purchases of Japanese Equities",
      "PUBLISH_ORG": "Ministry of Finance, Japan",
      "UPDATE_PERIOD": "2",
      "PARAGHRASE": "Weekly statistics on domestic purchases of foreign securities and foreign purchases of Japanese securities, including both stocks and bonds. Changes in purchase scale indicate inflow or outflow trends.",
      "UNIT": "100 Million JPY",
      "UNIT_RATE": "*10",
      "KEY_WORD": "(JP) Weekly Capital Flow Data"
    }
  ]
}

3. Holiday Announcements

3.1 Interface Address

Batch Query API:

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

Single-Day Detail API:

GET http://***.***.***/Calendar/eventholiday/date/{date}/type/{type}

3.2 Parameter Description

Note: When a path parameter is optional and no value is provided, the preceding path parameter should also be omitted. Do not omit only one parameter.

Parameter	Type	Required	Description
interval	string	No	day: current day, week: current week (default). For batch query only.
type	int	Yes	1: Holiday Announcement; 2: Treasury Issuance; 3: Economic Event
date	string	No	Date in yyyyMMdd format, used only in single-day queries

3.3 Response Parameters

Name	Description
ID	Event ID
COUNTRY	Country
AREA	Location
EVENT_DESC	Event Description
EVENT_TIME	Event Time
IMPORTANCE	Importance (1,2,3) — higher numbers indicate greater importance
TIME_FLAG	Time Flag (currently unused)
UPDATE_TIME	Update Time

Sample Response

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "55302",
      "COUNTRY": "United States",
      "AREA": "",
      "EVENT_DESC": "CFTC publishes weekly position report.",
      "EVENT_TIME": "2025-08-09 03:30:00",
      "IMPORTANCE": "2",
      "TIME_FLAG": "1",
      "UPDATE_TIME": null
    }
  ]
}

4. U.S. Data (Last 30 Days)

4.1 Interface Address

GET http://***.***.***/Calendar/usaData

4.2 Response Parameters

Name	Description
ID	Data ID
STATUS	Status Code 0-Pending, 1-Released
IDX_PID	Related Indicator ID
IDX_PERIOD	Indicator Period
IDX_ID	Indicator ID
PUBLISH_TIME	Release Time
UNKNOWN	Unknown Field
COUNTRY	Country (EN)
COUNTRY_CN	Country (CN)
IDX_DESC_CN	Indicator Description
PREVIOUS_PRICE	Previous Value
ACTUAL_PRICE	Actual Value
SURPLUS_PRICE	Forecast Value
GT_RES	Bullish Factors
LT_RES	Bearish Factors
REVISED_PRICE	Revised Value
UNIT	Indicator Unit
UNIT_RATE	Unit Ratio
IDX_RELEVANCE	Importance (1,2,3) — 1 lowest; 3 highest
next_publish_time	Next Release Date

Sample Response

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "14071",
      "STATUS": "0",
      "IDX_PID": "112015032410000192",
      "IDX_PERIOD": "Week of Oct 3",
      "IDX_ID": "112015032410013900",
      "PUBLISH_TIME": "2015-10-08 20:30:00",
      "UNKNOWN": null,
      "COUNTRY": "UNITED STATES",
      "COUNTRY_CN": "United States",
      "IDX_DESC_CN": "4-Week Average Initial Jobless Claims",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "USD",
      "LT_RES": "Gold, Silver, Oil",
      "REVISED_PRICE": null,
      "UNIT": "Ten Thousand",
      "UNIT_RATE": "/10",
      "IDX_RELEVANCE": "3",
      "next_publish_time": "2015-10-15 20:30:00"
    }
  ]
}

5. Weekly Economic Calendar (Current Week)

5.1 Interface Address

GET http://***.***.***/Calendar/ecweek

5.2 Response Parameters

Name	Description
ID	Data ID
STATUS	Status Code 0-Pending, 1-Released
IDX_PID	Related Indicator ID
IDX_PERIOD	Indicator Period
IDX_ID	Indicator ID
PUBLISH_TIME	Release Time
UNKNOWN	Unknown Field
COUNTRY	Country (EN)
COUNTRY_CN	Country (CN)
IDX_DESC_CN	Indicator Description
PREVIOUS_PRICE	Previous Value
ACTUAL_PRICE	Actual Value
SURPLUS_PRICE	Forecast Value
GT_RES	Bullish Factors
LT_RES	Bearish Factors
REVISED_PRICE	Revised Value
UNIT	Indicator Unit
UNIT_RATE	Unit Ratio
IDX_RELEVANCE	Importance (1,2,3) — 1 lowest; 3 highest

Sample Response

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "349",
      "STATUS": "0",
      "IDX_PID": "112015032410000269",
      "IDX_PERIOD": "Week of Oct 6",
      "IDX_ID": "112015032410000271",
      "PUBLISH_TIME": "2015-10-15 07:50:00",
      "UNKNOWN": null,
      "COUNTRY": "JAPAN",
      "COUNTRY_CN": "Japan",
      "IDX_DESC_CN": "Foreign Purchases of Japanese Equities",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "",
      "LT_RES": "USD",
      "REVISED_PRICE": null,
      "UNIT": "100 Million JPY",
      "UNIT_RATE": "*10",
      "IDX_RELEVANCE": "1"
      }
    ]
}