European Central Bank欧洲央行 Data Portal SDMX API
GET/data/{flowRef}
按数据流获取数据
返回数据流中的数据。该变体省略 Series key，因此可能匹配大量时间序列；调用方应使用日期、detail 或 Observation 数量参数限制响应。
查询欧洲央行公开的 SDMX 2.1 统计数据、结构元数据与结构特定 XML Schema；覆盖完整路径变体、内容协商与 12 个可检索 Schema。
请求
- operationId
getDataByFlow- 服务器
https://data-api.ecb.europa.eu/service- 认证
- 无
请求参数
flowRef
pathstring必填
数据流引用：flow ID，或以逗号分隔的 agency ID、flow ID 和 version。
EXR
startPeriod
querystring
ISO 8601 或 SDMX reporting period：年、半年、季度、月、周或日。
2024-01
endPeriod
querystring
ISO 8601 或 SDMX reporting period：年、半年、季度、月、周或日。
2024-01
updatedAfter
querystringdate-time
只返回该 ISO 8601 时间戳之后新增、修订或删除的最新值。
2024-01-01T00:00:00Z
firstNObservations
queryinteger
每个匹配时间序列从第一条开始最多返回的 Observation 数量。
1
lastNObservations
queryinteger
每个匹配时间序列从最近一条向前最多返回的 Observation 数量。
1
detail
querystring
返回的数据细节级别。
full
includeHistory
queryboolean
是否包含匹配数据的历史版本。
false
format
querystring
响应格式；也可通过 Accept header 选择。
jsondata
If-Modified-Since
headerstringhttp-date
HTTP 条件请求时间。若数据没有变化，服务返回 304。
Mon, 01 Jan 2024 00:00:00 GMT
Accept
headerstring
选择响应表示。ECB 建议使用带版本的专用 media type。
application/vnd.sdmx.data+json;version=1.0.0-wd
Accept-Encoding
headerstring
请求压缩响应，例如 gzip。
gzip
响应
200
SdmxDataMessageapplication/vnd.sdmx.data+json;version=1.0.0-wdapplication/jsontext/csvapplication/vnd.ecb.data+csv;version=1.0.0application/vnd.sdmx.genericdata+xml;version=2.1application/vnd.sdmx.structurespecificdata+xml;version=2.1application/xml
请求成功；响应表示由 format 查询参数或 Accept header 选择。
字段: headerdataSetsstructure
304
unknownapplication/vnd.sdmx.data+json;version=1.0.0-wdapplication/jsontext/csvapplication/vnd.ecb.data+csv;version=1.0.0application/vnd.sdmx.genericdata+xml;version=2.1application/vnd.sdmx.structurespecificdata+xml;version=2.1application/xmltext/plain
自 If-Modified-Since 指定时间起没有变化；响应没有 body。
400
ErrorBodytext/plainapplication/xmlapplication/json
查询参数存在语法或语义错误。
404
ErrorBodytext/plainapplication/xmlapplication/json
没有匹配结果。
406
ErrorBodytext/plainapplication/xmlapplication/json
请求的响应表示不受支持。
500
ErrorBodytext/plainapplication/xmlapplication/json
ECB 服务内部错误。
501
ErrorBodytext/plainapplication/xmlapplication/json
请求使用了 ECB 尚未实现的 SDMX REST 功能。
503
ErrorBodytext/plainapplication/xmlapplication/json
ECB 服务暂时不可用。
{
"header": {
"id": "b8cdb8e9-3de8-41f7-a83e-c6e475a6e7ab",
"test": false,
"prepared": "2026-08-14T16:23:35.250+02:00",
"sender": {
"id": "ECB"
}
},
"dataSets": {
"action": "Replace",
"validFrom": "2026-08-14T16:23:35.250+02:00",
"series": {}
},
"structure": {
"links": {
"title": "Exchange Rates",
"rel": "dataflow",
"href": "https://data-api.ecb.europa.eu/service/dataflow/ECB/EXR/1.0"
},
"name": "Exchange Rates",
"dimensions": {
"series": {},
"observation": {}
},
"attributes": {
"series": {},
"observation": {}
}
}
}