pybovespa 0.1.2

pybovespa

The BM&FBOVESPA (in full, Bolsa de Valores, Mercadorias & Futuros de São Paulo) is a stock exchange located at São Paulo, Brazil.

pybovespa is a basic and simple library to get official BM&FBOVESPA stock values.

Installing or updating

Just run:

# pip install -U pybovespa

Show-me an example, I need code!

15-minute delayed info

When you make a request, 15-minute-old information is retrieved. You can check the date and time with stock.time. Example:

#!/usr/bin/env python3

from pybovespa.bovespa import *
from pybovespa.stock import *

bovespa = Bovespa()
stock = bovespa.query("PETR3")
print(stock.cod, stock.name, stock.last)

The output should be something like this:

PETR3 PETROBRAS ON 24,24

It is possible to make only one request for many stocks:

stocks = bovespa.query("PETR4", "VALE5", "OGXP3")
for stock in stocks.values():
    print(stock.cod, stock.last)

stock_vale = stocks["VALE5"]

Historical stock data

Unfortunately, BM&FBovespa does not allow the distribution of their data. However, it is very simple to download them using this library:

bovespa = Bovespa()
bovespa.download(dst="/tmp/hist", year="2012", overwrite=True)

To download data of all available years:

bovespa.download_all(dst="/tmp/hist", overwrite=True)