B3 Historical Quote Data API

A JSON file based API for historical stock quote data from the B3 Brazilian Stock Exchange.

---

Grátis, customizável e simples.

Essa API fornece dos dados disponibilizados pela B3 para download em formato de API!

Os dados não tratados podem ser baixados diretamento no site da B3 em: https://www.b3.com.br/.../series-historicas

Essa API possui dados de 2010 até dias atuais.

Endpoints

Lista de ativos do mercado à vista

GET: https://cvscarlos.github.io/b3-api-dados-historicos/api/v1/tickers-cash-market.json

Exemplo de resposta:

{
  "data": {
    "PETR4": { // Código de negociação do ativo
      "codNeg": "PETR4", // Código de negociação do ativo
      "nomeCurto": "PETROBRAS", // Nome curto do ativo
      "especPapel": "PN N2", // Especificação do ativo
      // Datas no formato YYYYMMDD
      "dataMax": 20231124, // Maior data existente nos dados tratados p/ esse ativo. 
      "dataMin": 20100104 // Menor data existente nos dados tratados p/ esse ativo
    }
  }
}

Atualizando os dados da API

A B3 adicionou um captcha no download dos dados, então para atualizar os dados da API você precisa:

1. Acessar a página de séries históricas da B3;
2. Baixe o arquivo com a série de dados deseja, "Séries Anuais" por exemplo (as vezes é necessário uso de VPN);
3. Coloque o arquivo na pasta docs/b3-raw-files;
4. Execute npm run unzip && npm run parse.

Outra opção é tentar baixar o arquivo zip diretamente: https://bvmf.bmfbovespa.com.br/InstDados/SerHist/COTAHIST_A2025.ZIP