v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Tickers

Listar renomes de tickers

Lista renomes conhecidos de tickers B3. Use este endpoint para descobrir quando um ticker antigo passou a negociar sob outro código, incluindo cadeias de renome normalizadas para o ticker canônico atual.

Exemplos

curl "https://brapi.dev/api/v2/tickers/renames?symbols=VVAR3"
curl "https://brapi.dev/api/v2/tickers/renames?search=BHIA"
curl "https://brapi.dev/api/v2/tickers/renames?startDate=2024-01-01"

Plano mínimo: Gratuito Autenticação: Não necessária

get/api/v2/tickers/renames

Query parameters

symbolsstring

Tickers separados por vírgula. Filtra renomes envolvendo qualquer ticker informado.

Example:VVAR3,BHIA3

searchstring

Busca textual em ticker antigo, novo ou canônico

Example:BHIA

startDatestring

Data inicial do evento no formato YYYY-MM-DD

Example:2024-01-01

endDatestring

Data final do evento no formato YYYY-MM-DD

Example:2026-12-31

Response

Renomes retornados com sucesso.

countnumber required

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "results": [
    {
      "oldSymbol": "VVAR3",
      "newSymbol": "BHIA3",
      "canonicalSymbol": "BHIA3",
      "effectiveDate": "2021-08-16"
    }
  ],
  "count": 2,
  "requestedAt": "2025-01-24T17:32:38.000Z",
  "took": 45
}