{"id":"c497f773-fd03-45df-ba94-1e0852985c29","type":"DATASET","name":"European Central Bank — Euro Area Balance of Payments and International Investment Position Statistics (BOP)","slug":"ecb-euro-area-balance-of-payments-and-international-investment-position-statistics-bop","description":"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.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://data.ecb.europa.eu/data/datasets/BOP","docs_url":"https://data.ecb.europa.eu/help/api/overview","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["economy","prices"],"logo_url":"https://data.ecb.europa.eu/themes/custom/edp/favicon.ico","primary_source_url":"https://data-api.ecb.europa.eu/service/data/BOP/all?lastNObservations=1&format=jsondata","extraction_confidence":"0.95","created_at":"2026-07-18T21:24:09.136Z","updated_at":"2026-09-01T23:42:00.778Z","last_verified_at":"2026-09-01T23:42:00.778Z","deprecated_at":null,"ranking_score":61,"last_ranked_at":"2026-08-22T09:42:58.860Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':43B,129B 'a':152B 'and':95A,106B,141B,155B,161B 'area':5A,16B,91A,102B 'as':123B 'balanc':6A,17B 'balance':92A,103B 'bank':3A,33B,89A,119B 'bop':14A,25B,39B,100A,111B,125B 'brows':74B 'browse':160B 'central':2A,32B,88A,118B 'chart':76B,162B 'csv':52B,138B 'csvdata':54B,140B 'data':34B,83B,120B,169B 'dataflow':40B,126B 'ecb':82B,168B 'economi':85C 'endperiod':71B,157B 'endpoint':46B,132B 'euro':4A,15B,90A,101B 'european':1A,31B,87A,117B 'exact':60B 'exactly':146B 'extract':59B,145B 'filter':73B 'filters':159B 'format':53B,57B,139B,143B 'from':115B 'intern':10A,21B 'international':96A,107B 'invest':11A,22B 'investment':97A,108B 'json':56B,142B 'jsondata':58B,144B 'key':67B,153B 'lastnobserv':72B 'lastnobservations':158B 'ml':51B,137B 'need':64B,150B 'of':93A,104B 'offici':26B 'official':112B 'on':166B 'one':45B,131B 'over':127B 'path':68B,154B 'payment':8A,19B 'payments':94A,105B 'portal':35B,84B,121B,170B 'posit':12A,23B 'position':98A,109B 'price':86C 'publish':36B 'published':122B 'rest':44B,130B 'same':164B 'sdmx':42B,50B,128B,136B 'sdmx-ml':49B,135B 'seri':28B,62B,79B 'series':114B,148B,165B 'serv':47B 'serves':133B 'startperiod':70B,156B 'statist':13A,24B 'statistics':99A,110B 'the':116B,124B,147B,163B,167B 'time':27B,113B 'with':151B 'xml':48B,134B 'you':149B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":"eab3ebe3-a519-43d8-a676-4192af61f357","institution_type":"REGULATOR","country_code":"EU","official_confidence":95,"proof_summary":"Official ECB Data Portal dataflow BOP, promoted from the endpoint-verified portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:24:09.136Z","geographic_scope":"EUROPEAN","name_en":null,"description_en":null,"native_lang":null,"access_level":"direct","formats":[],"capability_tier":"live","trust_score":76.25,"merged_into_entry_id":null,"identity_key":"DATASET|https://data-api.ecb.europa.eu/service/data/BOP/all?format=jsondata&lastNObservations=1|european central bank — euro area balance of payments and international investment position statistics (bop)","upstream_ref":null,"access":{"level":"direct","primary":{"kind":"query","label":"List dataflows","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","source":"query_example","runnable":true,"direct":true},"actions":[{"kind":"query","label":"List dataflows","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Run verified request","method":"GET","url":"https://data.ecb.europa.eu/data/datasets/BOP","source":"probe","runnable":true},{"kind":"query","label":"Dataflow structure","method":"GET","url":"https://data-api.ecb.europa.eu/service/dataflow/ECB/BOP?references=all","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Fetch observations (JSON)","method":"GET","url":"https://data-api.ecb.europa.eu/service/data/BOP/all?lastNObservations=5&format=jsondata","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://data.ecb.europa.eu/help/api/overview","source":"docs","runnable":false},{"kind":"landing","label":"Open source record","method":"GET","url":"https://data-api.ecb.europa.eu/service/data/BOP/all?lastNObservations=1&format=jsondata","source":"primary_source","runnable":false}],"formats":[]},"maturity":{"entry_id":"c497f773-fd03-45df-ba94-1e0852985c29","granularity":"entry","granularity_label":"One unit = one catalog entry. A PROXY for the SCOPE.md §4 ladder, which governs source families, not entries: a family with 400 entries moves this reading 400 times as much as a family with one. Never compare or combine with the source_family reading.","level":"executable","level_index":4,"level_label":"Executable","meaning":"Queries run through Commodity","counts_as_coverage":true,"blocked_by":null,"rungs":[{"level":"discovered","level_index":1,"label":"Discovered","meaning":"Source and metadata recorded","evidence":"membership of the named population the ladder is taken over","counts_as_coverage":false,"met":true,"reached":true,"criterion":"TRUE"},{"level":"verified","level_index":2,"label":"Verified","meaning":"Access tested successfully","evidence":"entries.verification_state = 'VERIFIED'","counts_as_coverage":false,"met":true,"reached":true,"criterion":"entries.verification_state = 'VERIFIED'"},{"level":"profiled","level_index":3,"label":"Profiled","meaning":"Schema, dimensions and licence understood","evidence":"a data profile with at least one field (entry_data_profiles.field_count > 0)","counts_as_coverage":false,"met":true,"reached":true,"criterion":"EXISTS (SELECT 1 FROM entry_data_profiles p WHERE p.entry_id = entries.id AND COALESCE(p.field_count, 0) > 0)"},{"level":"executable","level_index":4,"label":"Executable","meaning":"Queries run through Commodity","evidence":"entries.capability_tier = 'live' — today's proxy for \"queryable through us\"","counts_as_coverage":true,"met":true,"reached":true,"criterion":"entries.capability_tier = 'live'"},{"level":"joinable","level_index":5,"label":"Joinable","meaning":"Canonical identifiers and concepts mapped","evidence":"a field link to a canonical identifier whose sampled VALUES match its format","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_field_links efl WHERE efl.entry_id = entries.id AND efl.identifier_id IS NOT NULL AND efl.value_status = 'match')"},{"level":"reproducible","level_index":6,"label":"Reproducible","meaning":"Snapshots and transformation evidence retained","evidence":"at least one retained evidence manifest (migration 078)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM evidence_manifests em WHERE em.entry_id = entries.id)"},{"level":"guaranteed","level_index":7,"label":"Guaranteed","meaning":"Monitored against an operational reliability target","evidence":"an active reliability target with a named monitor (migration 096)","counts_as_coverage":true,"met":false,"reached":false,"criterion":"EXISTS (SELECT 1 FROM entry_reliability_targets rt WHERE rt.entry_id = entries.id AND rt.is_active = true)"}],"officialness":{"basis":"per_item_proven","label":"Proven for this item: its own proof signals scored >= 80 AND it matched a registered public institution, so it would have been APPROVED on its own evidence.","proof_confidence":95,"proven_threshold":80,"institution_id":"eab3ebe3-a519-43d8-a676-4192af61f357","definition":"CASE WHEN COALESCE(entries.is_public_sector, false) IS NOT TRUE THEN 'not_official' WHEN COALESCE(entries.official_confidence, 0) >= 80 AND entries.institution_id IS NOT NULL THEN 'per_item_proven' ELSE 'catalog_inherited' END"},"source_family":{"key":"data-api.ecb.europa.eu","label":"One unit = one source family, approximated by the serving host of the entry's primary source URL (e.g. bdl.stat.gov.pl). A COMPUTED stand-in for the curated families of SCOPE.md §5, which no table holds yet. A family sits at the highest level any of its entries has reached, because a family is integrated to the depth of its deepest working integration. Never compare or combine with the entry reading."},"generated_at":"2026-09-02T05:07:04.507Z"},"api_details":null,"dataset_details":null,"license":null,"reuse":{"license_id":null,"license_name":null,"license_url":null,"commercial_use":{"status":"unknown","value":null},"redistribution":{"status":"unknown","value":null},"attribution_required":{"status":"unknown","value":null},"share_alike":{"status":"unknown","value":null},"personal_data_warning":{"status":"unknown","value":null},"cache_and_mirror":{"status":"unknown","value":null},"undetermined":["commercial_use","redistribution","attribution_required","share_alike","personal_data_warning","cache_and_mirror"],"basis":"unverified","confidence":0.1,"confidence_tier":"low","source_text":null,"source_url":null,"reviewed_at":null},"license_raw":null,"latest_check":{"id":"332cd420-fb2c-4d1c-b1ad-f575b4ee8b28","entry_id":"c497f773-fd03-45df-ba94-1e0852985c29","status":"VERIFIED","last_checked_at":"2026-09-01T23:42:00.587Z","p50_latency_ms":4753,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-18T21:41:04.350Z","updated_at":"2026-09-01T23:42:00.587Z","consecutive_successes":29,"probe_url":"https://data.ecb.europa.eu/data/datasets/BOP","probe_method":"GET","probe_http_status":200,"probe_content_type":"text/html; charset=UTF-8","probe_succeeded_at":"2026-09-01T23:42:00.587Z"},"data_profile":{"id":"44b79786-690d-4ae0-bcbf-80e67a9d057c","entry_id":"c497f773-fd03-45df-ba94-1e0852985c29","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"BOP","fields":[{"name":"FREQ","role":"parameter","type":"dimension","label":"Frequency","param_in":"path","required":true,"filterable":true,"description":"4 codes (e.g. Annual, Half-yearly, Monthly)","enum_values":["A","H","M","Q"]},{"name":"REF_AREA","role":"parameter","type":"dimension","label":"Reference area","param_in":"path","required":true,"filterable":true,"description":"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)","enum_values":["4F","I2","I3","I4","I5","I6","I7","U2"]},{"name":"ADJUSTMENT","role":"parameter","type":"dimension","label":"Adjustment indicator","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. Neither seasonally nor working day adjusted, Working day and seasonally adjusted)","enum_values":["N","Y"]},{"name":"DATA_TYPE_BOP","role":"parameter","type":"dimension","label":"Data type - BoP related data","param_in":"path","required":true,"filterable":true,"description":"9 codes (e.g. Outstanding amounts at the end of the period (stocks), Price valuation adjustment, Exchange rate valuation adjustment)","enum_values":["8","5","6","7","9","T","4","2","3"]},{"name":"BOP_ITEM","role":"parameter","type":"dimension","label":"Balance of Payment item","param_in":"path","required":true,"filterable":true,"description":"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)","enum_values":["802","803","806","806S","806T","806U","808","808A","808B","810","811","812","813","814A","500","505","506","511","512","530","538","539","555","556","561","562","580","588","589","5AA","5BB","600","602","610","611","612","613","614","615","619","620","621","622","623","624","625","630","631","632","633"]},{"name":"CURR_BRKDWN","role":"parameter","type":"dimension","label":"Currency breakdown","param_in":"path","required":true,"filterable":true,"description":"5 codes (e.g. All currencies, Euro, All currencies except EUR)","enum_values":["N","E","O","U","X"]},{"name":"COUNT_AREA","role":"parameter","type":"dimension","label":"Counterpart area","param_in":"path","required":true,"filterable":true,"description":"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)","enum_values":["J3","J4","J5","U4","A1","J6","J7"]},{"name":"SERIES_DENOM","role":"parameter","type":"dimension","label":"Series denominat/spec calcul","param_in":"path","required":true,"filterable":true,"description":"2 codes (e.g. Euro, Annual growth rate)","enum_values":["E","A"]},{"name":"TIME_PERIOD","role":"parameter","type":"time","label":"Time period or range","param_in":"query","filterable":true,"description":"Time dimension — filter with startPeriod / endPeriod query params."},{"name":"OBS_VALUE","role":"field","type":"number","label":"Observation value","description":"The observed numeric value for each cell."},{"name":"TIME_FORMAT","role":"field","type":"attribute","label":"Time format code","filterable":false,"description":null},{"name":"BOP_BASIS","role":"field","type":"attribute","label":"BoP data collection basis","filterable":false,"description":null},{"name":"BREAKS","role":"field","type":"attribute","label":"Breaks","filterable":false,"description":null},{"name":"COLLECTION","role":"field","type":"attribute","label":"Collection indicator","filterable":false,"description":null},{"name":"PUBL_ECB","role":"field","type":"attribute","label":"Source publication (ECB only)","filterable":false,"description":null},{"name":"PUBL_MU","role":"field","type":"attribute","label":"Source publication (Euro area only)","filterable":false,"description":null},{"name":"PUBL_PUBLIC","role":"field","type":"attribute","label":"Source publication (public)","filterable":false,"description":null},{"name":"AGG_EQUN","role":"field","type":"attribute","label":"Aggregation equations","filterable":false,"description":null},{"name":"COMPILATION","role":"field","type":"attribute","label":"Compilation","filterable":false,"description":null},{"name":"DECIMALS","role":"field","type":"attribute","label":"Decimals","filterable":false,"description":null},{"name":"SOURCE_AGENCY","role":"field","type":"attribute","label":"Source agency","filterable":false,"description":null},{"name":"TITLE","role":"field","type":"attribute","label":"Title","filterable":false,"description":null},{"name":"TITLE_COMPL","role":"field","type":"attribute","label":"Title complement","filterable":false,"description":null},{"name":"UNIT","role":"field","type":"attribute","label":"Unit","filterable":false,"description":null},{"name":"UNIT_MULT","role":"field","type":"attribute","label":"Unit multiplier","filterable":false,"description":null},{"name":"OBS_STATUS","role":"field","type":"attribute","label":"Observation status","filterable":false,"description":null},{"name":"OBS_CONF","role":"field","type":"attribute","label":"Observation confidentiality","filterable":false,"description":null},{"name":"OBS_PRE_BREAK","role":"field","type":"attribute","label":"Pre-break observation value","filterable":false,"description":null},{"name":"OBS_COM","role":"field","type":"attribute","label":"Observation comment","filterable":false,"description":null}],"field_count":29,"sample_records":[{"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"},{"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"},{"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"},{"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"},{"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"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://data-api.ecb.europa.eu/service/dataflow/ECB","curl":"curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"List dataflows","method":"GET","description":"All dataflows (datasets) published by this agency, as SDMX-ML."},{"url":"https://data-api.ecb.europa.eu/service/dataflow/ECB/BOP?references=all","curl":"curl -s 'https://data-api.ecb.europa.eu/service/dataflow/ECB/BOP?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the BOP dataflow: dimensions, code lists, attributes."},{"url":"https://data-api.ecb.europa.eu/service/data/BOP/all?lastNObservations=5&format=jsondata","curl":"curl -s 'https://data-api.ecb.europa.eu/service/data/BOP/all?lastNObservations=5&format=jsondata'","label":"Fetch observations (JSON)","method":"GET","description":"Latest observations as SDMX-JSON (the response embeds the dimension structure). Add a key like /data/BOP/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-07-27T21:07:42.259Z","run_id":"d99b5ce0-f444-4e55-bd10-9a6de57bb72c","created_at":"2026-07-19T21:29:21.815Z","updated_at":"2026-07-27T21:07:42.259Z","license_raw":null,"license_id":null,"consecutive_failure_count":0,"last_error_at":null,"last_error_message":null,"previewable":true,"personal_data":{"status":"none","basis":"no_person_column_cited","grain":"none","allowed":true,"columns":{"direct_identifiers":[],"family_names":[],"given_names":[],"attributes":[],"unresolved_names":[],"measures":["COUNT_AREA","OBS_VALUE"],"entity_identifiers":[]},"publication":null,"publication_evidence":null,"notice":"personal data: no cited column names a natural person (the cited columns are all this reads)"}},"datasets":[],"limits":[],"manifest":{"answer_sha256":"d9a88180d741df2639b4fa2b906d7ece39b50f35667271548946beda93717933","answer_sha256_rule":"sha256 (hex, UTF-8) of JSON.stringify(this body) after deleting the keys listed in manifest.stamped_keys from manifest, and deleting manifest itself if it is then empty. The hash was computed before the stamp existed, so no field of the stamp is inside it.","stamped_keys":["answer_sha256","answer_sha256_rule","stamped_keys","row_count","row_count_basis","live","live_basis","created_at","created_at_basis","durable_citation"],"row_count":50,"row_count_basis":"Objects that are elements of a JSON array anywhere in this body, excluding manifest. Not a claim about which collection is the answer. Largest single collection: data_profile.fields[] (29 rows).","live":false,"live_basis":"This body was replayed from the worker edge cache (x-edge-cache: hit); the bytes, and therefore answer_sha256, are those of the execution that filled the cache.","created_at":"2026-09-02T05:07:04.656Z","created_at_basis":"When this response body was assembled, deliberately OUTSIDE the hashed bytes so the same answer hashes identically on every request. Not the upstream read time — that is provenance[].retrieved_at. A zone-cached replay carries the assembly time, not your receipt time.","durable_citation":"This manifest is produced at response time and is NOT stored. A durable, replayable citation is persisted only on an explicit cite: GET /api/v1/entries/{id-or-slug}/evidence, or the MCP cite_query tool. Both are entry-scoped, because evidence_manifests is entry-shaped; a domain answer spanning several sources has no single entry and cannot be persisted through that path."}}