Pontx Hub面向开发者与 Agent 的 API 参考
European Central Bank/getDataBySeriesKey

仅预览 · 原因见下方

European Central Bank欧洲央行 Data Portal SDMX API

GET/data/{flowRef}/{key}

按数据流和 Series key 获取数据

返回指定数据流中与 Series key 匹配的时间序列。key 按 DSD 维度顺序以点号连接；空段表示通配，`+` 表示 OR。请使用日期或 Observation 数量参数限制响应规模。

查询欧洲央行公开的 SDMX 2.1 统计数据、结构元数据与结构特定 XML Schema；覆盖完整路径变体、内容协商与 12 个可检索 Schema。

请求

operationId
getDataBySeriesKey
服务器
https://data-api.ecb.europa.eu/service
认证
无

请求参数

flowRef

pathstring必填

数据流引用：flow ID，或以逗号分隔的 agency ID、flow ID 和 version。

EXR

key

pathstring必填

按 DSD 维度顺序排列的 Series key；点号分隔，空段通配，`+` 表示 OR。

M.USD.EUR.SP00.A

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

unknown

自 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": [
        {
          "id": "FREQ",
          "name": "Frequency",
          "role": "time",
          "values": [
            {
              "id": "M",
              "name": "Monthly",
              "start": "2024-01-01T00:00:00.000+01:00",
              "end": "2024-01-31T23:59:59.999+01:00"
            }
          ]
        }
      ],
      "observation": [
        {
          "id": "FREQ",
          "name": "Frequency",
          "role": "time",
          "values": [
            {
              "id": "M",
              "name": "Monthly",
              "start": "2024-01-01T00:00:00.000+01:00",
              "end": "2024-01-31T23:59:59.999+01:00"
            }
          ]
        }
      ]
    },
    "attributes": {
      "series": [
        {
          "id": "FREQ",
          "name": "Frequency",
          "role": "time",
          "values": [
            {
              "id": "M",
              "name": "Monthly",
              "start": "2024-01-01T00:00:00.000+01:00",
              "end": "2024-01-31T23:59:59.999+01:00"
            }
          ]
        }
      ],
      "observation": [
        {
          "id": "FREQ",
          "name": "Frequency",
          "role": "time",
          "values": [
            {
              "id": "M",
              "name": "Monthly",
              "start": "2024-01-01T00:00:00.000+01:00",
              "end": "2024-01-31T23:59:59.999+01:00"
            }
          ]
        }
      ]
    }
  }
}