parsimony-bde
Banco de España connector — Spanish macroeconomic, monetary, and financial time series via the BIEST REST API.
Part of the parsimony-connectors monorepo. Distributed standalone on PyPI as parsimony-bde.
Connectors
| Name | Kind | Description |
|---|---|---|
bde_fetch |
connector | Fetch one or more BdE time series by series code (comma-separated). |
enumerate_bde |
enumerator | Discover BdE series from six catalog CSV chapters plus the Bank Lending Survey (recovered from pb.zip). |
bde_search |
connector | Semantic-search the published BdE catalog snapshot; returns ranked series codes. |
bde_fetch's time_range is frequency-dependent (BdE validates it): monthly /
quarterly series take 30M/60M/MAX, daily series take 3M/12M/36M (not
MAX), and any frequency accepts a 4-digit year (e.g. 2024). A range that
doesn't fit a series' frequency is reported as an InvalidParameterError.
Install
pip install parsimony-bde
Pulls in a compatible parsimony automatically. Verify discovery:
python -c "from parsimony import discover; print([p.name for p in discover.iter_providers()])"
Configuration
No API key required — the BdE BIEST API is open and unauthenticated.
bde_search reads a published catalog snapshot (default hf://parsimony-dev/bde).
Override the snapshot location with the PARSIMONY_BDE_CATALOG_URL environment
variable, or pass catalog_url= at call time.
Quick start
from parsimony_bde import CONNECTORS
result = CONNECTORS["bde_fetch"](key="D_1NBAF472")
print(result.raw.head())
For multi-plugin composition (autoloads everything installed):
from parsimony import discover
connectors = discover.load_all()
Catalogs
enumerate_bde discovers the full BdE series catalog — ~15.5k unique series
across six published CSV chapters (be, cf, ie, si, tc, ti), plus the
Bank Lending Survey. The survey's CSV chapter lists only un-fetchable family
aliases (PB_1_1.1), so its real fetchable codes (DPB…) are recovered from the
bulk pb.zip. Rows are de-duplicated by series code (a series can appear under
more than one thematic chapter). Maintainers build a Catalog snapshot from the
enumerator (see scripts/build_catalog.py) and push it to the snapshot URL that
bde_search reads. The crawl is expensive (the CF/Financial-Accounts chapter
alone is several thousand series), so it runs offline as a publish job — never at
query time.
A small tail (~1% of catalog codes, mostly dollar-denominated …$… financial
accounts variants and a handful of external-sector series) is listed in the CSV
catalog but not served by the web service; fetching such a code returns a clear
InvalidParameterError rather than data.
Provider
- Homepage: https://www.bde.es
- API docs: https://www.bde.es/webbe/en/estadisticas/recursos/api-estadisticas-bde.html
- Series browser: https://app.bde.es/bie_www/bie_wwwias/xml/Arranque.html (BIEST)
License
See LICENSE.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file parsimony_bde-0.0.2.tar.gz.
File metadata
- Download URL: parsimony_bde-0.0.2.tar.gz
- Upload date:
- Size: 17.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d2ba6a9a1c82c50b0e42e3466a2ce35517baf28e3eb0abf70e3a7f47ce7d0c5c
|
|
| MD5 |
dcc3aead6e2087db62778b9bb3e57fa9
|
|
| BLAKE2b-256 |
eae12f52470c5f1ec46b8ff00793d1dca1367da7fe9f4515282864d27e743d77
|
Provenance
The following attestation bundles were made for parsimony_bde-0.0.2.tar.gz:
Publisher:
release.yml on ockham-sh/parsimony-connectors
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
parsimony_bde-0.0.2.tar.gz -
Subject digest:
d2ba6a9a1c82c50b0e42e3466a2ce35517baf28e3eb0abf70e3a7f47ce7d0c5c - Sigstore transparency entry: 2408420540
- Sigstore integration time:
-
Permalink:
ockham-sh/parsimony-connectors@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ockham-sh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file parsimony_bde-0.0.2-py3-none-any.whl.
File metadata
- Download URL: parsimony_bde-0.0.2-py3-none-any.whl
- Upload date:
- Size: 19.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e80841478e80c15109ff5cdec022e610ae600b75f5afa61f6f8c2c2b3c49e109
|
|
| MD5 |
5366a85ef751d98e35d20f7da88b4396
|
|
| BLAKE2b-256 |
6563be3d85297ca2fb5f6be8d82a82e62417d3821b33bae982d6296e73003a95
|
Provenance
The following attestation bundles were made for parsimony_bde-0.0.2-py3-none-any.whl:
Publisher:
release.yml on ockham-sh/parsimony-connectors
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
parsimony_bde-0.0.2-py3-none-any.whl -
Subject digest:
e80841478e80c15109ff5cdec022e610ae600b75f5afa61f6f8c2c2b3c49e109 - Sigstore transparency entry: 2408420894
- Sigstore integration time:
-
Permalink:
ockham-sh/parsimony-connectors@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ockham-sh
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@45adac08dad2b5faf031867e7e3ca1b87689f5b9 -
Trigger Event:
workflow_dispatch
-
Statement type:
