{"id":"747cf15e-42f9-4903-82f5-c8214f83a34d","type":"DATASET","name":"Deutsche Bundesbank — Bargeld Zeitreihen für Grafiker (BBTHB)","slug":"bundesbank-bargeld-zeitreihen-fur-grafiker-bbthb","description":"Bargeld Zeitreihen für Grafiker (BBTHB) — official time series from the Deutsche Bundesbank, published as the BBTHB dataflow over SDMX 2.1 REST. One endpoint serves XML (SDMX-ML), CSV (?format=csv) and JSON (?format=json); extract exactly the series you need with a key path and startPeriod / endPeriod / lastNObservations filters.","free_access_class":"FREE_NO_AUTH","auth_type":"NONE","homepage_url":"https://www.bundesbank.de/en/statistics/time-series-databases","docs_url":"https://api.statistiken.bundesbank.de/doc/stat-ws-api-external.yaml","repo_url":null,"status":"ACTIVE","verification_state":"VERIFIED","tags":["economy","prices"],"logo_url":null,"primary_source_url":"https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=1&format=json","extraction_confidence":"0.95","created_at":"2026-07-18T21:42:29.792Z","updated_at":"2026-10-17T12:30:13.717Z","last_verified_at":"2026-10-17T12:30:13.717Z","deprecated_at":null,"ranking_score":59,"last_ranked_at":"2026-10-07T00:41:38.942Z","last_seen_at":null,"last_validated_at":null,"last_uptime_at":null,"search_vector":"'2.1':36B,94B,200B,258B 'a':223B,261B,290B 'access':90B 'accessible':254B 'allow':137B 'allowing':301B 'along':129B,293B 'analys':152B 'analyses':316B 'and':212B,226B,279B,298B,306B 'api':96B,260B 'as':194B 'at':321B 'bank':85B,249B 'bargeld':3A,17B,167A,181B 'bbthb':7A,16A,21B,32B,88B,171A,180A,185B,196B,252B 'bundesbank':2A,9A,28B,81B,166A,173A,192B,245B 'by':242B,288B 'can':284B 'cash':10A,72B,141B,174A,236B,305B 'cash-rel':71B 'cash-related':235B 'central':84B,248B 'chart':14A,151B,178A 'charts':315B 'csv':45B,47B,109B,113B,209B,211B,273B,277B 'currenc':144B 'currency':308B 'currency-rel':143B 'currency-related':307B 'data':101B,265B 'dataflow':33B,89B,197B,253B 'dataset':68B,232B 'deutsch':1A,8A,27B,80B 'deutsche':165A,172A,191B,244B 'econom':146B 'economi':163C 'economic':310B 'endperiod':64B,133B,228B,297B 'endpoint':39B,99B,203B,263B 'exact':53B 'exactly':217B 'extract':52B,121B,216B,285B 'filter':66B,136B 'filters':230B,300B 'for':177A,312B,325B 'format':46B,50B,104B,112B,117B,210B,214B,276B,281B 'formats':268B 'from':189B 'fur':169A,183B 'further':318B 'für':5A,19B 'germani':82B,162B 'germany':246B,326B 'grafik':6A,20B 'grafiker':170A,184B 'in':266B,314B 'indic':147B 'indicators':311B 'json':49B,51B,116B,118B,213B,215B,280B,282B 'key':60B,127B,224B,291B 'lastnobserv':65B,135B 'lastnobservations':229B,299B 'level':160B,324B 'maker':15A 'makers':179A 'ml':44B,108B,208B,272B 'multipl':103B 'multiple':267B 'nation':159B 'national':323B 'need':57B,221B 'of':304B 'offici':22B,70B 'official':186B,234B 'one':38B,202B 'option':131B 'optional':295B 'or':317B 'over':198B 'paramet':114B 'parameter':278B 'path':61B,128B,225B,292B 'precis':138B 'precise':302B 'price':164C 'process':156B 'processing':320B 'provid':69B 'provides':233B 'publish':29B,77B 'published':193B,241B 'relat':73B,145B 'related':237B,309B 'rest':37B,95B,201B,259B 'retriev':139B 'retrieval':303B 's':247B 'sdmx':35B,43B,93B,107B,199B,207B,257B,271B 'sdmx-ml':42B,106B,206B,270B 'seri':12A,24B,55B,76B,123B 'series':176A,188B,219B,240B,287B 'serv':40B,100B 'serves':204B,264B 'singl':98B 'single':262B 'specif':122B 'specifi':125B 'specific':286B 'specifying':289B 'startperiod':63B,132B,227B,296B 'statist':74B,155B 'statistical':238B,319B 'the':190B,195B,218B,243B,251B,256B,275B,322B 'this':231B 'time':11A,23B,75B,175A,187B,239B 'under':250B 'use':110B,149B,313B 'user':119B 'users':283B 'using':274B 'via':91B,255B 'with':222B,294B 'xml':41B,105B,205B,269B 'you':220B 'zeitreihen':4A,18B,168A,182B","popularity_score":"0.0000","maintenance_score":"0.7000","institution_id":null,"institution_type":"REGULATOR","country_code":"DE","official_confidence":null,"proof_summary":"Official Deutsche Bundesbank dataflow BBTHB, promoted from the portal entry","source_seed_url":null,"is_public_sector":true,"published_at":"2026-07-18T21:42:29.792Z","geographic_scope":"NATIONAL","name_en":"Deutsche Bundesbank — Cash Time Series for Chart Makers (BBTHB)","description_en":"This dataset provides official cash-related statistical time series published by the Deutsche Bundesbank (Germany's central bank) under the BBTHB dataflow, accessible via the SDMX 2.1 REST API. A single endpoint serves data in multiple formats: XML (SDMX-ML), CSV (using the format=csv parameter), and JSON (format=json). Users can extract specific series by specifying a key path along with optional startPeriod, endPeriod, and lastNObservations filters, allowing precise retrieval of cash and currency-related economic indicators for use in charts, analyses, or further statistical processing at the national level for Germany.”","native_lang":"de","access_level":"direct","formats":[],"capability_tier":"live","trust_score":49.16666666666667,"merged_into_entry_id":null,"identity_key":"DATASET|https://api.statistiken.bundesbank.de/rest/data/BBTHB?format=json&lastNObservations=1|deutsche bundesbank — bargeld zeitreihen für grafiker (bbthb)","upstream_ref":null,"content_changed_at":null,"title_qualifier":null,"access":{"level":"direct","primary":{"kind":"query","label":"List dataflows","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","source":"query_example","runnable":true,"direct":true},"actions":[{"kind":"query","label":"List dataflows","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","source":"query_example","runnable":true,"direct":true},{"kind":"query","label":"Run verified request","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=1&format=json","source":"probe","runnable":true},{"kind":"query","label":"Dataflow structure","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBTHB?references=all","source":"query_example","runnable":true,"direct":false},{"kind":"query","label":"Fetch observations (JSON)","method":"GET","url":"https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=5&format=json","source":"query_example","runnable":true,"direct":false},{"kind":"landing","label":"Read the docs","method":"GET","url":"https://api.statistiken.bundesbank.de/doc/stat-ws-api-external.yaml","source":"docs","runnable":false},{"kind":"landing","label":"Visit homepage","method":"GET","url":"https://www.bundesbank.de/en/statistics/time-series-databases","source":"homepage","runnable":false}],"formats":[]},"maturity":{"entry_id":"747cf15e-42f9-4903-82f5-c8214f83a34d","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":"catalog_inherited","label":"Inherited from the upstream catalog: this item came from a trusted official government catalog, and that provenance — not per-item proof — is the warrant. Its own proof score is below 80 or it matched no registered institution (apps/worker/src/connectors/catalog/qualify-store.ts).","proof_confidence":null,"proven_threshold":80,"institution_id":null,"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":"api.statistiken.bundesbank.de","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-10-17T14:21:30.883Z"},"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":"344092ab-bcd8-48de-8e06-c2f854c28e59","entry_id":"747cf15e-42f9-4903-82f5-c8214f83a34d","status":"VERIFIED","last_checked_at":"2026-10-17T12:30:13.589Z","p50_latency_ms":2118,"p95_latency_ms":null,"last_error":null,"consecutive_failures":0,"created_at":"2026-07-19T02:27:46.334Z","updated_at":"2026-10-17T12:30:13.589Z","consecutive_successes":103,"probe_url":"https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=1&format=json","probe_method":"GET","probe_http_status":200,"probe_content_type":"application/json;charset=UTF-8","probe_succeeded_at":"2026-10-17T12:30:13.589Z"},"data_profile":{"id":"9a9565c8-b5ac-4050-982f-325139a58072","entry_id":"747cf15e-42f9-4903-82f5-c8214f83a34d","profile_source":"sdmx","profile_kind":"dataset","dataset_id":"BBTHB","fields":[{"name":"BBK_STD_FREQ","role":"parameter","type":"dimension","label":"BBK_STD_FREQ","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. M)","enum_values":["M"],"description_en":"Frequency of the time series, e.g. monthly (M)."},{"name":"BBK_TH3_OWNER","role":"parameter","type":"dimension","label":"BBK_TH3_OWNER","param_in":"path","required":true,"filterable":true,"description":"1 codes (e.g. BAR)","enum_values":["BAR"],"description_en":"Code identifying the data owner, e.g. cash (BAR)."},{"name":"BBK_TH3_CONCEPT","role":"parameter","type":"dimension","label":"BBK_TH3_CONCEPT","param_in":"path","required":true,"filterable":true,"description":"15 codes (e.g. PUBLIC_DE_BN_UMLF_100_WERT, PUBLIC_DE_BN_UMLF_10_WERT, PUBLIC_DE_BN_UMLF_200_WERT)","enum_values":["PUBLIC_DE_BN_UMLF_100_WERT","PUBLIC_DE_BN_UMLF_10_WERT","PUBLIC_DE_BN_UMLF_200_WERT","PUBLIC_DE_BN_UMLF_20_WERT","PUBLIC_DE_BN_UMLF_500_WERT","PUBLIC_DE_BN_UMLF_50_WERT","PUBLIC_DE_BN_UMLF_5_WERT","PUBLIC_DE_M_UMLF_001_WERT","PUBLIC_DE_M_UMLF_002_WERT","PUBLIC_DE_M_UMLF_005_WERT","PUBLIC_DE_M_UMLF_010_WERT","PUBLIC_DE_M_UMLF_020_WERT","PUBLIC_DE_M_UMLF_050_WERT","PUBLIC_DE_M_UMLF_100_WERT","PUBLIC_DE_M_UMLF_200_WERT"],"description_en":"Code identifying the specific banknote/cash concept series."},{"name":"TIME_PERIOD","role":"parameter","type":"time","label":"TIME_PERIOD","param_in":"query","filterable":true,"description":"Time dimension — filter with startPeriod / endPeriod query params.","description_en":"Period of the observation, filterable via startPeriod/endPeriod."},{"name":"OBS_VALUE","role":"field","type":"number","label":"Observation value","description":"The observed numeric value for each cell.","description_en":"Numeric value observed for this series and time period."},{"name":"TIME_FORMAT","role":"field","type":"attribute","label":"TIME_FORMAT","filterable":false,"description":null,"description_en":"Format code describing how the time period is represented."},{"name":"BBK_DECIMALS","role":"field","type":"attribute","label":"BBK_DECIMALS","filterable":false,"description":null,"description_en":"Number of decimal places used in the observation value."},{"name":"BBK_ID","role":"field","type":"attribute","label":"BBK_ID","filterable":false,"description":null,"description_en":"Unique Bundesbank identifier for this time series."},{"name":"BBK_UNIT","role":"field","type":"attribute","label":"BBK_UNIT","filterable":false,"description":null,"description_en":"Unit of measurement for the observation value."},{"name":"BBK_UNIT_MULT","role":"field","type":"attribute","label":"BBK_UNIT_MULT","filterable":false,"description":null,"description_en":"Multiplier applied to the unit of the observation value."},{"name":"BBK_TITLE_ENG","role":"field","type":"attribute","label":"BBK_TITLE_ENG","filterable":false,"description":null,"description_en":"English-language title of the time series."},{"name":"BBK_COMM_GEN_ENG","role":"field","type":"attribute","label":"BBK_COMM_GEN_ENG","filterable":false,"description":null,"description_en":"General English-language comment or explanatory note for the series."},{"name":"WEB_CATEGORY","role":"field","type":"attribute","label":"WEB_CATEGORY","filterable":false,"description":null,"description_en":"Web category under which the series is classified."},{"name":"BBK_DIFF","role":"field","type":"attribute","label":"BBK_DIFF","filterable":false,"description":null,"description_en":"Difference compared to the previous period's value."},{"name":"BBK_DIFF_Y","role":"field","type":"attribute","label":"BBK_DIFF_Y","filterable":false,"description":null,"description_en":"Difference compared to the same period one year earlier."}],"field_count":15,"sample_records":[{"BBK_DIFF":null,"OBS_VALUE":"10.95","BBK_DIFF_Y":null,"TIME_PERIOD":"2002-01","BBK_STD_FREQ":"M","BBK_TH3_OWNER":"BAR","BBK_TH3_CONCEPT":"PUBLIC_DE_BN_UMLF_100_WERT"},{"BBK_DIFF":"7.9","OBS_VALUE":"11.82","BBK_DIFF_Y":null,"TIME_PERIOD":"2002-02","BBK_STD_FREQ":"M","BBK_TH3_OWNER":"BAR","BBK_TH3_CONCEPT":"PUBLIC_DE_BN_UMLF_100_WERT"},{"BBK_DIFF":"8.1","OBS_VALUE":"12.78","BBK_DIFF_Y":null,"TIME_PERIOD":"2002-03","BBK_STD_FREQ":"M","BBK_TH3_OWNER":"BAR","BBK_TH3_CONCEPT":"PUBLIC_DE_BN_UMLF_100_WERT"},{"BBK_DIFF":"4.9","OBS_VALUE":"13.40","BBK_DIFF_Y":null,"TIME_PERIOD":"2002-04","BBK_STD_FREQ":"M","BBK_TH3_OWNER":"BAR","BBK_TH3_CONCEPT":"PUBLIC_DE_BN_UMLF_100_WERT"},{"BBK_DIFF":"5.2","OBS_VALUE":"14.10","BBK_DIFF_Y":null,"TIME_PERIOD":"2002-05","BBK_STD_FREQ":"M","BBK_TH3_OWNER":"BAR","BBK_TH3_CONCEPT":"PUBLIC_DE_BN_UMLF_100_WERT"}],"record_count":null,"data_size_bytes":null,"dataset_count":null,"query_examples":[{"url":"https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK' -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://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBTHB?references=all","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/metadata/dataflow/BBK/BBTHB?references=all' -H 'Accept: application/vnd.sdmx.structure+xml;version=2.1'","label":"Dataflow structure","method":"GET","description":"Full structure of the BBTHB dataflow: dimensions, code lists, attributes."},{"url":"https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=5&format=json","curl":"curl -s 'https://api.statistiken.bundesbank.de/rest/data/BBTHB?lastNObservations=5&format=json'","label":"Fetch observations (JSON)","method":"GET","description":"Latest observations as SDMX-JSON (the response embeds the dimension structure). Add a key like /data/BBTHB/D.USD.EUR.SP00.A to select a series."}],"status":"ok","error_message":null,"profiled_at":"2026-10-15T16:39:06.154Z","run_id":"1e098ba0-4094-4f90-9772-b3e778f2153e","created_at":"2026-07-19T21:29:19.305Z","updated_at":"2026-10-15T16:39:06.154Z","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":["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":"142b3bf3ccc9027e0fa01abb4d7b3c3571a41d54e6611cb14f6032f19d99ee64","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":36,"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[] (15 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-10-17T14:22:09.216Z","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."}}