# Cobertura por Ticker
URL: /docs/tickers/cobertura.mdx

Descubra quais superfícies de dados da brapi estão disponíveis para cada ticker e quais endpoints usar em seguida.

***

title: Cobertura por Ticker
description: >-
Descubra quais superfícies de dados da brapi estão disponíveis para cada
ticker e quais endpoints usar em seguida.
full: true
keywords: brapi, api, tickers, cobertura, disponibilidade, endpoints
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/tickers/coverage
-------------------------------

Endpoint **público** para verificar o que a brapi consegue consultar para cada
ticker B3.

Use quando sua integração precisa decidir o próximo passo automaticamente:
cotação, histórico, dividendos de ações, rendimentos de FIIs, indicadores de
FIIs, relatórios ou endpoints de carteira e imóveis.

A resposta é por símbolo. Um ticker desconhecido não derruba a chamada inteira:
ele retorna `status: "unknown"` com recomendações de busca. Tickers antigos são
resolvidos antes da checagem e retornam `status: "renamed"` quando houver
mapeamento conhecido.

Este endpoint não retorna os dados de mercado em si. Ele informa quais endpoints
usar.

Envie os símbolos em lotes de até 20 tickers separados por vírgula. Ao verificar
uma lista maior, divida-a em lotes de 20 em vez de fazer uma requisição por
ticker.





## Swagger Documentation

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

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

## Base URLs

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

## GET /api/v2/tickers/coverage

**Summary:** Verificar cobertura por ticker


Verifica quais superfícies de dados da brapi estão disponíveis para cada ticker
informado e recomenda os endpoints corretos para continuar a integração.

Use este endpoint quando precisar responder "o que posso consultar para este
ativo?" antes de chamar cotações, histórico, dividendos, fundamentos ou
endpoints específicos de FIIs.

Envie até 20 tickers separados por vírgula em cada chamada. Para listas maiores,
divida a entrada em lotes de 20; não faça uma chamada individual por ticker.

### Exemplos

```bash
curl "https://brapi.dev/api/v2/tickers/coverage?symbols=PETR4,MXRF11"
curl "https://brapi.dev/api/v2/tickers/coverage?symbols=VVAR3"
```

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


**Tags:** Tickers

### Parameters

- **symbols** (query) *required*

### Responses

#### 200

Cobertura retornada 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)


### TickerAvailableData

**Properties:**

- **ticker** (boolean) *(required)*

- **quote** (boolean) *(required)*

- **historical** (boolean) *(required)*

- **stockDividends** (boolean) *(required)*

- **fiiDividends** (boolean) *(required)*

- **profile** (boolean) *(required)*

- **statistics** (boolean) *(required)*

- **financialStatements** (boolean) *(required)*

- **fiiIndicators** (boolean) *(required)*

- **fiiReports** (boolean) *(required)*

- **fiiPortfolio** (boolean) *(required)*

- **fiiProperties** (boolean) *(required)*


### TickerCoverageResponse

**Properties:**

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

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### TickerCoverageResult

**Properties:**

- **requestedSymbol** (string) *(required)*
  Ticker informado pelo usuário

- **symbol** (string) *(required)*
  Ticker canônico usado para consulta

- **changed** (boolean) *(required)*
  Indica se o ticker informado foi normalizado

- **status** (string) - Options: `available`, `renamed`, `unknown`, `wrong_endpoint` *(required)*
  Status da cobertura: disponível, renomeado, desconhecido ou endpoint incorreto para o tipo de símbolo

- **assetType** (string) *(nullable)* *(required)*
  Tipo amplo do ativo quando disponível

- **subType** (string) *(nullable)* *(required)*
  Subtipo do ativo quando disponível

- **availableData** *(required)*
  Reference to: **TickerAvailableData**

- **recommendedEndpoints** (object) *(required)*
  Endpoints brapi recomendados para o símbolo