宏观经济数据

查询宏观指标数据

通过 WX 指标编号查询指定日期范围的宏观时间序列

查看完整文档查看 Markdown 下载本页 MD

版本 1 更新于 2026-07-16 18:19

接口基本信息

接口名称: get_edb_data_by_displayid
功能描述: 使用公开 displayid 查询指定日期范围内的宏观经济指标时间序列
数据更新频率: 取决于指标自身频率
请求方法: POST
API 路径: https://api.wanxingai.com/openapi/edb/by_displayid/
认证方式: Authorization: Bearer sk-********

输入参数说明

参数名	类型	必选	描述	示例
`displayid`	str	是	自然语言匹配接口返回的公开指标编号，格式为 `WX` 加 9 位数字	`WX567563093`
`startdate`	str	是	查询开始日期，格式为 `YYYY-MM-DD`	`2019-01-01`
`enddate`	str	是	查询结束日期，格式为 `YYYY-MM-DD`	`2020-12-31`

indicators 可作为 displayid 的兼容别名，但新接入建议统一使用 displayid。

返回数据说明

字段名	类型	描述
`status`	int	业务状态码，`200` 表示请求成功
`message.displayid`	str	本次查询使用的公开指标编号
`message.startdate`	str	查询开始日期
`message.enddate`	str	查询结束日期
`message.tables`	array	指标时间序列表格；没有对应日期数据时仍可能成功返回空数组字段
`tables[].id`	array	公开指标编号数组，编号仍为 `WX` 格式
`tables[].time`	array	数据日期数组
`tables[].value`	array	指标值数组，与 `time` 按下标一一对应
`tables[].rtime`	array	数据更新时间数组，具体内容取决于上游数据
`tables[].index_name`	array	指标名称或附加描述数组
`error`	str	失败原因，仅失败时返回

返回示例

{
  "status": 200,
  "message": {
    "displayid": "WX567563093",
    "startdate": "2019-01-01",
    "enddate": "2020-12-31",
    "tables": [
      {
        "id": ["WX567563093"],
        "time": ["2020-12-31", "2019-12-31"],
        "value": ["43957.0", "45445.0"],
        "rtime": [],
        "index_name": []
      }
    ]
  }
}

使用示例

import requests

url = "https://api.wanxingai.com/openapi/edb/by_displayid/"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk-********"
}
payload = {
    "displayid": "WX567563093",
    "startdate": "2019-01-01",
    "enddate": "2020-12-31"
}

resp = requests.post(url, json=payload, headers=headers)
resp.raise_for_status()
print(resp.json())

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

HttpClient client = HttpClient.newHttpClient();
String json = """
    {
      "displayid": "WX567563093",
      "startdate": "2019-01-01",
      "enddate": "2020-12-31"
    }
    """;

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.wanxingai.com/openapi/edb/by_displayid/"))
    .header("Content-Type", "application/json")
    .header("Authorization", "Bearer sk-********")
    .POST(HttpRequest.BodyPublishers.ofString(json))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

curl -X POST https://api.wanxingai.com/openapi/edb/by_displayid/ \\
  -H "Content-Type: application/json" \\
  -H "Authorization: Bearer sk-********" \\
  -d '{
    "displayid": "WX567563093",
    "startdate": "2019-01-01",
    "enddate": "2020-12-31"
  }'

注意事项

该接口只接受 WX 加 9 位数字的公开编号，不能传入其他来源的原始指标编号
startdate 和 enddate 均为闭区间日期，且开始日期不能晚于结束日期
指标发布频率可能是日、月、季或年；请求成功但 time、value 为空，表示该日期范围没有观测值
建议先调用“自然语言匹配宏观指标”接口获取 displayid，再调用本接口查询数据