Migração de /api/quote para /api/v2/stocks

O endpoint /api/quote/{tickers} continua ativo e não tem data de remoção. Nos endpoints v2, cada tipo de dado tem a sua chamada: tickers, cotação, histórico, proventos e demonstrações. Cada resposta traz só o dado pedido.

Ordem das chamadas

Use /api/v2/tickers para buscar e validar tickers.
Use /api/v2/tickers/resolve para trocar tickers antigos pelos atuais.
Use /api/v2/tickers/coverage para saber quais endpoints servem para cada ticker.
Chame o endpoint v2 do dado que você precisa.

Endpoints

Legado	V2
`/api/quote/list`	`/api/v2/tickers`
`/api/quote/PETR4`	`/api/v2/stocks/quote?symbols=PETR4`
`/api/quote/PETR4,VALE3`	`/api/v2/stocks/quote?symbols=PETR4,VALE3`
`/api/quote/PETR4?range=1y&interval=1d`	`/api/v2/stocks/historical?symbols=PETR4&range=1y&interval=1d`
`/api/quote/PETR4?startDate=2024-01-01&endDate=2024-12-31`	`/api/v2/stocks/historical?symbols=PETR4&startDate=2024-01-01&endDate=2024-12-31`
`/api/quote/PETR4?dividends=true`	`/api/v2/stocks/dividends?symbols=PETR4`

/api/v2/stocks/dividends não aceita FIIs. Para FIIs, use dividendos de FIIs.

Formato da resposta

A resposta v2 tem results, requestedAt e took. Cada item de results traz requestedSymbol, symbol, changed e data. Os dados ficam em data.

V2	Onde estão os dados
`/api/v2/stocks/quote`	`results[].data.regularMarketPrice`, `results[].data.regularMarketChangePercent`, `results[].data.marketCap`
`/api/v2/stocks/historical`	`results[].data.historicalDataPrice`
`/api/v2/stocks/dividends`	`results[].data.cashDividends`, `results[].data.stockDividends`, `results[].data.subscriptions`
`/api/v2/stocks/profile`	`results[].data`
`/api/v2/stocks/statistics`	`results[].data`
`/api/v2/stocks/financial-data`	`results[].data`
`/api/v2/stocks/balance-sheet`	`results[].data`
`/api/v2/stocks/income-statement`	`results[].data`
`/api/v2/stocks/cash-flow`	`results[].data`
`/api/v2/stocks/value-added`	`results[].data`

Um ticker antigo é trocado pelo ticker atual. Nesse caso, changed é true, requestedSymbol guarda o ticker enviado e symbol traz o atual.

Módulos

Módulo legado	V2
`summaryProfile`	`/api/v2/stocks/profile?symbols=PETR4`
`defaultKeyStatistics`	`/api/v2/stocks/statistics?symbols=PETR4&mode=current`
`defaultKeyStatisticsHistory`	`/api/v2/stocks/statistics?symbols=PETR4&mode=history&period=annual`
`defaultKeyStatisticsHistoryQuarterly`	`/api/v2/stocks/statistics?symbols=PETR4&mode=history&period=quarterly`
`financialData`	`/api/v2/stocks/financial-data?symbols=PETR4&mode=current`
`financialDataHistory`	`/api/v2/stocks/financial-data?symbols=PETR4&mode=history&period=annual`
`financialDataHistoryQuarterly`	`/api/v2/stocks/financial-data?symbols=PETR4&mode=history&period=quarterly`
`balanceSheetHistory`	`/api/v2/stocks/balance-sheet?symbols=PETR4&period=annual`
`balanceSheetHistoryQuarterly`	`/api/v2/stocks/balance-sheet?symbols=PETR4&period=quarterly`
`incomeStatementHistory`	`/api/v2/stocks/income-statement?symbols=PETR4&period=annual`
`incomeStatementHistoryQuarterly`	`/api/v2/stocks/income-statement?symbols=PETR4&period=quarterly`
`cashflowHistory`	`/api/v2/stocks/cash-flow?symbols=PETR4&period=annual`
`cashflowHistoryQuarterly`	`/api/v2/stocks/cash-flow?symbols=PETR4&period=quarterly`
`valueAddedHistory`	`/api/v2/stocks/value-added?symbols=PETR4&period=annual`
`valueAddedHistoryQuarterly`	`/api/v2/stocks/value-added?symbols=PETR4&period=quarterly`

Quando manter o legado

Se a sua integração já funciona e não pode mudar, mantenha /api/quote/{tickers}. A política de versionamento explica como a brapi avisa antes de remover um endpoint.