yfinance

Quem estuda mercado em Python logo esbarra no mesmo problema: conseguir preços históricos sem assinar um terminal de dados. O yfinance busca cotações, dividendos e informações de empresas no Yahoo Finance e entrega tudo ao seu script com poucas linhas. É uma biblioteca de pesquisa e não indica compra ou venda de ativo nenhum.

Para que serve

• Baixar o histórico de preços de vários tickers de uma vez com a função download.
• Puxar os dados de uma empresa específica pelo objeto Ticker.
• Filtrar ações por critérios com EquityQuery e Screener.
• Seguir cotações em tempo real pelo WebSocket.
• Alimentar um estudo de backtest com séries históricas.

Como começar

A instalação é pelo pip:

pip install yfinance

O README não pede cadastro nem chave de API. Um detalhe pega muita gente no início: os preços vêm ajustados por dividendos por padrão (auto_adjust=True). Se você comparar com o fechamento mostrado em outro site, os números podem não bater, e esse ajuste é a primeira coisa a conferir.

Licença e custo

A biblioteca segue a Apache-2.0. Ela libera uso, mudança e distribuição do código e ainda traz uma concessão expressa das patentes dos contribuidores. Não há cobrança.

Os dados, porém, pertencem a outra empresa. O próprio projeto declara que não tem vínculo com o Yahoo nem aval dele, que foi feito para pesquisa e educação e que a API do Yahoo Finance é destinada a uso pessoal. Os direitos sobre o que você baixa seguem os termos de uso do Yahoo.

Quando vale a pena

Para um estudo pessoal, um notebook de aula ou um protótipo, o yfinance poupa horas de coleta manual. Num sistema que mexe com dinheiro de verdade, não use a biblioteca como fonte única: confira os números com outra base. E antes de acreditar num teste feito com esses dados, leia por que o resultado de um backtest engana.

Se a ideia é reunir várias fontes de dados financeiros num terminal de pesquisa, o OpenBB foi feito para isso.