1.0.6 • Published 1 year ago

bcra-statistics-sdk v1.0.6

Weekly downloads
-
License
MIT
Repository
github
Last release
1 year ago

bcra-statistics-sdk: A Node.js Package for Interacting with the BCRA Statistics API

This package provides a convenient way for Node.js applications to interact with the Statistics API of the Central Bank of Argentina (Banco Central de la República Argentina, BCRA).

Installation

You can install the bcra-statistics-sdk package using one of the following package managers:

  • npm:
npm install bcra-statistics-sdk
  • yarn:
yarn add bcra-statistics-sdk
  • bun:
bun add bcra-statistics-sdk
  • pnpm:
pnpm add bcra-statistics-sdk

Usage

CommonJS:

async function main() {
  const { BCRAStatisticsClient } = await import('bcra-statistics-sdk');

  const client = new BCRAStatisticsClient();

  // Get all published variables
  const principalVariablesResponse = await client.getPrincipalVariables();
  console.log('Principal Variables:', JSON.stringify(principalVariablesResponse));

  // Get data for a specific variable between dates
  const variableDataResponse = await client.getVariableData(1, '2024-01-01', '2024-05-01');
  console.log('Variable Data:', JSON.stringify(variableDataResponse));
}

main().catch(console.error);

ESM and TypeScript:

import { BCRAStatisticsClient } from 'bcra-statistics-sdk';

const client = new BCRAStatisticsClient();

// ... (same usage as CommonJS)

API Reference

Classes

  • BCRAStatisticsClient: This class provides methods for interacting with the BCRA Statistics API.

Properties

Methods

  • getPrincipalVariables(): Promise<BCRAStatisticsResponse>: Retrieves all the published variables from the BCRA. Returns a promise that resolves to an object with properties:
    • status: The HTTP status code of the response.
    • errorMessages (optional): An array of error messages if the request failed.
    • results (optional): An array of BCRAStatisticsMainVar objects if the request was successful.
  • getVariableData(idVariable: number, fechaDesde: string, fechaHasta: string): Promise<BCRAStatisticsResponse>: Retrieves the values of a specific variable between the specified dates.
    • idVariable: The ID of the variable to retrieve data for.
    • fechaDesde: The starting date in the range (format yyyy-mm-dd).
    • fechaHasta: The ending date in the range (format yyyy-mm-dd).
    • Returns a promise that resolves to an object with properties:
      • status: The HTTP status code of the response.
      • errorMessages (optional): An array of error messages if the request failed.
      • results (optional): An array of BCRAStatisticsDataVar objects if the request was successful.

Interfaces

  • BCRAStatisticsResponse: An interface representing the response structure of the BCRA Statistics API.
    • status: The HTTP status code of the response.
    • errorMessages (optional): An array of error messages if the request failed.
    • results (optional): An array of data objects of type T if the request was successful.
  • BCRAStatisticsMainVar: An interface representing the structure of a variable object in the getPrincipalVariables response.
    • idVariable: The ID of the variable.
    • cdSerie: The series code of the variable.
    • descripcion: The description of the variable.
    • fecha: The date of the variable value.
    • valor: The value of the variable.
  • BCRAStatisticsDataVar: An interface representing the structure of a variable data object in the getVariableData response.
    • idVariable: The ID of the variable.
    • fecha:
1.0.6

1 year ago