European Central Bank — European Union Balance of Payments (Source Eurostat) (ESB)

DatasetExecutable4/7Query nowOpen workbench Subscribe🇪🇺European

European Union Balance of Payments (Source Eurostat) (ESB) — official time series from the European Central Bank Data Portal, published as the ESB dataflow over SDMX 2.1 REST. One endpoint serves XML (SDMX-ML), CSV (?format=csvdata) and JSON (?format=jsondata); extract exactly the series you need with a key path and startPeriod / endPeriod / lastNObservations filters. Browse and chart the same series on the ECB Data Portal.

economyprices

Run verified request Dataflow structure Fetch observations (JSON)Read the docs Open source record

Data schema (27 fields)

Filterable via the API (11)

FREQREF_AREAADJUSTMENTDATA_TYPE_BOPBOP_ITEMCURR_BRKDWNCOUNT_AREASERIES_DENOMRESID_ECON_ACTNON_RESID_ECON_ACTTIME_PERIOD

Click a field to see example values.

Field	Type	Description
FREQFrequency	dimension	1 codes (e.g. Quarterly)
REF_AREAReference area	dimension	2 codes (e.g. EU 27 (fixed composition) as of 1 January 2007, EU 28 (fixed composition) as of 1 July 2013)
ADJUSTMENTAdjustment indicator	dimension	2 codes (e.g. Neither seasonally nor working day adjusted, Working day and seasonally adjusted)
DATA_TYPE_BOPData type - BoP related data	dimension	3 codes (e.g. Credit transactions, Debit transactions, Net transactions)
BOP_ITEMBalance of Payment item	dimension	40 codes (e.g. Current account, Goods, Current account, Services, Transportation)
CURR_BRKDWNCurrency breakdown	dimension	1 codes (e.g. All currencies)
COUNT_AREACounterpart area	dimension	11 codes (e.g. Brazil, Canada, Switzerland)
SERIES_DENOMSeries denominat/spec calcul	dimension	1 codes (e.g. Euro)
RESID_ECON_ACTResident economic activity	dimension	1 codes (e.g. TOTAL)
NON_RESID_ECON_ACTNon-resident economic activity	dimension	1 codes (e.g. TOTAL)
TIME_PERIODTime period or range	time	Time dimension — filter with startPeriod / endPeriod query params.
OBS_VALUEObservation value	number	The observed numeric value for each cell.
TIME_FORMATTime format code	attribute	—
BOP_BASISBoP data collection basis	attribute	—
BREAKS	attribute	—
COLLECTIONCollection indicator	attribute	—
AGG_EQUNAggregation equations	attribute	—
COMPILATION	attribute	—
DECIMALS	attribute	—
TITLE	attribute	—
TITLE_COMPLTitle complement	attribute	—
UNIT	attribute	—
UNIT_MULTUnit multiplier	attribute	—
OBS_STATUSObservation status	attribute	—
OBS_CONFObservation confidentiality	attribute	—
OBS_PRE_BREAKPre-break observation value	attribute	—
OBS_COMObservation comment	attribute	—

Schema captured from sdmx 1 month ago.

Query the data

Pick columns and a sort, then fetch a live preview straight from the source. Choose an API-filterable column (marked ▾) under “Where” to pick from its list of values.

Where=

Sort by

Sample data (5 records)

Record 1FREQ: Q · BOP_ITEM: 100

{
  "FREQ": "Q",
  "BOP_ITEM": "100",
  "REF_AREA": "V1",
  "OBS_VALUE": 8938.364,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "BR",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2014-Q1",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "2",
  "RESID_ECON_ACT": "9999",
  "NON_RESID_ECON_ACT": "9999"
}

Record 2FREQ: Q · BOP_ITEM: 100

{
  "FREQ": "Q",
  "BOP_ITEM": "100",
  "REF_AREA": "V1",
  "OBS_VALUE": 7360.312,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "CA",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2014-Q1",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "2",
  "RESID_ECON_ACT": "9999",
  "NON_RESID_ECON_ACT": "9999"
}

Record 3FREQ: Q · BOP_ITEM: 100

{
  "FREQ": "Q",
  "BOP_ITEM": "100",
  "REF_AREA": "V1",
  "OBS_VALUE": 34876.366,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "CH",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2014-Q1",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "2",
  "RESID_ECON_ACT": "9999",
  "NON_RESID_ECON_ACT": "9999"
}

Record 4FREQ: Q · BOP_ITEM: 100

{
  "FREQ": "Q",
  "BOP_ITEM": "100",
  "REF_AREA": "V1",
  "OBS_VALUE": 38207.611,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "CN",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2014-Q1",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "2",
  "RESID_ECON_ACT": "9999",
  "NON_RESID_ECON_ACT": "9999"
}

Record 5FREQ: Q · BOP_ITEM: 100

{
  "FREQ": "Q",
  "BOP_ITEM": "100",
  "REF_AREA": "V1",
  "OBS_VALUE": 7978.379,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "HK",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2014-Q1",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "2",
  "RESID_ECON_ACT": "9999",
  "NON_RESID_ECON_ACT": "9999"
}

Live sample captured at profiling time — values may have changed upstream.

Verification Status

Using the API

Query examples

curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'

All dataflows (datasets) published by this agency, as SDMX-ML.

Full API documentation ↗

Machine-readable & source

JSON

Embed this badge in a README or wiki — it always shows the latest verification state and quality tier.