1.0.12 • Published 2 years ago

brfinance v1.0.12

Weekly downloads
-
License
Apache 2.0
Repository
-
Last release
2 years ago

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()

\  

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

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

\  

  • 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()

\  

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

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

\  

const brFinance = require('brfinance')

async function main() {
    const dollar = await derivativeStats(20210720, 'DOL')
    console.table(dollar.futures)
}
main()
  • 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()

📣 Feedback & Contact

If you have any suggestions or want to let us know what you think about the project, send us a message at Twitter URL

1.0.12

2 years ago

1.0.11

3 years ago

1.0.10

3 years ago

1.0.9

3 years ago

1.0.8

3 years ago

1.0.7

3 years ago

1.0.6

3 years ago

1.0.5

3 years ago

1.0.4

3 years ago

1.0.3

3 years ago

1.0.2

3 years ago

1.0.1

3 years ago

1.0.0

3 years ago