Autenticação e tokens

Use o header Authorization para autenticar chamadas à API brapi.dev.

Chamada autenticada

curl "https://brapi.dev/api/v2/stocks/quote?symbols=PETR4" \
  -H "Authorization: Bearer SEU_TOKEN"

Crie ou consulte seu token no dashboard.

Sandbox sem token

Você pode testar quatro símbolos sem token: PETR4, MGLU3, VALE3 e ITUB4. Use esses símbolos para validar a integração antes de configurar credenciais.

Segurança

• Guarde o token em uma variável de ambiente.
• Não coloque o token em código frontend, URLs, logs ou repositórios.
• Use HTTPS em todas as chamadas de produção.
• Para clientes MCP, use a URL https://brapi.dev/api/mcp/mcp e o fluxo OAuth do cliente.

Limites e erros

Leia RateLimit-Limit, RateLimit-Remaining e RateLimit-Reset em cada resposta. Em HTTP 429, aguarde o número de segundos indicado por Retry-After.

Respostas HTTP 401 indicam token ausente ou inválido. Respostas HTTP 403 indicam que o plano não inclui o recurso solicitado.

Consulte o OpenAPI JSON para os esquemas de segurança, parâmetros tipados, operationId e respostas de cada endpoint.