Skip to content

pixbr

CI PyPI version Python versions License: MIT

pixbr is a Python client for the Brazilian Central Bank (BCB) PIX Open Data API. It hides the BCB's unusual OData URL syntax and returns pandas DataFrames, so you can go straight from a query to analysis.

It is the Python counterpart of the R package pixr.

Features

  • Four endpoints, one interface — PIX keys, transactions by municipality, transaction statistics, and fraud (MED) statistics.
  • pandas-native — every call returns a DataFrame with numeric columns already coerced.
  • Full OData support — filter, select (columns), orderby, top.
  • Two styles — a reusable PixClient or pixr-style convenience functions.
  • Aggregation helpers — summaries by institution, key type, state, region.

Install

pip install pixbr

Quick taste

from pixbr import PixClient

client = PixClient()
stats = client.transaction_stats("202509", filter="NATUREZA eq 'P2P'")
stats.head()

Head to Get Started for the full tour, or the Reference for every function.