匯通開放平台

日曆介紹

宏觀數據日曆精確統計了全球主要國家超過20年的經濟數據。包括經濟數據、事件和假期三大組成部分。可以通過日期、國家、重要程度等篩選功能快速定位所需數據。財經日曆不僅整理了數據的重要性、前值、預測值、公佈值等關鍵信息，還提供了數據解讀功能，幫助用户深入瞭解數據對市場的影響力。此外，財經日曆具有自動更新功能，數據發佈後即時更新，確保用户獲得最新、最精確的數據信息。

日曆API

1. 財經日曆列表

1.1 接口地址

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

1.2 請求參數説明

參數	類型	必填	説明
d	string	是	數據週期（W/W1/M/M1）或具體日期（yyyyMMdd），具體參照接口返回錯誤提示，值由添加接口ip限制時控制

W:當週
W1:下週
M:今天之前的30天（不包含今天）
M1:今天之後的30天（包含今天）
yyyyMMdd:指定某一天，如 20250708

1.3 返回參數説明

名稱	描述
ID	指標id
RECORD_ID	記錄id
IDX_ID	內部指標id
PUBLISH_TIME	發佈時間
UPDATE_TIME	更新時間
PUBLISH_ORG	發佈機構
UPDATE_PERIOD	公佈頻率 1:日 2:周 3:月 4:季度 5:年
AFFECT	數據影響規則
TITLE	指標標題
IDX_PERIOD	週期
IDX_DESC_CN	描述
UNIT	單位
COUNTRY_CN	國家
IDX_RELEVANCE	重要性（1、2、3） 1 最低; 3 最高
PREVIOUS_PRICE	前次公佈值
SURVEY_PRICE	預測值
ACTUAL_PRICE	實際公佈值
STATUS	公佈狀態 1-已公佈 0-未公佈
Res	利多利空信息

返回結果示例

{
  "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": "美國財政部",
      "UPDATE_PERIOD": "2",
      "AFFECT": "",
      "TITLE": "美國 7月7日 3個月期國債競拍-總金額",
      "IDX_PERIOD": "7月7日",
      "IDX_DESC_CN": "3個月期國債競拍-總金額",
      "UNIT": "億美元",
      "COUNTRY_CN": "美國",
      "IDX_RELEVANCE": "2",
      "PREVIOUS_PRICE": "843.3",
      "SURVEY_PRICE": "",
      "ACTUAL_PRICE": "867.2",
      "STATUS": "0",
      "Res": "||"
    }
  ]
}

2. 財經日曆詳情

2.1 接口地址

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

2.2 請求參數説明

參數	類型	必填	説明
id	string	是	指標id

2.3 返回參數説明

名稱	描述
IDX_ID	指標id
PIC_INTERPRE	圖表説明
COUNTRY_CN	國家
IDX_DESC_CN	指標描述
PUBLISH_ORG	發佈機構
UPDATE_PERIOD	公佈頻率 1:日 2:周 3:月 4:季度 5:年
PARAGHRASE	數據釋義
UNIT	單位
UNIT_RATE	比率
KEY_WORD	指標關鍵字

返回結果示例

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "IDX_ID": "112015032410000271",
      "PIC_INTERPRET": "從資金跨境流動角度，影響日元匯率走勢。資金淨流入，對日元有利。",
      "COUNTRY_CN": "日本",
      "IDX_DESC_CN": "外資買進日股",
      "PUBLISH_ORG": "日本財務省",
      "UPDATE_PERIOD": "2",
      "PARAGHRASE": "統計每週日本國內資金購買外國有價證券，以及國外投資者購買日本國內有價證券的規模變化，包括股票和債券。通過購買規模的變化，衡量資金呈現流入還是流出趨勢。",
      "UNIT": "億日元",
      "UNIT_RATE": "*10",
      "KEY_WORD": "(日)周資金流動數據"
    }
  ]
}

3. 假期預告

3.1 接口地址

批量查詢接口：

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

單日詳情接口：

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

3.2 請求參數説明

注意：當路徑參數為非必填項且未提供參數值時，應同時省略其前一個路徑參數，不可單獨省略某一個參數

參數	類型	必填	説明
interval	string	否	day:當天, week:當週(默認)，僅批量查詢接口用
type	int	是	1:假期預告; 2:國債發行預告; 3:財經大事
date	string	否	日期，格式如20150902，僅單日詳情接口用

3.3 返回參數説明

名稱	描述
ID	事件id
COUNTRY	國家
AREA	地點
EVENT_DESC	事件描述
EVENT_TIME	事件發生時間
IMPORTANCE	重要性（1,2,3），1-3依次重要性遞增
TIME_FLAG	時間標識（暫無作用）
UPDATE_TIME	更新時間

返回結果示例

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "55302",
      "COUNTRY": "美國",
      "AREA": "",
      "EVENT_DESC": "CFTC公佈周度持倉報告。",
      "EVENT_TIME": "2025-08-09 03:30:00",
      "IMPORTANCE": "2",
      "TIME_FLAG": "1",
      "UPDATE_TIME": null
    }
  ]
}

4. 美國數據近30天

4.1 接口地址

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

4.2 返回參數説明

名稱	描述
ID	數據id
STATUS	狀態碼 0-未公佈 1-已公佈
IDX_PID	關聯指標id
IDX_PERIOD	指標週期
IDX_ID	指標id
PUBLISH_TIME	發佈時間
UNKNOWN	未知字段
COUNTRY	國家英文名
COUNTRY_CN	國家中文名
IDX_DESC_CN	指標描述
PREVIOUS_PRICE	前次公佈值
ACTUAL_PRICE	實際公佈值
SURPLUS_PRICE	預測值
GT_RES	利多項
LT_RES	利空項
REVISED_PRICE	修正值
UNIT	指標單位
UNIT_RATE	單位比率
IDX_RELEVANCE	重要性（1、2、3） 1 最低; 3 最高
next_publish_time	下次公佈時間

返回結果示例

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "14071",
      "STATUS": "0",
      "IDX_PID": "112015032410000192",
      "IDX_PERIOD": "10月3日當週",
      "IDX_ID": "112015032410013900",
      "PUBLISH_TIME": "2015-10-08 20:30:00",
      "UNKNOWN": null,
      "COUNTRY": "UNITED STATES",
      "COUNTRY_CN": "美國",
      "IDX_DESC_CN": "初請失業金人數四周均值",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "美元",
      "LT_RES": "金銀 石油",
      "REVISED_PRICE": null,
      "UNIT": "萬",
      "UNIT_RATE": "/10",
      "IDX_RELEVANCE": "3",
      "next_publish_time": "2015-10-15 20:30:00"
    }
  ]
}

5. 經濟周曆當週

5.1 接口地址

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

5.2 返回參數説明

名稱	描述
ID	數據id
STATUS	狀態碼 0-未公佈 1-已公佈
IDX_PID	關聯指標id
IDX_PERIOD	指標週期
IDX_ID	指標id
PUBLISH_TIME	發佈時間
UNKNOWN	未知字段
COUNTRY	國家英文名
COUNTRY_CN	國家中文名
IDX_DESC_CN	指標描述
PREVIOUS_PRICE	前次公佈值
ACTUAL_PRICE	實際公佈值
SURPLUS_PRICE	預測值
GT_RES	利多項
LT_RES	利空項
REVISED_PRICE	修正值
UNIT	指標單位
UNIT_RATE	單位比率
IDX_RELEVANCE	重要性（1、2、3） 1 最低; 3 最高

返回結果示例

{
  "code": 0,
  "message": "success",
  "update_time": "",
  "data": [
    {
      "ID": "349",
      "STATUS": "0",
      "IDX_PID": "112015032410000269",
      "IDX_PERIOD": "10月6日當週",
      "IDX_ID": "112015032410000271",
      "PUBLISH_TIME": "2015-10-15 07:50:00",
      "UNKNOWN": null,
      "COUNTRY": "JAPAN",
      "COUNTRY_CN": "日本",
      "IDX_DESC_CN": "外資買進日股",
      "PREVIOUS_PRICE": null,
      "ACTUAL_PRICE": null,
      "SURVEY_PRICE": null,
      "GT_RES": "",
      "LT_RES": "美元",
      "REVISED_PRICE": null,
      "UNIT": "億日元",
      "UNIT_RATE": "*10",
      "IDX_RELEVANCE": "1"
      }
    ]
}