---
title: "Listar renomes de tickers"
method: GET
path: "/api/v2/tickers/renames"
tags: ["Tickers"]
---

# Listar renomes de tickers

`GET /api/v2/tickers/renames`

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

```bash
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

## Query parameters

- `symbols` string — Tickers separados por vírgula. Filtra renomes envolvendo qualquer ticker informado.
- `search` string — Busca textual em ticker antigo, novo ou canônico
- `startDate` string — Data inicial do evento no formato YYYY-MM-DD
- `endDate` string — Data final do evento no formato YYYY-MM-DD

## Response `200`

Renomes retornados com sucesso.

- TickerRenamesResponse
  - `results` TickerRename[], required
    - `oldSymbol` string, required — Ticker antigo
    - `newSymbol` string, required — Ticker novo divulgado no evento
    - `canonicalSymbol` string, required — Ticker canônico atual. Em cadeias de renome, aponta diretamente para o ticker final conhecido.
    - `effectiveDate` string, required — Data efetiva do renome no formato YYYY-MM-DD
  - `count` number, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — Requisição inválida
- `500` — Erro interno do servidor

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)