Mags

Added

• Added tidy=True to sgs.get(), sgs.async_get(), currency.get(), and currency.async_get() for long-form DataFrame output. SGS tidy output uses Date, series, and value; currency tidy output uses Date, symbol, side, and value. The default wide DataFrame output and output="text" behavior are unchanged.
• Added per-call timeout support across SGS, currency, and OData APIs, including sync and async paths, so slow calls can override the shared HTTP client timeout without changing global defaults.
• Added explicit OR composition for OData filters with the | operator, including nested combinations with &.
• Added retry handling for transient SGS request failures.

Changed

• Improved OData describe() output: detailed endpoint information is now shown by default, while describe(full=False) keeps the compact endpoint summary.
• PTAX date parameters now accept ISO date strings, datetime.date, datetime.datetime, and pandas.Timestamp; generalized inputs are converted to the PTAX service format M/D/YYYY.
• Strengthened public API validation, OData literal serialization, HTTP error mapping, currency response parsing, and async currency missing-symbol behavior.

Fixed

• Fixed documentation drift around async client shutdown, timeout usage, raw text output, PTAX date parameters, and tidy DataFrame schemas.
• Fixed brittle currency integration expectations for missing symbols.

Meds

• Replaced requests with httpx as the sole HTTP client across all modules
• Added custom exceptions: BCBError, BCBAPIError, CurrencyNotFoundError, SGSError, ODataError
• Added full type annotations with mypy --strict compliance
• Added DATE_COLUMNS class attribute to BaseODataAPI for configurable date column detection
• Renamed internal CACHE to _CACHE in currency module; added currency.clear_cache()
• Overhauled test suite with mocked HTTP unit tests and a separate tests/integration/ layer
• Added CI/CD workflows: test matrix (Python 3.10–3.12), lint (black + mypy), Sphinx docs build
• Fixed Sphinx docs build: updated taxajuros example to match BCB API rename of 'Cheque especial - Pré-fixado' to 'Cheque especial - Prefixado'

Vozes

What's Changed

• Adiciona busca das séries temporais de inadimplência das operações de crédito by @anapaulagomes in #15
• Resolvido: Consultas muito longas retornam erro #19 by @wilsonfreitas in #20
• Add get_json function and corresponding tests for JSON response handling by @wilsonfreitas in #23
• Refactor sgs.get function to use sgs.get_json by @wilsonfreitas in #25

New Contributors

• @anapaulagomes made their first contribution in #15
• @wilsonfreitas made their first contribution in #20

Full Changelog: 0.2.0...0.3.3

Gitá

Many changes

• Date columns of some OData API endpoints are now formatted in the returned Dataframe (Issue #3)
• New methods ODataQuery.raw and ODataQuery.text
• Created class bcb.ODataAPI to directly wrap OData APIs
• Updated documentation
• Updated pyproject.toml
• Updated documentation
• Migrated to poetry
• Added httpx to install_requirements
• Updated docs
• sgs.TaxaJuros upgraded to v2
• Updated README
• Updated requirements files including httpx
• Added autosummary_generate to sphinx conf.py
• Implemented the definitive wrapper for OData APIs.
  • A few APIs have been unlocked: Expectativas, PTAX, taxaJuros, MercadoImobiliario, SPI
• Updated documentation

Birdland

Changes to make the package more compliant with other packages like Quandl and pandas-datareader.

[0.1.4] - 2021-12-27

• Changed arguments start_date and end_date to start and end to bring conformity with commom python data libraries like Quandl and pandas-datareader, for example.
• bcb.currency.get multi argument, which refers to multivariate time series returned (defaults to True)
• bcb.sgs.get groupby argument
• Sphinx docs implemented

one thing I must say

• BUG fix in get_valid_currency_list: recurrent ConnectionError
• Added side and group_by arguments to currency.get function
• New notebooks with examples
• Added join argument to sgs.get function

everything that matters

• New sgs module downloads time series from SGS BACEN's site
• Notebooks created to show a few examples
• Date class moved to utils module

bass solo take 1

First stable release.

• currency module: download currency exchanges data and wraps up into pandas DataFrame