# Renomes de Tickers
URL: /docs/tickers/renomes.mdx

Consulte mudanças conhecidas de código de negociação na B3, incluindo ticker antigo, ticker atual canônico e data efetiva.

***

title: Renomes de Tickers
description: >-
Consulte mudanças conhecidas de código de negociação na B3, incluindo ticker
antigo, ticker atual canônico e data efetiva.
full: true
keywords: brapi, api, tickers, renomes, ticker antigo, b3
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/tickers/renames
------------------------------

Endpoint **público** para consultar renomes conhecidos de tickers B3.

Use quando um usuário informa um código antigo, quando você precisa exibir o
histórico de mudança de ticker, ou quando quer explicar por que uma busca por
um símbolo antigo deve apontar para outro ativo.

Filtros úteis:

* `symbols` filtra eventos envolvendo qualquer ticker informado.
* `search` busca em ticker antigo, novo ou canônico.
* `startDate` e `endDate` limitam pela data efetiva do renome, usando o formato
  `YYYY-MM-DD`.

Para normalizar uma lista antes de consultar dados, use
[`/api/v2/tickers/resolve`](/docs/tickers/resolver).





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/tickers/renames

Single endpoint documentation for /api/v2/tickers/renames

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/tickers/renames

**Summary:** 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

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


**Tags:** Tickers

### Parameters

- **symbols** (query)
- **search** (query)
- **startDate** (query)
- **endDate** (query)

### Responses

#### 200

Renomes retornados com sucesso.

#### 400

Requisição inválida

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### TickerRename

**Properties:**

- **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


### TickerRenamesResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **TickerRename**

- **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