pyBCRAdata 0.4.4

Cliente Python para acceder a estadísticas monetarias, datos de tipo de cambio e información de deudores del Banco Central de la República Argentina (BCRA)

Cliente Python para acceder a estadísticas monetarias, datos de tipo de cambio e información de deudores publicados por el Banco Central de la República Argentina (BCRA). Diseñado para economistas, analistas y desarrolladores que trabajan con datos macroeconómicos.

📍 Repositorio GitHub: https://github.com/morabdiego/pyBCRA

🛆 Instalación

pip install pyBCRAdata

Requiere Python 3.7+, requests y pandas. Ver documentación de instalación para más detalles.

📊 Ejemplo Rápido

from pyBCRAdata import monetary, currency, checks, debtors

# Obtener variables monetarias
variables = monetary.variables()

# Obtener cotización por fecha de todas las divisas
cotizacion = currency.rates(fecha="2024-01-01")

# Obtener entidades bancarias
bancos = checks.banks()

# Consultar deudores
deudas = debtors.debtors(identificacion="12345678")

O usando el cliente completo:

from pyBCRAdata import BCRAclient

# Inicializar cliente
client = BCRAclient()

# Obtener tasa de política monetaria
df = client.monetary.series(
    id_variable="6",  # Tasa de Política Monetaria (en % n.a.)
    desde="2024-01-01",
    hasta="2024-03-21"
)
print(df.head())

# Obtener cotización histórica del dólar
usd = client.currency.series(
    moneda="USD",
    fechadesde="2024-01-01",
    fechahasta="2024-03-21"
)
print(usd.head())

📚 Documentación

La documentación completa está disponible en la carpeta docs:

• Documentación de Instalación - Instrucciones para la instalación
• Referencia de API - Información detallada sobre cada método

Nota: Toda la documentación está disponible en español e inglés. Cada archivo incluye ambos idiomas con una separación clara.

Principales áreas de datos

• Estadísticas Monetarias - Variables monetarias y series históricas
• Estadísticas Cambiarias - Monedas, cotizaciones y series históricas
• Central de Deudores - Deudores, historial y cheques rechazados
• Cheques Denunciados - Bancos y cheques denunciados

🔑 Acceso a la API

Este cliente interactúa con las APIs públicas del BCRA disponibles en el Catálogo de APIs del BCRA.

No se requiere token de autenticación, pero tenga en cuenta que:

• El BCRA puede implementar limitaciones de tasa basadas en dirección IP
• Considere implementar caché para datos de acceso frecuente

Para información detallada sobre manejo de errores, respuestas del servidor y avisos legales, consulte directamente la página del Catálogo de APIs del BCRA. Este proyecto es únicamente un cliente para facilitar el acceso a los datos y toda responsabilidad legal corresponde al BCRA como proveedor de la API.

👋 Acerca de

Creado por Diego Mora — Economista y Desarrollador Python.

• LinkedIn
• GitHub
• 📧 Email: [e-mail]

📜 Licencia

Este proyecto está licenciado bajo Creative Commons Attribution-NonCommercial 4.0 International License.

---

Python client to access monetary statistics, exchange rate data, and debtor information published by the Central Bank of the Argentine Republic (BCRA). Designed for economists, analysts, and developers working with macroeconomic data.

📍 GitHub Repository: https://github.com/morabdiego/pyBCRA

🛆 Installation

pip install pyBCRAdata

Requires Python 3.7+, requests, and pandas. See installation documentation for more details.

📊 Quick Example

from pyBCRAdata import monetary, currency, checks, debtors

# Get monetary variables
variables = monetary.variables()

# Get USD exchange rate
cotizacion = currency.rates(fecha="2024-01-01")

# Get bank entities
bancos = checks.banks()

# Query debtors
deudas = debtors.debtors(identificacion="12345678")

Or using the complete client:

from pyBCRAdata import BCRAclient

# Initialize client
client = BCRAclient()

# Get monetary policy rate
df = client.monetary.series(
    id_variable="6",  # Monetary Policy Rate (in % p.a.)
    desde="2024-01-01",
    hasta="2024-03-21"
)
print(df.head())

# Get historical USD exchange rate
usd = client.currency.series(
    moneda="USD",
    fechadesde="2024-01-01",
    fechahasta="2024-03-21"
)
print(usd.head())

📚 Documentation

Complete documentation is available in the docs folder:

• Installation Documentation - Installation instructions
• API Reference - Detailed information about each method

Note: All documentation is available in both Spanish and English. Each file includes both languages with clear separation.

Main Data Areas

• Monetary Statistics - Monetary variables and historical series
• Exchange Rate Statistics - Currencies, exchange rates and historical series
• Debtors Central - Debtors, history and rejected checks
• Reported Checks - Banks and reported checks

🔑 API Access

This client interacts with the public BCRA APIs available in the BCRA API Catalog.

No authentication token is required, but please note that:

• The BCRA may implement rate limitations based on IP address
• Consider implementing caching for frequently accessed data

For detailed information on error handling, server responses, and legal notices, please refer directly to the BCRA API Catalog page. This project is solely a client to facilitate data access, and all legal responsibility belongs to the BCRA as the API provider.

👋 About

Created by Diego Mora — Economist and Python Developer.

• LinkedIn
• GitHub
• 📧 Email: [e-mail]

📜 License

This project is licensed under Creative Commons Attribution-NonCommercial 4.0 International License.