ECB Data Portal

byAPI3FreeAirnode v0.1.0

The European Central Bank's statistical data: euro foreign exchange reference rates, policy and market interest rates, yield curves, monetary aggregates, bank balance sheets, securities issuance and the rest of what the ECB and the national central banks publish. This Airnode wraps its data API, so a consumer receives what the ECB published with a signature saying this Airnode read it then.

A series is addressed by a dataflow and a key, and the key is positional: EXR and D.USD.EUR.SP00.A is the daily US dollar reference rate against the euro. A position left empty is a wildcard, so D..EUR.SP00.A is that rate against every currency, which is how a caller finds out what exists rather than guessing. The ECB Data Portal is where a dataflow's dimensions are documented, since the API describes them only in XML and this Airnode serves JSON.

The reference rates are the part worth knowing the timing of. They are a daily snapshot taken at 14:15 Central European Time and published shortly after, not a live market quote, so the same key read twice in one afternoon is the same number and the rate for a weekend does not exist.

Reuse terms. The ECB permits free reuse of the statistics it publishes, commercial reuse included, on condition that the source is acknowledged as "Source: ECB statistics." and that the statistics and their metadata are not modified. What this Airnode signs is what the API returned, unaltered. The permission does not extend to third party data carried in these dataflows, which needs the originating party's own permission, so a consumer redistributing a series has that to check first.

Every response carries an EIP-191 signature from the Airnode that served it, so the data can be attributed back to its source rather than trusted on reputation.

Interface

Served at https://airnode-ecb.fly.dev/. The two requests below are everything the endpoint speaks, and each can be sent from this page. What comes back is verified right here in the browser.

GET /

Returns the machine-readable documentation this page is rendered from. Free, and everything an agent needs.

POST /

Names an operation and its parameters, performs it against the upstream API, and answers with the response and the attestation over it.

One or more statistical series, with their observations.

flowRefstringThe dataflow, by its code: EXR for exchange rates, FM for financial markets, YC for yield curves, BSI for bank balance sheets or ICP for consumer prices. The ECB Data Portal lists them all.keystringThe series within that dataflow, as its dimensions separated by dots in the order the dataflow defines them. An empty position is a wildcard, so D..EUR.SP00.A is every currency, and the word all is every series in the dataflow. A plus joins alternatives in one position, as in D.USD+GBP.EUR.SP00.A.startPeriodstringoptionalOnly observations at or after this period, in the series' own format: a day, a month, a quarter or a year.endPeriodstringoptionalOnly observations at or before this period, in the same format.lastNObservationsintegeroptionalOnly the most recent observations of each series. The cheapest way to ask what a rate is now, and the cheapest way to bound a call.firstNObservationsintegeroptionalOnly the oldest observations of each series, which is how far back a series goes.updatedAfterstringoptionalOnly observations added or revised since this timestamp. This is how a consumer holding an earlier attestation finds out that the ECB has since revised it.detailstringoptionalHow much to return: full for everything, dataonly to drop the attributes, serieskeysonly for the series keys with no observations at all, nodata for the structure alone. serieskeysonly is what turns a wildcard key into a catalogue of what exists.dimensionAtObservationstringoptionaldefault: TIME_PERIODWhich dimension the observations are keyed by. AllDimensions flattens them into dataSets[0].observations under full coordinates, which is the readable shape. TIME_PERIOD nests them under dataSets[0].series instead.includeHistorybooleanoptionalReturn previous versions of the data alongside the current one, as extra entries in dataSets. This is where a revision can be seen against what it replaced.

Verify the response

Every response is signed by the API that served it. Paste one to check it really came from this listing and was not altered along the way.