API de Ações Brasileiras Gratuita: Como Consultar Cotações da Bolsa com JavaScript e Python

curl "https://brapi.dev/api/quote/PETR4"

curl "https://brapi.dev/api/quote/PETR4,VALE3,ITUB4"

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/quote/PETR4?modules=defaultKeyStatistics,financialData&dividends=true"

{
  "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
}

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}`);

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);

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']}")

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())

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/quote/TAEE11?modules=defaultKeyStatistics,financialData&dividends=true&range=1y&interval=1d"

const tickers = ['PETR4', 'VALE3', 'ITUB4', 'TAEE11'];
const carteira = await getCarteira(tickers, process.env.BRAPI_TOKEN);

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 None