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
Economic Calendar - Daily Data
Interface Address
Chinese API:
GET http://openapicy.fx678.com/api/calendar/202605/data?token=XXXXXX&date=XXXXXX
English API:
GET http://openapicy.fx678.com/apien/calendar/202605/data?token=XXXXXX&date=XXXXXX
Traditional Chinese API:
GET http://openapicy.fx678.com/apitc/calendar/202605/data?token=XXXXXX&date=XXXXXX
Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | Yes | API Access Token |
| date | string | Yes | Date (format: YYYY-MM-DD) |
Response Parameters
| Name | Description |
|---|---|
| code | Status Code |
| message | Status Message |
| data | Data |
| ID | Record ID |
| IDX_ID | Indicator ID |
| COUNTRY_CN | Country |
| IDX_PERIOD | Indicator Period |
| IDX_DESC_CN | Indicator Description |
| PREVIOUS_PRICE | Previous Value |
| SURVEY_PRICE | Forecast Value |
| ACTUAL_PRICE | Actual Value |
| REVISED_PRICE | Revised Value |
| IDX_RELEVANCE | Importance (1,2,3) — 1 lowest; 3 highest |
| PUBLISH_TIME | Release Time |
| UNIT | Unit |
| TITLE | Title |
| GT_RES | Bullish Factors |
| LT_RES | Bearish Factors |
Sample Response
{
"code": 200,
"message": "",
"data": [
{
"ID": 595419,
"IDX_ID": "112015032410000031",
"COUNTRY_CN": "United States",
"IDX_PERIOD": "5Month",
"IDX_PERIOD_STATUS": "",
"IDX_DESC_CN": "BRCShop Price Index YoY",
"PREVIOUS_PRICE": "1",
"SURVEY_PRICE": "",
"ACTUAL_PRICE": "1.2",
"REVISED_PRICE": "",
"IDX_RELEVANCE": "1",
"PUBLISH_TIME": "2026-05-26 07:01:00",
"UNIT": "%",
"GT_RES": "",
"LT_RES": "",
"TITLE": "United States 5Month BRCShop Price Index YoY(%)"
}
]
}
Economic Calendar - Weekly Data
Interface Address
Chinese API:
GET http://openapicy.fx678.com/api/calendar/202605/week?token=XXXXXX&week=XXXXXX
English API:
GET http://openapicy.fx678.com/apien/calendar/202605/week?token=XXXXXX&week=XXXXXX
Traditional Chinese API:
GET http://openapicy.fx678.com/apitc/calendar/202605/week?token=XXXXXX&week=XXXXXX
Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | Yes | API Access Token |
| week | string | Yes |
Period parameters (w/w1/m/m1) allow queries for a time range.
|
Sample Response
{
"code": 200,
"message": "",
"data": [
{
"ID": 595419,
"IDX_ID": "112015032410000031",
"COUNTRY_CN": "United States",
"IDX_PERIOD": "5Month",
"IDX_PERIOD_STATUS": "",
"IDX_DESC_CN": "BRCShop Price Index YoY",
"PREVIOUS_PRICE": "1",
"SURVEY_PRICE": "",
"ACTUAL_PRICE": "1.2",
"REVISED_PRICE": "",
"IDX_RELEVANCE": "1",
"PUBLISH_TIME": "2026-05-26 07:01:00",
"UNIT": "%",
"GT_RES": "",
"LT_RES": "",
"TITLE": "United States 5Month BRCShop Price Index YoY(%)"
}
]
}
Economic Calendar - Monthly Data
Interface Address
Chinese API:
GET http://openapicy.fx678.com/api/calendar/202605/month?token=XXXXXX&month=XXXXXX
English API:
GET http://openapicy.fx678.com/apien/calendar/202605/month?token=XXXXXX&month=XXXXXX
Traditional Chinese API:
GET http://openapicy.fx678.com/apitc/calendar/202605/month?token=XXXXXX&month=XXXXXX
Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | Yes | API Access Token |
| month | 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.
|
Sample Response
{
"code": 200,
"message": "",
"data": [
{
"ID": 595419,
"IDX_ID": "112015032410000031",
"COUNTRY_CN": "United States",
"IDX_PERIOD": "5Month",
"IDX_PERIOD_STATUS": "",
"IDX_DESC_CN": "BRCShop Price Index YoY",
"PREVIOUS_PRICE": "1",
"SURVEY_PRICE": "",
"ACTUAL_PRICE": "1.2",
"REVISED_PRICE": "",
"IDX_RELEVANCE": "1",
"PUBLISH_TIME": "2026-05-26 07:01:00",
"UNIT": "%",
"GT_RES": "",
"LT_RES": "",
"TITLE": "United States 5Month BRCShop Price Index YoY(%)"
}
]
}
Financial Calendar Details
Interface Address
Chinese API:
GET http://openapicy.fx678.com/api/calendar/202605/info?token=XXXXXX&idxid=XXXXXX
English API:
GET http://openapicy.fx678.com/apien/calendar/202605/info?token=XXXXXX&idxid=XXXXXX
Traditional Chinese API:
GET http://openapicy.fx678.com/apitc/calendar/202605/info?token=XXXXXX&idxid=XXXXXX
Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | Yes | API Access Token |
| idxid | string | Yes | Indicator ID |
Response Parameters
| Name | Description |
|---|---|
| code | Status Code |
| message | Status Message |
| data | Data |
| IDX_ID | Indicator ID |
| PUBLISH_ORG | Publishing Institution |
| PIC_INTERPRET | Chart Notes |
| PARAGHRASE | Data Interpretation |
| REFERENCE | Reference products |
| UPDATE_PERIOD | Release Frequency 1:Daily 2:Weekly 3:Monthly 4:Quarterly 5:Yearly |
| PERIOD_DESC | Update frequency description |
| COUNTRY_CN | Country |
| IDX_DESC_CN | Indicator Description |
| PUBLISH_TIME | Release Time |
| AFFECT | Market Impact Rules |
| IDX_RELEVANCE | Importance (1,2,3) — 1 lowest; 3 highest |
| UNIT | Unit |
Sample Response
{
"code": 200,
"msg": "",
"data": {
"IDX_ID": "110202106181703204",
"PUBLISH_ORG": "Shanghai Gangyin E-commerce",
"PIC_INTERPRET": "Higher steel inventory indicates sufficient supply, which is bearish for steel products such as rebar and hot-rolled coils.",
"PARAGHRASE": "This indicator is released weekly by China's Gangyin Steel Network. Gangyin surveys major steel warehouses nationwide, with approximately 140-150 warehouse samples covering around 40 cities each time. The sample size may vary slightly per survey.",
"REFERENCE": "Stainless Steel, Rebar, Hot Rolled Coil, Wire Rod, Base Metals",
"UPDATE_PERIOD": 2,
"PERIOD_DESC": "Once a week",
"COUNTRY_CN": "中国",
"IDX_DESC_CN": "Gangyin National City Total Steel Inventory",
"AFFECT": "",
"IDX_RELEVANCE": 2,
"UNIT": "10,000 tons"
}
}
Financial Events and Holiday Announcements
Interface Address
Chinese API:
GET http://openapicy.fx678.com/api/calendar/202605/event?token=XXXXXX&type=XXXXXX&date=XXXXXX
English API:
GET http://openapicy.fx678.com/apien/calendar/202605/event?token=XXXXXX&type=XXXXXX&date=XXXXXX
Traditional Chinese API:
GET http://openapicy.fx678.com/apitc/calendar/202605/event?token=XXXXXX&type=XXXXXX&date=XXXXXX
Parameter Description
| Parameter | Type | Required | Description |
|---|---|---|---|
| token | string | Yes | API Access Token |
| type | int | Yes |
Event Type
|
| date | string | Yes | Date (format: YYYY-MM-DD) |
Response Parameters
| Name | Description |
|---|---|
| code | Status Code |
| message | Status Message |
| data | Data |
| COUNTRY | Country |
| AREA | Area |
| EVENT_DESC | Content |
| EVENT_TIME | Event Time |
| IMPORTANCE | Importance |
| TIME_FLAG | Time Flag |
Sample Response
{
"code": 200,
"message": "",
"data": [
{
"COUNTRY": "United States",
"AREA": "",
"EVENT_DESC": "Meta 2026Annual Shareholders Meeting",
"EVENT_TIME": "2026-05-28 01:01:00",
"IMPORTANCE": 2,
"TIME_FLAG": 1
}
]
}