汇通开放平台

日历介绍

宏观数据日历精确统计了全球主要国家超过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"
      }
    ]
}