Documentação
Documentação da API brapi.dev
API REST de dados do mercado brasileiro: ações, FIIs, fundos, opções, futuros, Tesouro Direto, macro, moedas e cripto em JSON.
A brapi é uma API REST de dados do mercado financeiro brasileiro. Você envia um
ticker e recebe cotações, histórico, dividendos e fundamentos em JSON. Todas as
requisições partem de https://brapi.dev/api.
Escolha os dados
Tickers
Busque, filtre e resolva tickers brasileiros.
Ações
Cotação, histórico, dividendos e demonstrações financeiras.
Opções
Cadeia de opções, gregas, volatilidade implícita e posições.
Futuros
Contratos futuros, cotações, curva de vencimentos e opções.
Fundos
FIAGRO, FI-Infra, FIF, FIDC e FIP: indicadores, cota e carteira.
FIIs
Indicadores, rendimentos, imóveis e relatórios da CVM.
Tesouro Direto
Títulos públicos, taxas e preços.
Macroeconomia
SELIC, CDI, IPCA, IGP-M e outras séries.
Moedas
Cotação e histórico de câmbio.
Criptomoedas
Preço de criptomoedas em reais e em outras moedas.
Pegue sua chave
- Crie uma conta ou entre em brapi.dev/login.
- Copie sua chave no dashboard.
- Guarde a chave na variável de ambiente
BRAPI_API_KEY. - Envie a chave no header
Authorization: Bearer $BRAPI_API_KEY.
PETR4, MGLU3, VALE3 e ITUB4 respondem sem chave. Use esses tickers para testar. Veja Autenticação para limites e regras de segurança.
Primeira requisição
curl -H "Authorization: Bearer $BRAPI_API_KEY" \
"https://brapi.dev/api/v2/stocks/quote?symbols=PETR4"{
"results": [
{
"requestedSymbol": "PETR4",
"symbol": "PETR4",
"changed": false,
"data": {
"shortName": "PETROBRAS PN",
"currency": "BRL",
"regularMarketPrice": 41.18,
"regularMarketChange": -0.58,
"regularMarketChangePercent": -1.39,
"regularMarketVolume": 34024700,
"regularMarketTime": "2026-06-14T17:08:02.000Z"
}
}
],
"requestedAt": "2026-06-14T17:08:05.000Z",
"took": 245
}results traz um item por ticker pedido. Os dados ficam em results[].data.
Quando um ticker mudou de código, a brapi retorna o atual e marca
changed: true.
Erros comuns
| Status | Causa | O que fazer |
|---|---|---|
| 401 | Chave ausente ou inválida. | Copie a chave no dashboard. |
| 403 | Seu plano não inclui esses dados. | Veja os planos. |
| 429 | Cota do plano esgotada ou limite de requisições simultâneas atingido. | Espere os segundos do header Retry-After e tente de novo. |
Próximos passos
SDKs
Clientes oficiais para TypeScript e Python.
MCP e IA
Consulte a brapi no Claude, ChatGPT, Cursor e outros clientes.
Construir com IA
Use a brapi no Lovable, v0, Bolt.new, Replit, Codex, Cursor, Claude Code e agentes autônomos.
Autenticação e limites
Tokens, headers de rate limit e o que fazer em um 429.
Erros HTTP
Corrija respostas 400, 401, 403, 404, 429, 500 e 503.
Schema OpenAPI
Gere cliente e tipos a partir do documento OpenAPI 3.1.
Planos
Volume, frequência e histórico disponíveis em cada plano.
Dicionário
Significado, tipo e unidade de cada campo da API.