A brapi é uma API B3 gratuita para começar: você envia o ticker e recebe a cotação da bolsa de valores em JSON. PETR4, VALE3, MGLU3 e ITUB4 respondem sem token. Para outros ativos, crie uma conta grátis e envie sua chave.
curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"{
"results": [
{
"requestedSymbol": "PETR4",
"symbol": "PETR4",
"changed": false,
"data": {
"currency": "BRL",
"regularMarketPrice": 41.18,
"regularMarketChangePercent": -1.39,
"regularMarketVolume": 34024700,
"regularMarketTime": "2026-06-14T17:08:02.000Z"
}
}
]
}O preço fica em results[].data.regularMarketPrice. Os valores acima mostram
o formato da resposta. O plano gratuito tem 15.000 requisições por mês e
histórico de até 3 meses.
Como consultar uma cotação da B3
O endpoint clássico também funciona e é o mais curto:
curl "https://brapi.dev/api/quote/PETR4"Para múltiplos ativos:
curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4"Para recursos autenticados, envie seu token no cabeçalho:
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData÷nds=true"Para uma integração nova, prefira o endpoint v2 de cotação:
curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4,VALE3"O endpoint /api/quote/{tickers} continua funcionando. A API v2 separa
cotação, histórico, dividendos e fundamentos, o que reduz dados desnecessários
em cada resposta.
A B3 tem uma API gratuita?
A B3 publica arquivos e conjuntos de dados em seu Hub de dados públicos. Esses materiais incluem séries históricas, empresas listadas e eventos corporativos.
Isso não equivale a uma API REST pública de cotações pronta para uma aplicação. Produtos oficiais de dados e distribuição têm contratos, regras e formatos próprios.
A brapi organiza dados de mercado brasileiro em endpoints JSON voltados a sites, aplicativos, planilhas, robôs e análises. O plano gratuito permite começar a integração e os ativos de teste funcionam sem token.
Chegou aqui procurando a BrasilAPI? Ela cobre CEP, CNPJ, bancos e feriados, mas não traz cotações da bolsa. Veja Brasil API vs brapi para saber quando usar cada uma.
Se você precisa de mais volume, histórico ou dados adicionais, compare os planos da API antes de escolher a integração.
API REST ou COTAHIST
O arquivo COTAHIST é útil para processamento em lote e pesquisa histórica. Uma API REST é mais prática quando a aplicação precisa consultar poucos ativos, filtrar o resultado ou atualizar uma tela.
| Necessidade | Melhor ponto de partida |
|---|---|
| Processar o arquivo bruto de um ano inteiro | COTAHIST da B3 |
| Consultar um ticker em JSON | API REST |
| Atualizar dashboard ou planilha | API REST |
| Auditar a fonte oficial bruta | Arquivos públicos da B3 |
| Buscar fundamentos, dividendos e histórico juntos | brapi |
Se você precisa da lista atual de símbolos, use /api/v2/tickers em vez de
manter um CSV antigo. Veja
como listar todas as ações da B3 por API.
O Que a API Retorna
O endpoint /api/quote/{tickers} retorna uma resposta JSON padronizada. Os campos disponíveis dependem dos parâmetros usados e do plano.
{
"results": [
{
"symbol": "PETR4",
"shortName": "PETROBRAS PN",
"currency": "BRL",
"regularMarketPrice": 37.85,
"regularMarketChange": 0.45,
"regularMarketChangePercent": 1.2,
"regularMarketVolume": 45678900
}
],
"requestedAt": "2026-04-23T14:30:00.000Z",
"took": 245
}Use os campos de preço, variação e volume para dashboards simples. Para análise fundamentalista, inclua modules=defaultKeyStatistics,financialData. Para dividendos, inclua dividends=true.
JavaScript: Consultar Cotações
async function getCotacao(ticker, token) {
const response = await fetch(`https://brapi.dev/api/quote/${ticker}`, {
headers: token ? { Authorization: `Bearer ${token}` } : {},
});
if (!response.ok) {
throw new Error(`Erro ${response.status}`);
}
const data = await response.json();
return data.results[0];
}
const petr4 = await getCotacao('PETR4', process.env.BRAPI_TOKEN);
console.log(`${petr4.symbol}: R$ ${petr4.regularMarketPrice}`);JavaScript: Carteira com Vários Tickers
async function getCarteira(tickers, token) {
const symbols = tickers.join(',');
const response = await fetch(`https://brapi.dev/api/quote/${symbols}`, {
headers: token ? { Authorization: `Bearer ${token}` } : {},
});
const data = await response.json();
return data.results.map((ativo) => ({
ticker: ativo.symbol,
preco: ativo.regularMarketPrice,
variacao: ativo.regularMarketChangePercent,
}));
}
const carteira = await getCarteira(['PETR4', 'VALE3', 'ITUB4'], process.env.BRAPI_TOKEN);
console.table(carteira);Python: Cotações com requests
import os
import requests
def get_cotacao(ticker: str):
token = os.getenv("BRAPI_TOKEN")
headers = {"Authorization": f"Bearer {token}"} if token else {}
response = requests.get(
f"https://brapi.dev/api/quote/{ticker}",
headers=headers,
timeout=15,
)
response.raise_for_status()
return response.json()["results"][0]
petr4 = get_cotacao("PETR4")
print(f"{petr4['symbol']}: R$ {petr4['regularMarketPrice']}")Python: Histórico para Análise
import os
import pandas as pd
import requests
def get_historico(ticker: str, range_: str = "1y", interval: str = "1d"):
token = os.getenv("BRAPI_TOKEN")
headers = {"Authorization": f"Bearer {token}"} if token else {}
response = requests.get(
f"https://brapi.dev/api/quote/{ticker}",
params={"range": range_, "interval": interval},
headers=headers,
timeout=15,
)
response.raise_for_status()
result = response.json()["results"][0]
df = pd.DataFrame(result["historicalDataPrice"])
df["date"] = pd.to_datetime(df["date"], unit="s")
return df
historico = get_historico("VALE3", "6mo", "1d")
print(historico.tail())Principais Parâmetros
| Parâmetro | Uso |
|---|---|
modules=defaultKeyStatistics,financialData | Inclui indicadores e dados fundamentalistas disponíveis |
dividends=true | Inclui dados de dividendos |
range=1y | Define período histórico |
interval=1d | Define granularidade do histórico |
modules= | Solicita módulos específicos quando disponíveis |
Exemplo:
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics,financialData÷nds=true&range=1y&interval=1d"Endpoints Relacionados
| Endpoint | Quando usar |
|---|---|
/api/quote/{tickers} | Cotação de um ou vários ativos |
/api/v2/stocks/quote | Cotação em novas integrações |
/api/v2/stocks/historical | Histórico OHLCV por ativo |
/api/v2/stocks/dividends | Dividendos, JCP e eventos de ações |
/api/v2/tickers | Listagem e validação de tickers |
/api/v2/crypto | Criptomoedas |
/api/v2/currency | Moedas e câmbio |
/api/v2/currency/historical | Histórico PTAX para USD, EUR, GBP, JPY e mais |
/api/v2/macro | Selic, CDI, IPCA, IGP-M, TR e mais 10 indicadores BCB |
Consulte a documentação completa para parâmetros, exemplos e limites de uso. Veja também a documentação de ações para consultar os endpoints de ativos listados.
Casos de Uso
Dashboard de Carteira
Você pode atualizar a carteira em intervalos definidos e renderizar preço, variação e valor total. Em produção, use cache para evitar chamadas desnecessárias.
const tickers = ['PETR4', 'VALE3', 'ITUB4', 'TAEE11'];
const carteira = await getCarteira(tickers, process.env.BRAPI_TOKEN);Alertas de Preço
def alerta_preco(ticker, preco_alvo):
cotacao = get_cotacao(ticker)
preco = cotacao["regularMarketPrice"]
if preco >= preco_alvo:
return f"{ticker} atingiu R$ {preco_alvo}"
return NoneGoogle Sheets
Para planilhas, use Apps Script com UrlFetchApp. Veja o tutorial completo em Integração Google Sheets com Cotações da Bolsa Brasileira.
Boas Práticas
Evite scraping de sites financeiros quando houver API. APIs são mais estáveis, retornam JSON, respeitam limites e reduzem risco de quebra quando uma página muda layout.
Em produção, configure timeout, tratamento de erro, cache e logs. Para dashboards, não atualize a cada segundo se o usuário só precisa de visão de carteira a cada poucos minutos.
Perguntas Frequentes
Existe API de ações brasileiras gratuita?
Sim. A brapi.dev oferece uma API para consultar cotações e dados de ativos da bolsa brasileira, com plano gratuito e recursos adicionais nos planos pagos.
Preciso de token?
Algumas consultas básicas podem funcionar sem token, mas o token é recomendado e necessário para recursos avançados, maior cobertura e limites superiores.
Posso consultar FIIs e ETFs?
Sim. Use o ticker negociado na bolsa brasileira, como MXRF11, HGLG11, BOVA11, IVVB11 ou WRLD11, conforme disponibilidade.
A resposta é em tempo real?
A API foi construída para entregar dados recentes de mercado, mas disponibilidade, atraso e cobertura podem variar conforme ativo, plano e fonte de dados.
Próximos Passos
Crie sua conta em brapi.dev, gere seu token e leia a documentação. Para um fluxo novo, veja dados históricos com Python, indicadores fundamentalistas, Google Sheets com cotações e cotações em um site WordPress. Para consultar os dados no ChatGPT ou no Claude, veja o servidor MCP da brapi.
