Comece a Usar a API da brapi.dev

Bem-vindo à documentação da brapi.dev. Nossa API foi projetada para ser simples, robusta e confiável, permitindo que você integre dados financeiros do mercado brasileiro em suas aplicações com o mínimo de esforço.

Este guia vai te mostrar como fazer sua primeira requisição em minutos.

curl --request GET \
  --url 'https://brapi.dev/api/quote/PETR4' \
  --header 'Authorization: Bearer SEU_TOKEN'

{
  "results": [
    {
      "symbol": "PETR4",
      "shortName": "PETROBRAS PN",
      "longName": "Petróleo Brasileiro S.A. - Petrobras",
      "currency": "BRL",
      "regularMarketPrice": 38.50,
      "regularMarketDayHigh": 39.00,
      "regularMarketDayLow": 38.20,
      "regularMarketChange": 0.30,
      "regularMarketChangePercent": 0.78,
      "regularMarketTime": "2024-10-26T17:08:00.000Z",
      "marketCap": 503100000000,
      "regularMarketVolume": 45678901,
      "logourl": "https://icons.brapi.dev/logos/PETR4.png",
    }
  ]
}

Autenticação

Todas as requisições à API devem ser autenticadas. Recomendamos enviar seu token através do header Authorization por ser mais seguro.

Principais Conceitos

• URL Base: Todas as requisições usam a URL base https://brapi.dev/api.
• Múltiplos Ativos: A maioria dos endpoints permite a consulta de múltiplos ativos em uma única requisição, separando os tickers por vírgula. Ex: PETR4,VALE3,MGLU3.
• Módulos Adicionais: Use o parâmetro modules para enriquecer suas respostas com dados fundamentalistas e mais (disponível conforme seu plano).

Explore Nossos Endpoints

Navegue pelas seções para descobrir todos os dados que você pode acessar.

Exemplos Práticos

Veja como é fácil buscar dados em diferentes linguagens.

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/quote/ITUB4,BBDC4?range=1mo&interval=1d"

import requests

token = "SEU_TOKEN"
tickers = "ITUB4,BBDC4"
url = f"https://brapi.dev/api/quote/{tickers}"

response = requests.get(
    url,
    headers={"Authorization": f"Bearer {token}"},
    params={"range": "1mo", "interval": "1d"}
)

if response.status_code == 200:
    data = response.json()
    print(data['results'])
else:
    print(f"Erro: {response.status_code}")

const token = 'SEU_TOKEN';
const tickers = 'ITUB4,BBDC4';
const url = `https://brapi.dev/api/quote/${tickers}?range=1mo&interval=1d`;

async function fetchQuotes() {
  try {
    const response = await fetch(url, {
      headers: {
        'Authorization': `Bearer ${token}`
      }
    });

    if (!response.ok) {
      throw new Error(`HTTP error! status: ${response.status}`);
    }

    const data = await response.json();
    console.log(data.results);
  } catch (error) {
    console.error('Falha ao buscar cotações:', error);
  }
}

fetchQuotes();

Próximos Passos

Agora que você já entendeu o básico, o que acha de explorar mais a fundo?

• Explore os endpoints de Ações: A seção mais completa, com dados fundamentalistas e dividendos.
• Veja todos os exemplos: Descubra como aplicar a API em casos de uso mais complexos.