Sobre o projeto

alpha_vantage é um wrapper em Python para a API REST da Alpha Vantage de dados do mercado financeiro. É necessária uma chave de API gratuita, que pode ser fornecida diretamente ou por meio da variável de ambiente ALPHAVANTAGE_API_KEY. Chaves RapidAPI também são suportadas quando rapidapi=True. O pacote pode ser instalado com pip install alpha_vantage; pandas é uma dependência opcional. A biblioteca organiza os endpoints da API em classes como TimeSeries, TechIndicators, CryptoCurrencies e ForeignExchange. As chamadas geralmente retornam dados e metadados, embora o endpoint de câmbio não tenha metadados. Dicionários JSON são o formato de saída padrão, enquanto pandas DataFrames podem ser solicitados se o pandas estiver instalado. A saída CSV está disponível apenas para endpoints que a suportam; o README observa que ForeignExchange e TechIndicators não suportam CSV. Os DataFrames podem usar indexação baseada em data ou inteira, e um contador configurável de tentativas é fornecido para falhas de conexão. A cobertura de dados documentada inclui séries temporais de ações, preços de moedas digitais, taxas de câmbio e indicadores técnicos como SMA e Bandas de Bollinger. O README informa que a versão 3.0.0 adiciona opções, commodities, indicadores econômicos, recursos Alpha Intelligence e suporte adicional a dados fundamentalistas. Um parâmetro month pode ser usado em consultas históricas intraday e de indicadores técnicos. Os exemplos também mostram a plotagem dos dados retornados com pandas e matplotlib. O uso assíncrono está disponível para Python 3.5+ por meio de alpha_vantage.async_support, permitindo chamadas à API com async/await e asyncio.gather para vários símbolos. São referenciados instalação a partir do código-fonte, testes que exigem uma chave de API além de pandas, mock e nose, documentação no Read the Docs e um repositório de notebooks de exemplo. O README inclui vários links promocionais de terceiros e afirmações editoriais; essas são declarações externas, e não recursos da biblioteca verificados de forma independente.