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

O endpoint legado /api/quote/{tickers} continua funcionando e não tem data de remoção. Ainda assim, integrações novas ficam melhores nos endpoints v2, onde descoberta de ticker, cotação, histórico, dividendos e fundamentos são chamadas separadas. Você pede só o dado que vai usar, e a resposta chega menor.

Fluxo recomendado

1. Use /api/v2/tickers para buscar, filtrar e validar símbolos.
2. Use /api/v2/tickers/resolve quando o usuário informar um ticker antigo.
3. Use /api/v2/tickers/renames para mostrar histórico de mudanças de código.
4. Use /api/v2/tickers/coverage para decidir qual endpoint consultar.
5. Chame o endpoint v2 específico para o dado que você precisa.

Mapeamento de endpoints

Rendimentos de FII continuam em /api/v2/fii/dividends. A fonte e o calendário são diferentes dos de ações, então /api/v2/stocks/dividends não serve para fundos imobiliários.

Diferenças na resposta

O envelope { results, requestedAt, took } continua igual. Muda o que vem dentro de results[].data.

Quando a brapi resolve um ticker antigo, o item traz requestedSymbol, symbol e changed. Use esses campos para avisar o usuário que o código mudou.

Mapeamento de módulos

Quando ficar no legado

Se a integração já roda e o contrato não pode mudar, fique em /api/quote/{tickers}. Ele não vai sumir sem aviso, e a política de versionamento descreve como um aviso desses chegaria.