Skip to content

lobobruno/brFinance

Repository files navigation

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

About

Scraping package to access Brazil's financial data.

Topics

Resources

License

Stars

Watchers

Forks