B3 API Gratuita: Como Usar Cotações em Tempo Real em 2026

# Consultar cotação de PETR4 (Petrobras)
curl "https://brapi.dev/api/quote/PETR4"

# Consultar múltiplas ações de uma vez
curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4"

# Com token de autenticação (para mais recursos)
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/quote/PETR4?fundamental=true"

{
  "results": [
    {
      "symbol": "PETR4",
      "shortName": "PETROBRAS PN",
      "currency": "BRL",
      "regularMarketPrice": 37.85,
      "regularMarketChange": 0.45,
      "regularMarketChangePercent": 1.2,
      "regularMarketDayHigh": 38.20,
      "regularMarketDayLow": 37.10,
      "regularMarketVolume": 45678900,
      "marketCap": 485000000000
    }
  ],
  "requestedAt": "2026-01-07T14:30:00.000Z"
}

// Usando fetch (navegador ou Node.js 18+)
async function getCotacao(ticker) {
  const response = await fetch(`https://brapi.dev/api/quote/${ticker}`);
  const data = await response.json();
  return data.results[0];
}

// Exemplo de uso
const petr4 = await getCotacao('PETR4');
console.log(`PETR4: R$ ${petr4.regularMarketPrice}`);
console.log(`Variação: ${petr4.regularMarketChangePercent.toFixed(2)}%`);

// Consultar várias ações de uma vez
async function getCarteira(tickers) {
  const tickerString = tickers.join(',');
  const response = await fetch(`https://brapi.dev/api/quote/${tickerString}`);
  const data = await response.json();
  
  return data.results.map(acao => ({
    ticker: acao.symbol,
    preco: acao.regularMarketPrice,
    variacao: acao.regularMarketChangePercent
  }));
}

// Minha carteira de ações
const carteira = await getCarteira(['PETR4', 'VALE3', 'ITUB4', 'BBDC4']);
console.table(carteira);

import requests

def get_cotacao(ticker):
    """Consulta cotação de uma ação na B3 via API gratuita"""
    url = f"https://brapi.dev/api/quote/{ticker}"
    response = requests.get(url)
    data = response.json()
    return data['results'][0]

# Exemplo de uso
petr4 = get_cotacao('PETR4')
print(f"PETR4: R$ {petr4['regularMarketPrice']}")
print(f"Variação: {petr4['regularMarketChangePercent']:.2f}%")

# Consultar múltiplas ações
def get_carteira(tickers):
    """Consulta várias ações de uma vez"""
    ticker_string = ','.join(tickers)
    url = f"https://brapi.dev/api/quote/{ticker_string}"
    response = requests.get(url)
    return response.json()['results']

carteira = get_carteira(['PETR4', 'VALE3', 'ITUB4'])
for acao in carteira:
    print(f"{acao['symbol']}: R$ {acao['regularMarketPrice']}")

import requests
import pandas as pd

def get_historico(ticker, range='1y', interval='1d'):
    """Obtém dados históricos para análise e backtesting"""
    url = f"https://brapi.dev/api/quote/{ticker}"
    params = {
        'range': range,      # 1d, 5d, 1mo, 3mo, 6mo, 1y, 5y, max
        'interval': interval  # 1d, 1wk, 1mo
    }
    response = requests.get(url, params=params)
    data = response.json()['results'][0]
    
    # Converter para DataFrame
    historico = pd.DataFrame(data['historicalDataPrice'])
    historico['date'] = pd.to_datetime(historico['date'], unit='s')
    return historico

# Exemplo: últimos 6 meses de VALE3
vale3_hist = get_historico('VALE3', range='6mo')
print(vale3_hist.head())

// Atualizar dashboard a cada 5 minutos
setInterval(async () => {
  const carteira = await getCarteira(['PETR4', 'VALE3', 'ITUB4']);
  atualizarDashboard(carteira);
}, 5 * 60 * 1000);

def verificar_alerta(ticker, preco_alvo):
    cotacao = get_cotacao(ticker)
    if cotacao['regularMarketPrice'] >= preco_alvo:
        enviar_notificacao(f"{ticker} atingiu R$ {preco_alvo}!")

function getCotacaoBrapi(ticker) {
  const url = `https://brapi.dev/api/quote/${ticker}`;
  const response = UrlFetchApp.fetch(url);
  const data = JSON.parse(response.getContentText());
  return data.results[0].regularMarketPrice;
}

// Na planilha: =getCotacaoBrapi("PETR4")

# Comando: /cotacao PETR4
def comando_cotacao(ticker):
    acao = get_cotacao(ticker)
    return f"""
    📈 {acao['symbol']} - {acao['shortName']}
    💰 Preço: R$ {acao['regularMarketPrice']:.2f}
    📊 Variação: {acao['regularMarketChangePercent']:.2f}%
    📦 Volume: {acao['regularMarketVolume']:,}
    """