bcraapi is a Python wrapper for BCRA APIs provided by Banco Central de la República Argentina itself. It makes use of requests and pandas and returns the data in a pandas DataFrame.
The BCRA API does not require tokens or registration, so do not hesitate to use it.
pip install bcraapi
You will be able to access to resources related to exchange rate information published by the BCRA.
You will be able to consult reported, lost, stolen or adulterated checks. The information available here is provided by the financial entities operating in the country and is published without alterations.
You will be able to access resources related to the main and monetary variables information published by the BCRA.
You will be able to access resources related to the main variables information published by the BCRA.
You will be able to access standardized information that financial entities must publish according to BCRA regulations. It allows consulting products, interest rates, commissions, and other regulated data.
Method to obtain the list of all the banking entities in the country with their respective entity code.
from bcraapi import cheques
df = cheques.entidades()DataFrame with the list of all the banking entities in the country with their respective entity code.
Method to know if a check from a certain entity is registered as reported or not.
from bcraapi import cheques
df = cheques.denunciados(codigo_entidad=11, numero_cheque=20377516)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
ID of the financial entity. It can be queried via entidades(). |
numero_cheque |
int |
Corresponds to the check number to be consulted. |
DataFrame with the result if a check is registered as reported or not.
Method for obtaining the methodologies corresponding to each reported variable published by the BCRA.
from bcraapi import estadisticas
df = estadisticas.metodologia()| Parameter | Type | Description |
|---|---|---|
idvariable |
int |
ID of the desired variable. |
| Parameter | Type | Description |
|---|---|---|
desde |
str |
The start date of the range to be queried, it must be in the format YYYY-MM-DD. |
hasta |
str |
The end date of the range to be queried, it must be in the format YYYY-MM-DD. |
offset |
int |
Records to discard for paging. Default: 0. |
limit |
int |
Records to be returned by the service. The maximum value is 3000. Default: 1000. |
DataFrame with the methodology corresponding to the reported variable.
Method for obtaining the evolution of values for the monetary variable within a date range.
from bcraapi import estadisticas
df = estadisticas.datos_monetarias(id_variable=1, desde="2024-02-01", hasta="2024-02-05", limit=1000, offset=0)| Parameter | Type | Description |
|---|---|---|
id_variable |
int |
ID of the desired variable. Required |
| Parameter | Type | Description |
|---|---|---|
desde |
str |
The start date of the range to be queried, it must be in the format YYYY-MM-DD. |
hasta |
str |
The end date of the range to be queried, it must be in the format YYYY-MM-DD. |
offset |
int |
Records to discard for paging. Default: 0. |
limit |
int |
Records to be returned by the service. The maximum value is 3000. Default: 1000. |
DataFrame with the values for the selected variable and date range.
Method for obtaining a list of all monetary variables published by the BCRA.
from bcraapi import estadisticas
df = estadisticas.monetarias(id_variable=1, limit=1000, offset=0)| Parameter | Type | Description |
|---|---|---|
id_variable |
int |
Optional. ID of the desired variable. |
categoria |
str |
Indicates the classification of the monetary variable. It is not necessary to enter the entire text. |
tipo_serie |
str |
It corresponds to the economic characterization of the variable. It is not necessary to enter the entire text. |
periodicidad |
str |
Frequency: daily D, monthly M, quarterly T (or Q). |
unidad_expresion |
str |
Unit of measurement for the economic variable. It is not necessary to enter the entire text. |
offset |
int |
Records to discard for paging. Default: 0. |
limit |
int |
Records to be returned by the service. The maximum value is 3000. Default: 1000. |
DataFrame with the values for the selected variable and date range.
Method to obtain the list of all ISO currencies in force, with their respective denominations. denomination.
from bcraapi import estadisticascambiarias
df = estadisticascambiarias.maestros_divisas()DataFrame with the list of currencies of the BCRA.
Method to obtain the list of all current foreign exchange rates published by the BCRA for a given date (yyyy-MM-dd). BCRA for a given date. If no date is entered, the last existing quote will be returned. the last existing quotation will be returned.
from bcraapi import estadisticascambiarias
df = estadisticascambiarias.cotizaciones(fecha="2024-06-12")| Parameter | Type | Description |
|---|---|---|
fecha |
str |
Date of the data to be consulted, it must have the format YYYY-MM-DD. |
DataFrame with the values for the selected date.
Method to obtain the price evolution of a currency (ISO) in a particular date range. If the date from and date to parameters are not entered, the last existing quote will be returned. the last existing quote will be returned.
from bcraapi import estadisticascambiarias
df = estadisticascambiarias.cotizaciones_moneda(moneda="USD")| Parameter | Type | Description |
|---|---|---|
moneda |
str |
ISO currency. This parameter is required |
fecha_desde |
str |
The start date of the range to be queried, it must be in the format YYYY-MM-DD. |
fecha_hasta |
str |
The end date of the range to be queried, it must be in the format YYYY-MM-DD. |
limit |
int |
Maximum amount to be returned per application. Must be greater than 10 and less than 1000. |
ofset |
int |
Exclude from the answer the first N elements of the contributions to be refunded.. |
Datarame with the evolution of the exchange rate of a currency.
Method to obtain the credit situation, amount of debt, days in arrears and observations corresponding to the last period reported by the entities to the BCRA.
from bcraapi import centraldeudores
df = centraldeudores.deudas(30500010912)| Parameter | Type | Description |
|---|---|---|
identificacion |
str |
Corresponds to CUIT/CUIL/CDI, it must be 11 characters long. |
DataFrame with the credit situation, amount of debt, days in arrears and observations corresponding to the last period reported by the entities to the BCRA.
Method to obtain the credit situation for the last 24 months.
from bcraapi import centraldeudores
df = centraldeudores.deudas_historicas(30500010912)| Parameter | Type | Description |
|---|---|---|
identificacion |
str |
Corresponds to CUIT/CUIL/CDI, it must be 11 characters long. |
DataFrame with the credit situation for the last 24 months.
Method to obtain the rejected checks with their corresponding reasons.
from bcraapi import centraldeudores
df = centraldeudores.cheques_rechazados(30717283186)| Parameter | Type | Description |
|---|---|---|
identificacion |
str |
Corresponds to CUIT/CUIL/CDI, it must be 11 characters long. |
DataFrame with the rejected checks with their corresponding reasons.
Authentication is not required for any endpoint in this API.
Method to obtain the complete list of savings accounts (cajas de ahorro) or filter by a specific financial entity.
from bcraapi import transparencia
df = transparencia.cajas_ahorros(codigo_entidad=11)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame with the details of the financial entity, report date, and whether it uses a simplified due diligence onboarding process (procesoSimplificadoDebidaDiligencia).
Method to obtain the complete list of product bundles (paquetes de productos) or filter them by a specific entity.
from bcraapi import transparencia
df = transparencia.paquetes_productos(codigo_entidad=14)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame including bundle name, segment (e.g., Básico, Premium), participating products, maximum monthly maintenance commission (comisionMaximaMantenimiento), age/income requirements, validity territory, and additional information.
Method to obtain the complete list of fixed-term deposits (plazos fijos) or filter by a specific entity.
from bcraapi import transparencia
df = transparencia.plazos_fijos(codigo_entidad=303)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame containing full type name, currency denomination (e.g., Pesos, USD, UVAs), minimum investment amount/days, acquisition channels (e.g., Home banking, ATM), minimum annual effective rate (tasaEfectivaAnualMinima), and offer validity territory.
Method to obtain the complete list of pledge loans (préstamos prendarios) or filter them by a specific entity.
from bcraapi import transparencia
df = transparencia.prestamos_prendarios(codigo_entidad=7)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame outlining loan limits, evaluation rules (e.g., relacionMontoTasacion), maximum repayment terms, beneficiary profile, early cancellation fee, maximum annual effective rate, maximum total financial cost (costoFinancieroEfectivoTotalMaximo), initial installment per $10,000, and target funds use.
Method to obtain the complete list of mortgage loans (préstamos hipotecarios) or filter them by a specific entity.
from bcraapi import transparencia
df = transparencia.prestamos_hipotecarios(codigo_entidad=7)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame outlining target funds use (e.g., main residence, construction, improvement), loan boundaries, maximum terms, required income, maximum annual effective rate, financial cost, initial installment per $100,000, and rate adjustment rules.
Method to obtain the complete list of personal loans (préstamos personales) or filter them by a specific entity.
from bcraapi import transparencia
df = transparencia.prestamos_personales(codigo_entidad=55236)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame outlining minimum/maximum loanable amount, currency denomination, monthly income and job seniority requirements, maximum age, installment-to-income ratio (relacionCuotaIngreso), beneficiary segment, early cancellation charge, maximum annual effective rate, total financial cost, initial installment per $10,000, and validity region.
Method to obtain the complete list of credit cards (tarjetas de crédito) or filter them by a specific entity.
from bcraapi import transparencia
df = transparencia.tarjetas_credito(codigo_entidad=341)| Parameter | Type | Description |
|---|---|---|
codigo_entidad |
int |
Optional. ID of the financial entity assigned by the BCRA. |
DataFrame with credit card full/short name, maximum monthly maintenance commission, maximum renewal fee (comisionMaximaRenovacion), maximum financing/cash-advance annual effective interest rates, income/seniority requirements, commercial segment (e.g., Gold, Platinum, Black), and validity territory.