brfinance
TypeScript icon, indicating that this package has built-in type declarations

1.0.12 • Public • Published

Logo BrFinance

BrFinance: Node.JS

Contributors Forks Stargazers Issues MIT License LinkedIn Twitter URL

💡 Description

brFinance is Node.JS web scraping package to simplify access to financial data. It provides data from various sources such as CVM (brazilian equivalent of SEC), B3 (Brazilian stock exchange), Banco Central (brazilian equivalent of FED), ANBIMA, etc.

🚀 Getting Started Tutorial

  1. Install the package
    yarn add brfinance
    or
    npm install brfinance

Features

  • Index Composition - Composition of B3 listed indexes see list
  • Banco central PTAX - Average trade price for currencies in BRL
  • ANBIMA IMA Index - Brazilian bonds index
  • COTA Investment Fund - Brazilian Investment Funds performance history
  • Derivatives - Stats for Derivatives (Futures & Options) see list
  • Industry Classification - Companies Sector, subsector & segment )

📌 Requirements

Currently, Node 14+ is supported. We support the LTS versions of Node.

📚 Usage & Examples

  • Index Composition:
const brFinance = require('brfinance')

async function main() {
    const data = await brFinance.getIndexComposition('IFNC')
    console.table(data.carteira.slice(-5))
}
main()

Index Composition Example
 

  • PTAX:
const brFinance = require('brfinance')

async function main() {
    const ptax = await brFinance.ptax(20210501, 20210510)
    console.table(ptax)
}
main()

Ptax Example
 

  • ANBIMA Index:
const brFinance = require('brfinance')

async function main() {
    const indices = await brFinance.indicesAnbima(20210701, 20210705)
    console.table(
        indices.slice(-3).map((e) =>
            (({ Indice, VariacaoDiaria, VariacaonoMes, VariacaonoAno }) => ({
                Indice,
                VariacaoDiaria,
                VariacaonoMes,
                VariacaonoAno,
            }))(e),
        ),
    )
}
main()

Anbima Example
 

  • COTA Investment Fund:
const brFinance = require('brfinance')

async function main() {
    const cota = await cotaFundo('09143435000160')
    console.table(cota.slice(-5))
}
main()

Cota Example
 

const brFinance = require('brfinance')

async function main() {
    const dollar = await derivativeStats(20210720, 'DOL')
    console.table(dollar.futures)
}
main()

Derivative Example

  • Industry Classification: Get all active sector, subsetor & segmento and their corresponding companies
const brFinance = require('brfinance')

async function main() {
    const industries = await getIndustryClassification()
    console.table(industries.slice(20, 30))
}
main()

Derivative Example

Readme

Keywords

Package Sidebar

Install

npm i brfinance

Weekly Downloads

16

Version

1.0.12

License

Apache 2.0

Unpacked Size

1.27 MB

Total Files

40

Last publish

Collaborators

  • brunolobo