Tickers
Cobertura por Ticker
Endpoint público para verificar o que a brapi consegue consultar para cada ticker B3.
Use quando sua integração precisa decidir o próximo passo automaticamente: cotação, histórico, dividendos de ações, rendimentos de FIIs, indicadores de FIIs, relatórios ou endpoints de carteira e imóveis.
A resposta é por símbolo. Um ticker desconhecido não derruba a chamada inteira:
ele retorna status: "unknown" com recomendações de busca. Tickers antigos são
resolvidos antes da checagem e retornam status: "renamed" quando houver
mapeamento conhecido.
Este endpoint não retorna os dados de mercado em si. Ele informa quais endpoints usar.
Query Parameters
symbols*string
Tickers separados por vírgula, máximo 20
Response Body
application/json
application/json
application/json
curl -X GET "https://brapi.dev/api/v2/tickers/coverage?symbols=PETR4%2CMXRF11%2CVVAR3"{
"results": [
{
"requestedSymbol": "VVAR3",
"symbol": "BHIA3",
"changed": true,
"status": "renamed",
"assetType": "stock",
"subType": "stock",
"availableData": {
"ticker": true,
"quote": true,
"historical": true,
"stockDividends": true,
"fiiDividends": false,
"profile": true,
"statistics": true,
"financialStatements": true,
"fiiIndicators": false,
"fiiReports": false,
"fiiPortfolio": false,
"fiiProperties": false
},
"recommendedEndpoints": {
"ticker": "/api/v2/tickers?search=BHIA3",
"quote": "/api/v2/stocks/quote?symbols=BHIA3",
"historical": "/api/v2/stocks/historical?symbols=BHIA3&range=1y&interval=1d",
"dividends": "/api/v2/stocks/dividends?symbols=BHIA3"
}
}
],
"requestedAt": "2025-01-24T17:32:38.000Z",
"took": 45
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}