European Central Bank — Euro Area Balance of Payments and International Investment Position Statistics (BOP)

DatasetExecutable4/7Query nowOpen workbench Subscribe🇪🇺European

Euro Area Balance of Payments and International Investment Position Statistics (BOP) — official time series from the European Central Bank Data Portal, published as the BOP 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 (29 fields)

Filterable via the API (9)

FREQREF_AREAADJUSTMENTDATA_TYPE_BOPBOP_ITEMCURR_BRKDWNCOUNT_AREASERIES_DENOMTIME_PERIOD

Click a field to see example values.

Field	Type	Description
FREQFrequency	dimension	4 codes (e.g. Annual, Half-yearly, Monthly)
REF_AREAReference area	dimension	8 codes (e.g. European Central Bank (ECB), Euro area 12 (fixed composition) as of 1 January 2001, Euro area 13 (fixed composition) as of 1 January 2007)
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	9 codes (e.g. Outstanding amounts at the end of the period (stocks), Price valuation adjustment, Exchange rate valuation adjustment)
BOP_ITEMBalance of Payment item	dimension	225 codes (e.g. Financial account, Official reserve assets, Financial account, Official reserve assets, foreign exchange (including financial derivatives), Financial account, Reserves assets, foreign exchange, Securities)
CURR_BRKDWNCurrency breakdown	dimension	5 codes (e.g. All currencies, Euro, All currencies except EUR)
COUNT_AREACounterpart area	dimension	7 codes (e.g. Extra-Euro area 13 (fixed composition) as of 1 January 2007, Extra-Euro area 15 (fixed composition) as of 1 January 2008, Extra-Euro area 16 (fixed composition) as of 1 January 2009)
SERIES_DENOMSeries denominat/spec calcul	dimension	2 codes (e.g. Euro, Annual growth rate)
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	—
PUBL_ECBSource publication (ECB only)	attribute	—
PUBL_MUSource publication (Euro area only)	attribute	—
PUBL_PUBLICSource publication (public)	attribute	—
AGG_EQUNAggregation equations	attribute	—
COMPILATION	attribute	—
DECIMALS	attribute	—
SOURCE_AGENCY	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: A · BOP_ITEM: 802

{
  "FREQ": "A",
  "BOP_ITEM": "802",
  "REF_AREA": "4F",
  "OBS_VALUE": 39630.399999999994,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "J3",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2007",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "8"
}

Record 2FREQ: A · BOP_ITEM: 802

{
  "FREQ": "A",
  "BOP_ITEM": "802",
  "REF_AREA": "4F",
  "OBS_VALUE": 47354.29999847412,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "J4",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2008",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "8"
}

Record 3FREQ: A · BOP_ITEM: 802

{
  "FREQ": "A",
  "BOP_ITEM": "802",
  "REF_AREA": "4F",
  "OBS_VALUE": 56823.731,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "J5",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2010",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "8"
}

Record 4FREQ: A · BOP_ITEM: 802

{
  "FREQ": "A",
  "BOP_ITEM": "802",
  "REF_AREA": "4F",
  "OBS_VALUE": 61879.194942981245,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "U4",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2012",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "8"
}

Record 5FREQ: A · BOP_ITEM: 803

{
  "FREQ": "A",
  "BOP_ITEM": "803",
  "REF_AREA": "4F",
  "OBS_VALUE": 28897.799999999996,
  "ADJUSTMENT": "N",
  "COUNT_AREA": "J3",
  "CURR_BRKDWN": "N",
  "TIME_PERIOD": "2007",
  "SERIES_DENOM": "E",
  "DATA_TYPE_BOP": "8"
}

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.